Run Health Reports

Contents
casp1032
 
 
Health Reports
You can use the Performance View Health Report feature to measure and report on the health of your 
SpectroSERVER
 and the system where it is installed. Report options let you select any time period, from 6 to 24 hours.
Start the reporting process at any time, either from the main Performance View window or from the command line. The command line option also lets you take advantage of native scheduling service on your host system to run the report automatically at regular intervals.
By default, Health Report collects the following data at 10-second intervals for a 24-hour period:
  • CPU, disk, and memory usage data
  • network I/O and trap data
  • poll, log, timer, and notification latency data
We recommend selecting the full 24-hour time period. This interval collects data from a typical day. Or, if data that represents your typical workload is collected during a shorter period of time, select that time period. However, be careful not to exclude data collection for jobs that run during non-business hours, such as backups that are executed late at night.
Once data collection has occurred for a full 24-hour period, a health report is generated automatically. If you ran the report from the Health Report tab, the report is displayed there. You can save it to a location of your choice. If you ran the report from the command line, the report is written to a file.
 
Note
: Use the Preferences dialog to configure Performance View to automatically send health reports to a list of email addresses.
 SPEC--pview_tabhealthreport_scr 
The relative health of each system resource for example, CPU usage is determined by analyzing the Average, Peak, and % Over Critical Value readings collected. Any values that exceed predefined thresholds are flagged (displayed in red) to indicate a potential performance problem.
The relative health of the 
SpectroSERVER
 is determined by applying performance algorithms to the collected data. If it is determined that performance has degraded, the likely causes and recommendations for improving performance are also provided in the report.
Start Data Collection
To enable health reports, you must start data collection for the Health Report feature.
 
Follow these steps:
 
  1. Click the Health Report tab.
  2. Click Start in the Data Collection section.
    The message area in the panel indicates the number of hours and minutes remaining in the default 24-hour reporting period. After all of the data has been collected, Health Report analyzes the data and displays a health report to the right of the Data Collection panel.
    As long as the new report remains on display, the average percentage of 
    SpectroSERVER
     capacity that is used during the reporting period is also shown in the graph in the System Capacity panel.
Stop Data Collection
Data collection for a Health Report stops automatically after data has been collected for 24 hours. However, you can stop or pause data collection manually at any time.
 
Follow these steps:
 
  1. Click the Health Report tab.
  2. Click Stop in the Data Collection section.
  3. (Optional) Select 
    one 
    of the following options if you started the data collection less than 24 hours ago:
    •  
      Resume Data Collection
      Restarts data collection. For example, if you stopped data collection after one hour, select this option to restart data collection and continue it for 23 more hours (until the default reporting period of 24 hours has been reached). In other words, the total time of data collection does not have to be contiguous. You can start and stop data collection for the same report as many times as you want. However, to generate a report, you must collect data for at least six hours.
    •  
      Stop and Analyze Data
      Immediately generates a health report from the collected data. This option appears if data has been collected for at least 6 hours. The report remains displayed until you start data collection for a new report or exit Performance View.
      You cannot resume data collection for the same report once you have clicked this button.
    •  
      Stop and Delete Data
      Ends the data collection process and deletes all collected data. No report is generated.
Save Health Reports
You can save the current health report to preserve the data.
 
Follow these steps:
 
  1. Click the save the current health report icon SPEC--savehealthrpt_ico.
    The Choose Directory and Filename for HTML Report dialog opens.
    When specifying a filename for the report, do not include the .htm file extension. It is added automatically.
  2. Navigate to the folder in which to save the report, enter a filename, and click Save.
    The health report is saved.
Open Health Reports
Open health reports to view or print them.
 
Follow these steps:
 
  1. Click the Open a previously saved health report SPEC--openhealthrpt_ico.
    The Choose Report File to Open dialog opens.
  2. Navigate to the report, select it, and click Open.
    The report is displayed in a separate, read-only window.
Print Health Reports
You can print the health report that is currently displayed on the Health Report tab.
 
Follow these steps:
 
  1. Click the print the health report SPEC--printhealthrpt_ico.
    The Print dialog opens.
  2. Select settings in the Print dialog, and click OK.
    The health report prints.
You can also print a health report that you have saved.
 
Follow these steps:
 
  1.  Open the report.
    The 
    SpectroSERVER
     Capacity Report dialog opens, displaying the selected report.
  2. Click Print.
    The Print dialog opens.
  3. Select settings, and click OK.
    The health report prints.
  4. Click Close.
    The 
    SpectroSERVER
     Capacity Report dialog closes.
Run Health Reports from the Command Line
You can start data collection for a health report at any time by entering the desired parameters from the command line. Or you can use your native scheduling service to execute the command at a specified time or at regular intervals.
The command line executable is named pviewrep and is located in the 
<$SPECROOT>
\PView directory.
The syntax for the pviewrep command is as follows:
pviewrep vnm -c collectTime -e addrList
  •  
    vnm
    Specifies the name of the 
    SpectroSERVER
     for which to run a report.
  •  
    -c 
    collectTime
     
    Specifies the number of hours for which to collect data.
    The minimum time period for a report is six hours. If you specify fewer than six hours, the report still collects six hours of data before it is generated.
  •  
    -e 
    addrList
     
    Specifies a comma-separated list of email addresses to which to send the completed report. To specify multiple addresses on Windows systems, enclose the list in quotation marks, for example, “address1,address2,address3”.
    In a Windows environment, you must have the Windows Messaging Subsystem or Messaging Application Programming Interface (MAPI) subsystem installed to be able to send messages using the -e option. If the subsystem is not installed, the executable fails to send the email notification. It looks for a registry entry under HKEY_CURRENT_USER\\Software\\Microsoft\\Windows NT\\CurrentVersion\\Windows Messaging Subsystem\\Profiles and creates an application event if the entry cannot be found. The local email system can require confirmation steps before sending the email.
Reports that pviewrep generates are saved automatically with the name of the 
SpectroSERVER
 host. These files have an .htm extension. Sequential numbers are added to keep subsequent reports from overwriting existing ones. For example, the first report that is generated for a server named “ace” is ace.htm. The second report is ace_1.htm.
By default, reports that are generated with pviewrep are saved to the directory that was used for the most recent health report from the Performance View main window. If that directory is not available, the report is saved to the current working directory. If the file cannot be written to the current working directory, it is written to the standard output stream for the program.
Health reports that are distributed automatically by email are in plain text format, not HTML.