Cisco Unified Serviceability Administration Guide Release 9.0(1)
Serviceability Reporter archive
Downloads: This chapterpdf (PDF - 436.0KB) The complete bookPDF (PDF - 1.96MB) | Feedback

Serviceability Reporter archive

The Cisco Serviceability Reporter service generates daily reports in Cisco Unified Serviceability. Each report provides a summary that comprises different charts that display the statistics for that particular report. Reporter generates reports once a day on the basis of logged information.


Note


Because the Cisco Serviceability Reporter is only active on the primary Cisco Unified CCX server, at any time, Reporter generates reports only on the primary node and not the secondary node.


You can view reports from Cisco Unified Serviceability > Tools > Serviceability Reports Archive. You must activate the Cisco Serviceability Reporter service before you can view reports. After you activate the service, report generation may take up to 24 hours.

The reports contain 24-hour data for the previous day. A suffix that is added to the report names shows the date for which Reporter generated them; for example, AlertRep_mm_dd_yyyy.pdf. The Serviceability Reports Archive window uses this date to display the reports for the relevant date only. The reports generate from the data that is present in the log files, with the timestamp for the previous day. The system considers log files for the current date and the previous two days for collecting data. In a Cisco Unified CCX cluster, this takes into account the time zone differences between the server locations.

The time that is shown in the report reflects the server "System Time." In a Unified CCX cluster configuration, the time that is shown in the report reflects the first server "System Time." If the first server and subsequent server(s) are in different time zones, the first server "System Time" shows in the report.


Note


You can pick up log files from the server while you are generating reports, or in a cluster configuration from both the nodes in the cluster.


The following sections provide additional information, including detailed information about each report that Serviceability Reporter generates:

Serviceability Reporter parameters

Cisco Serviceability Reporter uses the following service parameters:

  • RTMT Reporter Designated Node—Specifies the designated node on which RTMT Reporter runs. This default equals the IP address of the server on which the Cisco Serviceability Reporter service is first activated. Because the Serviceability Reporter service is CPU intensive, Cisco recommends that you specify a non-call processing node.
  • Report Generation Time—Specifies the number of minutes after midnight. Reports generate at this time for the most recent day. The minimum value equals 0 and the maximum value equals 1439.
  • Report Deletion Age—Specifies the number of days that the report must be kept on the disk. The system deletes reports that are older than the specified age. The minimum value equals 0, and the maximum value equals 30.

Tip


You can disable reports by setting the service parameter Report Deletion Age to a value of 0.


For more information about service parameter configuration, refer to Cisco Unified CCX Serviceability Administration Guide.

Configure serviceability report

The Cisco Serviceability Reporter service generates daily reports in Cisco Unified Serviceability. Each report provides a summary that comprises different charts that display the statistics for that particular report. Reporter generates reports once a day on the basis of logged information.

This section describes how to use the Serviceability Reports Archive window.

Before You Begin

Activate the Cisco Serviceability Reporter service, which is CPU intensive. After you activate the service, report generation may take up to 24 hours.

Procedure
    Step 1   Choose Tools > Serviceability Reports Archive.

    The Serviceability Reports Archive window displays the month and year for which the reports are available.

    Step 2   From the Month-Year pane, choose the month and year for which you want to display reports.

    A list of days that correspond to the month displays.

    Step 3   To view reports, click the link that corresponds to the day for which reports were generated.

    The report files for the day that you chose display.

    Step 4   To view a particular PDF report, click the link of the report that you want to view.
    Tip   

    If you browsed into Cisco Unified Serviceability by using the server name, you must log in to Cisco Unified Serviceability before you can view the report.

    Tip   

    If your network uses Network Address Translation (NAT) and you are trying to access serviceability reports inside the NAT, enter the IP address for the private network that is associated with the NAT in the browser URL. If you are trying to access the reports outside the NAT, enter the public IP address, and NAT will accordingly translate/map to the private IP address.

    Tip   

    To view PDF reports, you must install Acrobat Reader on your machine. To download Acrobat Reader, click the link at the bottom of the Serviceability Reports Archive window.

    A window opens and displays the PDF file of the report that you choose.


    Related References

    Server statistics report

    Percentage of CPU per server

    A line chart displays the percentage of CPU usage for the server (or for each server in a Cisco Unified CCX cluster). The line in the chart represents the data for the server (or one line for each server in a Cisco Unified CCX cluster) for which data is available. Each data value in the chart represents the average CPU usage for a 15-minute duration. If no data exists for the server (or for any one server in a Cisco Unified CCX cluster), Reporter does not generate the line that represents that server. If there are no lines to generate, Reporter does not create the chart. The message "No data for Server Statistics report available" displays.

    Serviceability report archive configuration checklist shows a line chart example that represents the percentage of CPU usage per server in a Cisco Unified CCX cluster configuration.

    Figure 1. Line chart that depicts percentage of CPU per server

    Percentage of memory usage per server

    A line chart displays the percentage of Memory Usage for the Cisco Unified CCX server (%MemoryInUse). In a Cisco Unified CCX cluster configuration, there is one line per server in the cluster for which data is available. Each data value in the chart represents the average memory usage for a 15-minute duration. If no data exists, Reporter does not generate the chart. If no data exists for any server in a Cisco Unified CCX cluster configuration, Reporter does not generate the line that represents that server.

    Serviceability report archive configuration checklist shows a line chart example that represents the percentage of memory usage per Cisco Unified CCX server in a Cisco Unified CCX cluster configuration.

    Figure 2. Line chart that depicts percentage of memory usage per server

    Percentage of hard disk usage of the largest partition per server

    A line chart displays the percentage of disk space usage for the largest partition on the server (%DiskSpaceInUse), or on each server in a Cisco Unified CCX cluster configuration. Each data value in the chart represents the average disk usage for a 15-minute duration. If no data exists, Reporter does not generate the chart. If no data exists for any one server in a cluster configuration, Reporter does not generate the line that represents that server.

    Serviceability report archive configuration checklist shows a line chart example that represents the percentage of hard disk usage for the largest partition per server in a Cisco Unified CCX cluster configuration.

    Figure 3. Line chart that depicts percentage of hard disk usage of the largest partition per server

    The server (or each server in a Cisco Unified CCX cluster configuration) contains log files that match the file name pattern ServerLog_mm_dd_yyyy_hh_mm.csv. The following information exists in the log file:

    • % CPU usage on the server (or each server in a Cisco Unified CCX cluster)
    • % Memory usage (%MemoryInUse) on the server (or on each server in a Cisco Unified CCX cluster)
    • % Hard disk usage of the largest partition (%DiskSpaceInUse) on the server (or on each server in a Cisco Unified CCX cluster)

    Alert summary report

    The Alert Summary Report provides the details of alerts that are generated for the day. The Alert report comprises the following charts:

    Number of alerts per server

    A pie chart provides the number of alerts for the server. The chart displays the server wide details of the alerts that are generated. If no data exists for the server, Reporter does not generate the chart. The message "No alerts were generated for the day" displays.

    Serviceability report archive configuration checklist shows a pie chart example that represents the number of alerts per server in a Cisco Unified CCX cluster.

    Figure 4. Pie chart that depicts number of alerts per server

    Number of alerts per severity for the cluster

    A pie chart displays the number of alerts per alert severity. The chart displays the severity details of the alerts that are generated. Each sector of the pie chart represents the number of alerts that are generated of a particular severity type. The chart provides as many number of sectors as there are severities (for which Reporter generates alerts in the day). If no data exists for a severity, no sector in the chart represents that severity. If no data exists, Reporter does not generate the chart.

    Serviceability report archive configuration checklist shows a pie chart example that represents the number of alerts per severity for a Cisco Unified CCX cluster.

    Figure 5. Pie chart that depicts number of alerts per severity for the cluster

    Top 10 alerts in the cluster

    A bar chart displays the number of alerts of a particular Alert Type. The chart displays the details of the alerts that are generated on the basis of the alert type. Each bar represents the number of alerts for an alert type. The chart displays details only for the first 10 alerts based on the highest number of alerts in descending order. If no data exists for a particular alert type, no bar represents that alert. If no data exists for any alert type, RTMT does not generate the chart.

    Serviceability report archive configuration checklist shows a bar chart example that represents the top 10 alerts in a Cisco Unified CCX cluster.

    Figure 6. Bar chart that depicts top 10 alerts in the cluster

    The server (or each server in a Cisco Unified CCX cluster) contains log files that match the file name pattern AlertLog_mm_dd_yyyy_hh_mm.csv. The following information exists in the log file:

    • Time—Time at which the alert occurred
    • Alert Name—Descriptive name
    • Node Name—Server on which the alert occurred
    • Monitored object—The object that is monitored
    • Severity—Severity of this alert

    Serviceability report archive configuration checklist

    A configuration checklist for configuring the serviceability report archive feature.

    Procedure
      Step 1   Activate the Cisco Serviceability Reporter service.
      Step 2   Configure the Cisco Serviceability Reporter service parameters.
      Step 3   View the reports that the Cisco Serviceability Reporter service generates.