This chapter discusses the following topics:
Performance Reporting Manager includes 12 standard reports with predefined options that you cannot edit. A standard report has predefined report options that generate a report that is generally useful to anyone monitoring a system. The report output format is also predefined and cannot be changed.
Standard reports are organized by category and subcategory in the left pane of the Report Manager GUI. Standard report requests are identified by the lock symbol that appears on the report request icon. The lock reminds you that you cannot change the predefined report options.
All standard reports generated by Performance Reporting Manager are classified as being either a performance report or a system configuration report. A performance report is designed to track properties that are numerical and change over time. An example of a performance report is a graph that shows the percentage of CPU kernel usage on a host over the last 24 hours. For more information about standard performance reports, see Standard Performance Reports.
A standard system configuration report is designed to provide data detailing the state of the configuration on that machine. An example of a system configuration report is a table that summarizes all the patches currently installed on a particular machine or machines. For more information about standard system configuration reports, see Standard System Configuration Reports.
Once generated, the output from all standard reports can be viewed in the Sun Management Center 3.0 console, or in a web browser as an HTML file, or in a comma-separated value (CSV) ASCII text file. The text file can be used with other tools to analyze the data. See Options for Viewing Report Output for more information.
You must have the Kernel Reader Simple module loaded before you can run any standard report. For a detailed list of properties that each standard report incorporates, see Standard Performance Reports, Standard System Configuration Reports, or Appendix A, Reference.
Performance data logging on agent machines is provided by the history logging capability included with Sun Management Center 3.0. Performance Reporting Manager only collects the data logged in the circular history.log file. The data then is transferred to the Sun Management Center 3.0 server machine and loaded into the database. Report data is obtained by making queries to the database to determine trends in the performance statistics over a specified time period.
The report options are predefined in the report request. The report output format for all standard performance reports is a graph. The following three standard performance reports are included with Performance Reporting Manager. They are organized by their category and subcategory names:
System configuration data is logged on the agent machines by the Performance Reporting Manager logging component. This logging component is added to the agent machine during installation. The data is then transferred to the Sun Management Center 3.0 server machine and loaded into the database. Report data is obtained by making queries to the database located on the Sun Management Center 3.0 server machine. This method is similar to the way the data for standard performance reports is obtained.
The report options are predefined in the report request. The report output format for all standard system configuration reports is a table. The following nine standard system configuration reports are included with Performance Reporting Manager. They are organized by their category and subcategory names:
Alarm
Alarms
Alarm Details: This report lists the all open alarms for each host. The report data includes host name, operating system, alarm severity, alarm status, open date, and alarm message. The host name and port is entered when the report is run.
Alarm Summary: This report lists the alarm status and alarm count for each host. The report data includes the host name and alarm status. The report provides detail for all hosts in the server context.
Alarm Severity Count By Host: This report lists the alarm severity count for each host. The report data includes the host name, alarm severity, and alarm status. The report provides detail for all hosts in the server context.
Hardware
System
System Details: This report lists the system details, for each host name, of all hosts in the server context that have both the Config-Reader add-on and Performance Reporting Manager installed. The report data includes the host name, operating system, system clock frequency, platform type, total disks, total memory, total processors, and total tape devices.
Platform Summary: This report lists the platform type, for each host, for all hosts in the server context that have the Config-Reader add-on and Performance Reporting Manager installed. The report data includes platform.
OS Summary: This report lists the operating system, for each host, for all hosts in the server context that have the Config-Reader add-on and Performance Reporting Manager installed. The report data includes the operating system.
Configuration
Software
Packages
Hosts with SUNWcsr package: This report lists, for each host, those that have the SUNWcsr package installed. The report data includes the host name, package instance, package name, category, version, package description, and install date. The report provides detail for all hosts in the server context.
Package Details: This report lists, for each host, all the software packages installed on that host. The report data includes the host name, package instance, package name, category, version, package description, and install date. The host name and port is entered when the report is run.
Patches
You can resize the columns in any tabular report by dragging the sides of the column header. Additionally, you can sort any tabular report by double-clicking the column headers. The report then sorts according to the header selected.
You manage all report activity through the Report Manager GUI. For example, from Report Manager you can generate a report from a report request, or create a new custom report request, or schedule a report to generate at regular intervals. The Report Manager GUI is linked to the Sun Management Center 3.0 JavaTM console only. The GUI is opened from the Tools menu.
Report Manager displays information in two panes. The left pane contains the hierarchy view of the report requests. The report requests are organized by category and subcategory. For more information about categories and subcategories, see Categories and Subcategories.
The right pane in Report Manager contains three summary fields. These summaries help you to quickly identify the important distinguishing characteristics of each report request. After selecting a request name from the hierarchy view in the left pane, the following information is displayed in the right pane:
Report Request: The name and description of the report request
Data Properties: The list of data properties selected for the report request
Hosts: The host names included in the report
Start the Sun Management Center 3.0 console.
Choose Report Manager from the Tools menu.
The Report Manager GUI appears. The hierarchy view is in the left pane, and the report request summary is in the right pane.
Click the key symbol next to a category name to expand the hierarchy view.
The hierarchy view expands one level to display the subcategory name. The report requests are identified by the report request name, and are located under the subcategory name.
The following figure shows a sample of what the Report Manager GUI contains when a standard performance report is selected from the hierarchy view. The left pane shows that the CPU Utilization report request is selected in the hierarchy view. The right pane displays a summary of some of the report options for the CPU Utilization report request. The detail fields include Report Request, Data Properties, and Hosts. The detail for each field provides a summary of the options that are predefined in the report request.
You can generate a standard report in one of three ways:
By choosing Generate from the File menu in Report Manager.
By double-clicking the name of the report request from the left pane in Report Manager.
By clicking the Generate icon in the menu. This is the first icon located under the menu options.
Each time you generate a standard performance report, you must provide the host name and corresponding port if this information is not predefined. The host name, if entered when you generate the report, is not saved to the report request. You can specify a different host name each time you generate a standard performance report.
For standard system configuration reports, a report is generated for all hosts identified in the Sun Management Center 3.0 server context that also have the Performance Reporting Manager software installed.
For more information about standard performance and system configuration report requests, see Standard Reports Overview.
Any report, whether it is a standard or a custom report, is generated this way. For information about scheduling reports to run at regular intervals, see Scheduling Reports.
You must have the Kernel Reader Simple module loaded in order to run any standard report.
Start Report Manager.
Select the name of the desired report request from the hierarchy view.
Verify that this report request is correct by reviewing the summary information contained in the right pane.
Choose Generate from the File menu.
The standard report is generated. A second window opens that contains the report output.
If a dialog box appears, type the host name and corresponding port.