Chapter 5 Report Options

This chapter discusses the following topics:

• Report Options Overview

• Scheduling Reports

• Options for Viewing Report Output

• Accessing Reports From the Sun Management Center Web Server

• Line Graph Report Viewing Options

• Stopping Data Collection

Report Options Overview

Performance Reporting Manager includes several options that enable you to tailor the reporting capabilities to meet your specific needs. For example:

• You can schedule reports to automatically generate as needed.

• If you decide that you no longer need to monitor a particular host for a report, you can stop collecting data on that host.

• The report output can be saved in HTML for viewing in a web browser.

• Reports can be saved in comma-separated values (CSV) ASCII text form, in addition to using other delimeters of choice.

For more information about viewing reports in a web browser, see Options for Viewing Report Output.

Scheduling Reports

You can schedule any standard or custom report request to automatically generate at a regular interval, as long as the host names are saved in the report request. The output from all scheduled reports is posted to the Sun Management Center 3.0 server machine. The reports are saved in a directory on the server machine. You access these reports by typing in a browser: http://server-machine-name/reports.

The scheduling of reports and the server side generation of reports requires the use of an X server. You must first ensure that your environment is set correctly before scheduling reports.

To Schedule a Report

1. Verify that an X server session is running on the Sun Management Center 3.0 server machine.

   For the detailed steps, see To Set the Environment.

2. From the Report Manager File menu, choose Schedule, and then select Schedule Report Generation.

   The Schedule Report Generation dialog box opens.

3. Select the name of the desired report request from the hierarchy view contained in the left pane.

   The report requests are located at the third level in the hierarchy view.

4. Click the Add button.

   The name of the report request moves to the right pane.

5. (Optional) Select Multiple Report Requests if have more than one report to schedule for the same time.

   Select this option only if you want all the reports to run at the same time.

6. Complete the Date, Time and Repeat Interval fields.

   The date format is specific to the locale. Provide the date as specified in the date label. Make your selections for the Time and Repeat Interval fields from the drop-down menu.

7. Click OK to schedule the report.

   The report is now scheduled to generate according to your selections. The report will continue to generate at the interval specified, until the request is deleted.

To Remove a Scheduled Report

1. From the Report Manager File menu, choose Schedule, and then select View Scheduled Report Status.

   A new window opens with a table containing a status of all currently scheduled reports. You can resize the table columns by dragging the cell border of the header title.

2. Select the row that contains the name of the report to be removed.

3. Click Remove.

   The report is removed from the table.

4. Click OK.

   The report is no longer scheduled to be generated

Options for Viewing Report Output

After a report is generated, you have several options for viewing and saving the output. These options include the following outputs:

• View a report as an HTML file in a browser

• Post any saved reports as HTML files to a Sun Management Center server for others to view

• Save the report in a tab-separated or comma-separated value (CSV) ASCII text file that can be used with other tools to analyze the data

Reports saved as an HTML file can be viewed using Netscape Navigator^TM 4.5.1, or higher, or Internet Explorer 5.0, or higher.

To View a Report as HTML in a Browser

1. Generate the desired report.

   The report output is shown in a separate window. For the detailed steps, see To Generate a Standard Report.

2. Choose Show in Web Browser from the File menu in the report window.

   The web browser launches and the report is displayed as HTML.

To Post to a Sun Management Center Web Server

1. Generate the desired report request.

   The report output is shown in a separate window. For the detailed steps, see To Generate a Standard Report.

2. Choose Post to a Web Server from the File menu in the report window.

   The report is posted to the Sun Management Center 3.0 server you to which are connected , which acts as a web server.

To Export Data

1. Generate the desired report.

   The report output is shown in a separate window. For the detailed steps, see To Generate a Standard Report.

2. Choose Export Data from the File menu in the report window.

   The Export Data dialog box appears.

3. Select either Comma or Tab as the delimiter.

4. Choose the directory in which to save the file.

5. Type a name in the File Name text field.

6. Select the File Type from the drop-down menu.

7. Click Save.

Accessing Reports From the Sun Management Center Web Server

Once a report has been saved and posted to a Sun Management Center 3.0 web server, you can view the report as HTML in a browser. All scheduled reports are posted to the Sun Management Center 3.0 server machine. You can also post an individual report by using the Post to a Web Server option from the report's menu. A list of all reports ever posted appears in the browser window that is opened from the server. All reports will continue to appear until the report is deleted.

To Access a Posted Report

1. Launch the Sun Management Center 3.0 web server by typing in a browser:

   http://server-machine-name/reports

2. Login by typing the Login and Password in the text fields.

   Use the same Login name and Password that are required for the Sun Management Center 3.0 server.

   A table is displayed in the browser window that lists all the reports that have been posted to the web server. The name of the Report Request, the report Category and Subcategory, the Report Title, and the Create Time are displayed in the table.

3. To view a report, click on the name contained in the Report Title field.

   The report is displayed in the browser window.

4. (Optional) To print the report, use the Print option from the browser's menu.

5. Close the browser from the browser's menu.

To Delete a Posted Report

1. Log in to the Sun Management Center 3.0 web server.

   For the detailed steps, see steps 1 and 2 in To Access a Posted Report.

2. Located the name of the report in the table, then click the corresponding Delete button.

   A second dialog box appears that asks you to confirm the deletion request.

3. Click OK to confirm the deletion request.

   The report is deleted from the list in the table, and is removed from the web server.

The figure below shows a sample of the list of posted reports as it appears in a browser window.

Figure 5–1 Sample of a Browser Window With a List of Reports That Are Posted to a Web Server

Line Graph Report Viewing Options

If your report is in Line Graph format, you have several options for viewing the data. At the top of the report window are several buttons used for accessing the options. First, click the desired point on a graph, then click one of the following buttons:

• Disabled: Deactivates the mouse so a click on any line in the graph will not register.

• Zoom: Enlarges, or zooms, the area selected on any line. Either click the desired point, or draw a lasso around a series of points for which you want more detail. The area selected will appear in enlarged detail.

• Alarms: A second window appears that contains a tabular report providing alarm details for the date range specified in the report request.

• Processes: A second window appears that contains two tabular reports providing detail about processes. One report is titled the Top 10 CPU Processes, and the other is titled Top 10 Memory Processes. The report information is for the time represented by the data point nearest to the point selected on the line. Process data is logged every 15 minutes and is only available for the last 8 days.

• Reset Zoom: Resets the graph orientation back to the initial starting point.

Customizing Line Graph Reports

Once you have run a report in line graph format, you can further customize the appearance of the report. From the Edit menu, choose Customize Graph. The options are the same as when completing a new custom report template. The difference is that the customizing options you select after running a report apply only to that report. You cannot save the changes, but you can post the customized report to a Sun Management Center web server for viewing or printing.

For more detail about the Customize Graph options, see Customizing the Appearance of Reports.

Stopping Data Collection

You can stop data collection on any agent machine that you no longer need to include in reports.

To Stop Data Collection

1. From the Report Manager File menu, choose Data, and then select Data Collection.

   The Data Collection dialog box opens. All hosts for which data is not currently being collected are listed in the left pane. All hosts for which data is currently being collected are listed in the right pane.

2. Select the name of the host.

3. Use the Add, Add All, Remove, and Remove All buttons to move the host names as needed.

   You must change the status of collection on the hosts one at a time.

4. Click OK to save the changes.