Viewing a System Diagnostics report
The System Diagnostics report enables an administrator to retrieve diagnostics like memory usage, operating system information, configuration file settings, system parameters, component counts, and thread stack traces. BMC can request this report when servicing a technical support call.
To generate a System Diagnostics report
- Open the System Diagnostics Report wizard page by navigating to Reports > Support Reports > System Diagnostics.
Select the types of diagnostics to include in the report. Best practice when generating a report to forward to BMC Customer Support is to check all "Show" options so that the resulting report contains as much information as possible.
Field
Description
Annotation
(Optional) Enter notes or a description to help you identify this report when it appears in a list among other reports.
When Complete, Notify Via Email
(Optional) Click to request that the system send you a notification email when the report is complete and ready for you to view.
JVM Diagnostics: Show Memory Usage
(Optional) Click to request that the report include information about the server's memory usage, to help troubleshoot sluggish performance.
JVM Diagnostics: Show Java Thread Dump
(Optional) Click to request that the report include a thread dump of what is running in the server, to help troubleshoot sluggish performance or general unresponsiveness. A thread dump includes device names if any device actions are active.
Application Diagnostics: Show Operating System Information
(Optional) Click to request that the report include information about the server's host operating system, which helps the BMC customer support team understand your environment better.
Application Diagnostics: Show Configuration Files
(Optional) Click to request that the report include information about how you have customized various configuration files and device adapters, which helps the BMC technical support team understand your environment better.
Application Diagnostics: Show System Parameters
(Optional) Click to request that the report include information about the TrueSight Network Automation software and its database, which helps the BMC customer support team understand your environment better.
Application Diagnostics: Show Component Counts
(Optional) Click to request that the report include information about how many components (devices, rules, users, and the like) are present in your system, to help troubleshoot sluggish performance.
Remote Device Agent Diagnostics: remote device agent name
(Optional) Click to request that the report include information about the selected remote device agent, to help troubleshoot issues with the device agent performance. The information includes memory usage, operating system information, configuration files, similar to the information gathered for the server when you enable the above options.
Remote Device Agent Diagnostics: Show Remote Device Agent Java Thread Dump(s)
(Optional) Click to request that the report include a thread dump for what is running in the remote device agent, to help troubleshoot sluggish performance. Applies only if you have selected one or more remote device agents. A thread dump includes device names if any device actions are active.
- Click Generate to begin the report generation and to display its progress on the Report Activity page.
- Click Refresh until the report is completed, or wait until you receive the notification email. If the report is aborted, the Progress column indicates so, to alert you that the report data is partial. You can view the partial report, but be aware it is partial. You should refine your selections (if you asked for too-large a report) or re-generate the report (if it was aborted due to a system shutdown) in order to obtain a complete report. Then delete the aborted report as soon as possible. For more information about the Report Activity page, see Viewing-report-activity.
Click the System Diagnostics link in the Report column to display the report.
Verify the report is complete. If the report was aborted, the title and the Report Generation information in the footer inform you so, and the footer informs you about the user who aborted it. An aborted report will be missing one or more sections for the selected remote device agents.You might notice red or yellow flags next to various utilization values. A yellow flag appears at 85% utilization; a red flag appears at 95% utilization. The presence of a flag indicates that your system is approaching a limit that could impact the performance or proper functioning of the system. High memory or CPU utilization might be transitory, so generate the report again at intervals to monitor if the usage goes back down. High disk utilization is not usually transitory. Monitor this parameter as well and perform the disk cleanup actions at the operating system level.
(Optional) Perform one of the following tasks by using the menu options that are available on the System Diagnostics Report page:
Menu option
Description
Refine
Return to the wizard to change report parameters and generate a new version of the report.
Export
Export the report to one of the following formats:
- HTML
- RTF
Email
Email the report to one or more recipients in one of the export formats.
Back
Return to the Report Activity page.