Crash Reporting

Crash reporting is used to automatically monitor and report on traditional Red Hat clients that have experienced a crash.

Clients that have crash reporting enabled report any crashes to the Uyuni Server. This allows you to see what crashes have occurred, manage crash reports, and add custom notes to crashes from within the Uyuni Web UI. You can also run reports on crashes.

Crash reporting works only with traditional Red Hat clients. It does not work with Salt clients, or with traditional clients running any other operating system.

Crash reporting requires the spacewalk-abrt package installed on the client you want to monitor. To manage crash reports in the Web UI, navigate to Systems  Software Crashes.

Crash Notes

You can create custom notes for each crash report using the Uyuni Web UI. Navigate to Systems  Systems List and select the client that crashed. Navigate to the Software  Software Crashes tab to see a list of all current crashes for the selected client. Click the crash to see more information, and navigate to the Crash Notes tab to add or edit notes.

Organization Crash Configuration

You can manage crash reporting for your entire organization, turning the feature on or off, changing whether crash files are uploaded, and setting a size limit for file upload sizes. Navigate to Admin  Organizations and select the organization you want to manage. Navigate to the Configuration tab and change the settings as required. Click Update Organization to save the changes.

Reporting

Uyuni allows you to use the following crash-related reports with the spacewalk-report tool:

system-crash-count
system-crash-details

For more information about reports, see administration:reports.adoc.

Managing Crash Reports with the API

Use these API calls to manage reported software crashes:

system.crash.getLastReportDate()
system.crash.getUniqueCrashCount()
system.crash.getTotalCrashCount()
system.crash.listSystemCrashes()
system.crash.listSystemCrashFiles()
system.crash.deleteCrash()
system.crash.getCrashFileUrl()
system.crash.getCrashFile()

Use these API calls to manage notes on crashes:

system.crash.createCrashNote()
system.crash.deleteCrashNote()
system.crash.getCrashNotesForCrash()

Use these API calls to manage organization settings for crash reporting:

org.getCrashFileSizeLimit()
org.setCrashFileSizeLimit()
org.isCrashReportingEnabled()
org.setCrashReporting()
org.isCrashfileUploadEnabled()
org.setCrashfileUpload()

For more information about the API, see the latest API documentation available from https://documentation.suse.com/suma.