Chapter 5. Debugging issues
Central saves information to its container logs.
5.1. Prerequisites
You have configured the
ROX_ENDPOINT
environment variable using the following command:export ROX_ENDPOINT=<host:port>
$ export ROX_ENDPOINT=<host:port>
1 Copy to Clipboard Copied! - 1
- The host and port information that you want to store in the
ROX_ENDPOINT
environment variable.
5.2. Viewing the logs
Kubernetes
Procedure
Run the following command to view the logs for the Central pod:
kubectl logs -n stackrox <central_pod>
$ kubectl logs -n stackrox <central_pod>
Copy to Clipboard Copied!
OpenShift Container Platform
Procedure
Run the following command to view the logs for the Central pod:
oc logs -n stackrox <central_pod>
$ oc logs -n stackrox <central_pod>
Copy to Clipboard Copied!
5.3. Viewing the current log level
You can change the log level to see more or less information in Central logs.
Procedure
Run the following command to view the current log level:
roxctl central debug log
$ roxctl central debug log
Copy to Clipboard Copied!
5.4. Changing the log level
Procedure
Run the following command to change the log level:
roxctl central debug log --level=<log_level>
$ roxctl central debug log --level=<log_level>
1 Copy to Clipboard Copied! - 1
- The acceptable values for
<log_level>
arePanic
,Fatal
,Error
,Warn
,Info
, andDebug
.
5.5. Retrieving debugging information
Procedure
Run the following command to gather the debugging information for investigating issues:
roxctl central debug dump
$ roxctl central debug dump
Copy to Clipboard Copied! - To generate a diagnostic bundle with the RHACS administrator password or API token and central address, follow the procedure in Generating a diagnostic bundle by using the roxctl CLI.