Administration Guide for Cisco Unity Connection Serviceability Release 7.x
Using Reports
Downloads: This chapterpdf (PDF - 117.0KB) The complete bookPDF (PDF - 863.0KB) | Feedback

Using Reports

Table Of Contents

Using Reports

Understanding Reports

Setting Report Configuration Parameters

Generating and Viewing Reports


Using Reports


This chapter provides information on using reports in Cisco Unity Connection Serviceability and contains the following sections:

Understanding Reports

Setting Report Configuration Parameters

Generating and Viewing Reports

Understanding Reports

Revised May 2009

Cisco Unity Connection Serviceability lets you gather information about system configuration and call handlers into reports.

Table 6-1 describes the reports that you can generate in Cisco Unity Connection Serviceability.

Table 6-1 Reports Available in Cisco Unity Connection Serviceability 

Report Name
Description of Output

Phone Interface
Failed Logon

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

Username, alias, caller ID, and extension of user who failed to log on.

Date and time the failed logon occurred.

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

Users

Includes the following information for each user:

Last name, first name, and alias.

Information that identifies the Connection or Cisco Unified CMBE 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.

Message Traffic

Includes totals for the following traffic categories:

Voice.

Fax.

E-mail.

NDR.

Delivery.

Read receipt.

Hourly totals.

Port Activity

Includes the following information for voice messaging ports:

Name.

Number of inbound calls handled.

Number of outbound MWI calls handled.

Number of outbound AMIS calls handled.

Number of outbound notification calls handled.

Number of outbound TRaP calls handled.

Total number of calls handled.

Mailbox Store

Includes the following information about the specified mailbox stores:

Mail database name.

Display name.

Server name.

Whether access is enabled.

Mailbox store size.

Last error.

Status.

Whether the mail database can be deleted.

Dial Plan

Includes a list of the search spaces configured on the Connection or Cisco Unified CMBE server, with an ordered list of partitions assigned to each search space.

If the server is part of a Digital Network, also lists the search spaces and associated partition membership on every other Connection location on the network.

Dial Search Scope

Includes a list of all users and their extensions in the specified partition that is configured in the Connection directory. If a partition is not specified, lists all users and their extensions for all partitions that are configured in the directory.

Subscriber Message
Activity

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

Includes the following information:

Name and display name of the list.

Date and time the list was created. (Date and time are 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

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.

(Date and time are given in Greenwich Mean Time.)

Unused Voice Mail
Accounts

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

(Date and time are given in Greenwich Mean Time.)

Transfer Call Billing

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

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

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

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

Total number of calls.

Number of times each key on the phone keypad was pressed.

Extension.

Invalid extension.

Number of times the after greeting action occurred.

Number of times the caller hung up.

System Configuration

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 parameters listed in this section 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.

Reports data is gradually written over, depending on the parameters 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 Connection or Cisco Unified CMBE server.

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.

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 can choose one of the following file formats for the report:

Web page

HTML file. Report output appears in your web browser.

Select this format to quickly view a small report.

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

Comma-delimited file

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

Report output appears as a PDF that 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. If you shut down the Connection or Cisco Unified CMBE server, or close the Connection Administration browser session while reports are being generated, the report generation will be canceled.

To Generate and View a Report


Step 1 In Cisco Unity Connection Serviceability, choose Tools > Reports.

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

Step 3 Select the applicable file format for the report output.

Step 4 If the fields are available, set a date range by clicking the 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:

Web Page

Output appears in your browser window.

Comma-delimited File

File download dialog box opens, asking whether you want to open or save the file.

PDF File

File download dialog box opens, asking whether you want to open or save the file.