tripleo-docs/deploy-guide/source/troubleshooting/troubleshooting-log-and-status-capture.rst

Performing Log and Status Capture

The tripleoclient provides commands to allow operators to run sosreport on the overcloud nodes and download the log and status log bundles with tripleoclient. This can aide with troubleshooting problems as the results can be sent to an external support for analysis. The openstack overcloud support report collect command can be used to execute sosreport on select (or all) overcloud nodes, upload the logs to swift running on the undercloud, and download the logs to the host that the command is executed from.

Example: Download logs from all controllers

The required server_name option for the command can be a partial name match for the overcloud nodes. This means openstack overcloud support report collect controller will match all the overcloud nodes that contain the word controller. To download the run the command and download them to a local directory, run the following command:

$ openstack overcloud support report collect controller

Note

By default if -o is not specified, the logs will be downloaded to a folder in the current working directory called support_logs

Example: Download logs from a single host

To download logs from a specific host, you must specify the complete name as reported by openstack service list from the undercloud:

$ openstack overcloud support report collect -o /home/stack/logs overcloud-novacompute-0

Example: Leave logs in a swift container

If you want to perform a sosreport but do not currently wish to download the logs, you can leave them in a swift container for later retrieval. The --collect-only and -c options can be leveraged to store the logs in a swift container. For example:

$ openstack overcloud support report collect -c logs_20170601 --collect-only controller

This will run sosreport on the nodes and upload the logs to a container named logs_20170601 on the undercloud. From which standard swift tooling can be used to download the logs. Alternatively, you can then fetch the logs using the openstack overcloud support report collect command by running:

$ openstack overcloud support report collect -c logs_20170601 --download-only -o /tmp/mylogs controller

Note

There is a --skip-container-delete option that can be used if you want to leave the logs in swift but still download them. This option is ignored if --collect-only or --download-only options are provided.

Additional Options

The openstack overcloud support report collect command has additional that can be passed to work with the log bundles. Run the command with --help to see additional options:

$ openstack overcloud support report collect --help