Cisco Unity Connection System Administration Guide, Release 1.x - Generating System Configuration and Call Management Reports [Cisco Unity Connection]

Table Of Contents

Generating System Configuration and Call Management Reports

Reports Overview

Setting Report Configuration Parameters

Archiving Report Data

Generating and Viewing Reports

Generating System Configuration and Call Management Reports

You can use Cisco Unity Connection reports to gather information about system configuration and call handlers. See the following sections in this chapter:

•Reports Overview

•Setting Report Configuration Parameters

•Generating and Viewing Reports

Reports Overview

You can generate the following reports in Cisco Unity Connection Administration:

Table 21-1 System Configuration and Call Management Reports

Report Name

Description of Output

Phone Interface Failed Logon

Output includes the following information for every failed attempt to log on to Connection by phone:

•User name, alias, caller ID, and extension of the user who failed to log on

•Date and time that the failed logon occurred

•Whether the maximum number of failed logons has been reached for the user

Users

Output includes the following information for each user:

•Last name, first name, and alias

•Information that identifies the Connection server associated with the user

•Billing ID, class of service, and extension

•Whether the account is locked

•Whether the user has enabled personal call transfer rules

User Message Activity

Output includes the following information about messages sent and received, per user:

•Name, extension, and class of service

•Date and time for each message

•Information on the source of each message

•Action completed (for example, new message, message saved, MWI On requested, and so on)

•Information on the number of new messages received for a user, and on the message sender

•Dial out number and results

Distribution Lists

Output includes the following information:

•Name and display name of the list

•Date and time the list was created

•Date and time of the creation of the distribution list is given in Greenwich mean time.

•A count of the number of users included in the list

•If the Include List Members check box is checked, a listing of the alias of each user who is a member of the list

User Lockout

Output includes user alias, the number of failed logon attempts for the user, credential type (a result of "4" indicates a logon attempt from the Connection conversation; a result of "3" indicates a logon attempt from a web application) and the date and time that the account was locked.

Note Date and time of the lockout of the user account is given in Greenwich mean time.

Unused Voice Mail Accounts

Output includes user alias and display name, and the date and time that the user account was created.

Note Date and time of the creation of the user account is given in Greenwich mean time.

Transfer Call Billing

Output includes the following information for each call:

•Name, extension, and billing ID of the user

•Date and time that the call occurred

•The phone number dialed

•The result of the transfer (connected, ring-no-answer (RNA), busy, or unknown)

Outcall Billing Detail

Output includes the following information, arranged by day and by the extension of the user who placed the call:

•Name, extension, and billing ID

•Date and time the call was placed

•The phone number called

•The result of the call (connected, ring-no-answer (RNA), busy, or unknown)

•The duration of the call in seconds

Outcall Billing Summary

Output is arranged by date and according to the name, extension, and billing ID of the user who placed the call, and is a listing of the 24 hours of the day, with a dialout time in seconds specified for each hour span.

Call Handler Traffic

Output includes the following information for each call handler, in rows for each hour of a day:

•Total number of calls

•Number of times each touchtone key was pressed

•Extension

•Invalid extension

•Number of times the after greeting action occurred

•Number of times the caller hung up

System Configuration

Output includes detailed information about all aspects of the configuration of the Connection system.

Setting Report Configuration Parameters

Cisco Unity Connection is automatically set to gather and store data from which you can generate reports. The following parameters can be adjusted, depending on the report output that you want to generate. All report parameter settings are found on the System Settings > Advanced > Reports page in Cisco Unity Connection Administration.

•Milliseconds Between Data Collection Cycles—Set by default to 30 minutes (1,800,000 milliseconds). This setting controls the amount of time Connection waits between cycles of gathering report data.

•Days to Keep Data in Reports Database—Set by default to 180 days. Note that even if you specify more than this number of days in the time range for the report you are generating, the number of days of data is limited by what you set here.

•Maximum Records in Report Output—Set by default to 25,000 records. The maximum value allowed for this field is 30,000 records. If the report you want to generate exceeds the maximum number of records allowed, you can generate the report in pieces, for example by reducing the date range or number of user accounts included in each iteration.

Note The Maximum Records in Report Output setting for the User Message Activity Report has been restricted to 15,000 records—rather than the default of 25,000 records—because of the size of the report.

•Minimum Records Needed to Display Progress Indicator—Set by default to 2,500 records. The maximum value allowed for this field is 10,000 records. The purpose of the progress indicator is to warn you if the report you request is large and likely to take a long time to complete. In Connection, reports are generated from within a browser, and the browser session must be kept open while the report is being generated. Depending on the size of the database, and the type of report being generated, a report can take a long time to generate; meanwhile, you will be unable to use the browser, and must keep the Connection Administration session open.

Archiving Report Data

Reports data is gradually written over, depending on parameters that you set for retention of data. We recommend that if you want to keep reports for historical purposes, you develop a schedule for regularly generating reports, and save them in a location separate from the Cisco Unity Connection server.

Generating and Viewing Reports

When you generate a report, you can specify some or all of the following:

•The objects (for example, user accounts, or call handlers) to include in the report

•The date and time range to include

•The sort order for the data in the report

You also choose a file format for the report:

Web page

An HTML file. The report output appears in your web browser.

Select this format to quickly view a small report. Note that because viewing a web page report directly on the Connection server could potentially affect system performance, the size of web page reports is limited in this circumstance to 250 records. If you want to run a web page report that is larger than 250 records, browse to Connection Administration from another computer, and then generate the report.

For archiving purposes, we recommend that you generate PDF reports.

Comma-delimited file

A text file (also known as a comma separated or CSV file). Report output appears as a string of data, separated by commas. Select this format if you want to view or print the information in another application, for example, a spreadsheet program.

PDF file

The report output appears as a PDF, in an easy to read format. It can be printed and saved. We recommend that you choose this format if you plan to archive reports.

The best time to generate reports is when the system is not busy: after regular business hours when Connection is not processing many calls, or when there are no other processes running (for example, before or after a full backup). Requests to generate reports are queued. If multiple reports are generated at one time (from separate browsers), the reports wait in line and only one is processed at a time.

Caution Generating large reports when the system is busy will use system resources and could potentially result in slower response time for system users.

Note that reports cannot be scheduled in advance, and if you shut down the Connection server or close the Connection Administration browser session while reports are being generated, the report generation will be cancelled.

To Generate and View a Report

Step 1 In Cisco Unity Connection Administration, expand Monitoring & Reports, then click Reports.

Step 2 On the Reports page, click the name of the report that you want to generate.

Step 3 Select a file format for the report output:

•Web Page

•Comma-Delimited File

•PDF File

Step 4 Set a date range by clicking the applicable beginning and ending month, day, year, and time.

Step 5 Set other parameters, as applicable.

Step 6 Click Generate Report.

Step 7 View the report output, depending on the file format you chose in Step 3:

•If you chose Web Page, the report output appears in your browser window.

•If you chose Comma-Delimited File, a file download dialog box opens, asking you whether you want to open or save the file.

•If you chose PDF File, a file download dialog box opens, asking you whether you want to open or save the file.