Generate Diagnostic Reports

Using the Diagnostics reports page in the web console, Cockpit administrators can collect configuration and diagnostic information from a host system to help with diagnosing system related problems.

What Do You Need?

The Cockpit web console must be installed and accessible.
For details, see these topics: Install and Enable Cockpit and Log in to the Cockpit Web Console.
The cockpit-sosreport package is installed. Typically, this package is installed by default.
For package installation details, see Install and Manage Add-on Applications.
Administrator privileges.

Steps

Using the Cockpit web console, follow these steps to generate diagnostic reports about the hardware and setup of the managed host system.

In the Cockpit navigation pane, click Diagnostic reports.
The Systems diagnostics page appears.
In the System diagnostics page, click Run report.
The Run new report dialog box appears.

In the Run new report dialog box, enter the following information and click Run report.

Report label	In the Report label field, enter a name for this report. For example, you might provide your first initial and last name; or, if this report is being generated for a specific support case, you could enter the support case ID number.
Encryption passphrase (Optional)	If you need to secure the contents of the report, you can enter an encryption passphrase in the Encryption passphrase field. This level of security is helpful to use when transferring a report over a public network to a third party. WARNING: Ensure that enough disk space is available when creating an encrypted report, as this process temporarily uses double the disk space.
Options	Optionally, select any of the following checkboxes: Obfuscate network addresses, hostnames, and usernames – Intentionally render this information unclear and harder to understand. Use verbose logging – Gather more logging information than the normal logging mode.

Upon clicking Run report in the Run new report dialog box, a progress label appears. This progress label indicates the completion percentage for rendering a completed report.

Important:

If the system has a lot of packages installed, the report collection process might take a longer time to complete. To stop the report from generating, click Stop report.

Upon rendering a completed report, the Run new report dialog box automatically closes, and the name of the newly generated report appears on the System diagnostics page.

Note:

By default, the Cockpit generated report data is saved to a tar file format in the /var/tmp directory.