Chapter 5. Debugging issues
Central saves information to its container logs.
5.1. Prerequisites Copy linkLink copied to clipboard!
You have configured the
ROX_ENDPOINTenvironment 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_ENDPOINTenvironment variable.
5.2. Viewing the logs Copy linkLink copied to clipboard!
Kubernetes
Procedure
Run the following command to view the logs for the Central pod:
$ kubectl logs -n stackrox <central_pod>
OpenShift Container Platform
Procedure
Run the following command to view the logs for the Central pod:
$ oc logs -n stackrox <central_pod>
5.3. Viewing the current log level Copy linkLink copied to clipboard!
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
5.4. Changing the log level Copy linkLink copied to clipboard!
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.
5.5. Retrieving debugging information Copy linkLink copied to clipboard!
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.