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> 1
- 1
- The host and port information that you want to store in the
ROX_ENDPOINT
environment variable.
5.2. Viewing the logs
You can use either the oc
or kubectl
command to view the logs for the Central pod.
Procedure
To view the logs for the Central pod by using
kubectl
, run the following command :$ kubectl logs -n stackrox <central_pod>
To view the logs for the Central pod by using
oc
, run the following command :$ oc logs -n stackrox <central_pod>
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
Additional resources
5.4. Changing the log level
Procedure
Run the following command to change the log level:
$ roxctl central debug log --level=<log_level> 1
- 1
- The acceptable values for
<log_level>
arePanic
,Fatal
,Error
,Warn
,Info
, andDebug
.
Additional resources
5.5. Retrieving debugging information
Procedure
Run the following command to gather the debugging information for investigating issues:
$ roxctl central debug dump
- 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.
Additional resources