Administration Guide for the Cisco Unified Application Environment (2.5.1)
Serviceability
Downloads: This chapterpdf (PDF - 113.0KB) The complete bookPDF (PDF - 3.96MB) | Feedback

Serviceability

Table Of Contents

Serviceability

Managing Server Logs

Viewing Server Logs

Deleting Server Logs

Archiving Server Logs

Managing Services

Configuring Trace Settings

Using Trace Settings for Troubleshooting

Configuring Logger Settings

Configuring Trace Levels

Viewing Usage Statistics

Using Diagnostics

Managing Alarms

Viewing Alarms

Configuring Alarm Managers

Setting Alarms to Ignored


Serviceability


Serviceability provides tools to help you monitor, diagnose, and troubleshoot Cisco Unified Application Environment. This chapter includes these topics:

Managing Server Logs

Managing Services

Configuring Trace Settings

Viewing Usage Statistics

Using Diagnostics

Managing Alarms

Managing Server Logs

This section includes these topics:

Viewing Server Logs

Viewing Server Logs

Deleting Server Logs

Archiving Server Logs

Viewing Server Logs

To view server logs, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Server Logs. The Server Logs page appears with a list of server log folders. Table 8-1 describes the information provided.

Table 8-1 Server Logs 

Field
Description

Name

Name of the server log folder

Size

Folder size

Last Modified

Date and time the folder was last updated


Step 3 To view individual logs, click on the name of the server log folder, and a page appears with all the log files within it.


Deleting Server Logs

To delete server logs, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Server Logs. The Server Logs page appears.

To delete the server log folder, select the check box next to the name, then click Delete.

To delete individual log files:

a. Click the name of the server log folder. A page with all the log files within it appears.

b. Select the file or files you want to delete, then click Delete.


Archiving Server Logs

To delete server logs, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Server Logs. The Server Logs page appears.

Step 3 Select the log name you want to archive, then click Archive.

A message appears when the zip file of the log file has been successfully created and archived.

Step 4 To download the archive, click Download Archived Server Logs.

Step 5 Click Done to return to the Server Log page.


Managing Services

You can enable, disable, stop, restart, or kill services that run on the server. Under normal circumstances, it should not be necessary to perform these functions unless:

You have modified configuration parameters, and a message indicates you must restart a particular service for the configuration change to take effect.

A service is not functioning properly.

A Cisco support representative has asked you to restart a service to help debug an issue.


Note Services require differing amounts of time to restart.


To access and manage services, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Services. The Services page appears. Table 8-2 describes the information provided.

Table 8-2 Services 

Field
Description

Service Name

Name of the service

Description

Description of the service

Enabled

Service is enabled (Yes) or disabled (No)

State

State of the service


Step 3 Do one or more of the following:

To refresh the page, click Refresh All.

To disable a service, select the check box next to the service name, then click Disable.

To enable a service, select the check box next to the service name, then click Enable.

To start a service, select the check box next to the service name, then click Start.

To restart a service, select the check box next to the service name, then click Restart.

To stop a service, select the check box next to the service name, then click Stop.

To kill a service, select the check box next to the service name, then click Kill.


Configuring Trace Settings

This section contains these topics:

Configuring Logger Settings

Configuring Trace Levels

Using Trace Settings for Troubleshooting

Follow these high-level tasks when troubleshooting server problems:

1. Check the Cisco Unified Application Server log files (choose Serviceability > Trace Configuration from the Cisco Unified Application Environment Administration). The default logging level for most components is Warning.

2. To aid in diagnosing a problem, choose a higher logging level, such as Verbose.

3. Run the application again to generate logs under the Verbose conditions.

Configuring Logger Settings

To configure the logger settings, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Trace Configuration. The Trace and Logger Configuration page appears.

Step 3 Enter values under Logger Settings as described in Table 8-3.

Table 8-3 Logger Settings 

Field
Description

Max File Log Lines

Maximum number of lines written to the log file before starting a new file

Max Files

Maximum number of log files to save before overwriting

Debug Console Port

Port on which the TCP remote console logger listens for connections

Log Server Sink Logger Level

Filters log server debug output below specified level

(See Table 8-5 for description of levels)

Enable Logger Queue Diagnostics

If enabled (Yes), queue size and object generation will be output in log messages


Step 4 Click Save.


Configuring Trace Levels

To configure the trace levels for a single component or several components at a time, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Trace Configuration. The Trace and Logger Configuration page appears. Under Component Trace Level Configuration, component information appears as described in Table 8-4.

Table 8-4 Component Trace Level Configuration 

Field
Description

Component Display Name

Name of the component

Component Type Display

Component type

Trace Level

Trace level


Step 3 To change the trace level of a component, follow these steps:

a. Click the check box next to the component name.

b. From the list, select one of the trace levels described in Table 8-5.

Table 8-5 Trace Levels 

Field
Description

Off

No logging

Error

Only error messages written to log

Warning

Only warning messages written to log

Info

Warning, error, and terse event information messages written to log

Verbose

Warning, error, and detailed event information messages written to log


c. Click Save.

.


Viewing Usage Statistics

To view usages statistics, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Usage Statistics. The Usage Statistics page appears as described in Table 8-6.

Table 8-6 Usage Statistics 

Field
Description

Metric

Resource type

Currently in Use

Concurrent instances of each resource type currently used


To view every metric for a preset interval, follow these steps:

a. From the View graphs of list, select the type of metric for which you want data graphed.

b. Click View.

To view a graph of every preset time interval for a particular metric, follow these steps:

a. From the View graphs of all metrics over the last, select the time interval for which you want data graphed.

b. Click View.


Using Diagnostics

To view diagnostic information for particular components, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Diagnostics. The Diagnostics page appears.

Step 3 Click Invoke Extension to view information.


Managing Alarms

Real-time alarm messages warn of critical system events, such as a server failing to start.

This section includes these topics:

Viewing Alarms

Configuring Alarm Managers

Setting Alarms to Ignored

Viewing Alarms

To view, acknowledge, and resolve alarms, and to download a MIB for monitoring the Cisco Unified Application Server and the Cisco Unified Media Engine, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Alarms > Active Alarms. The Active Alarms page appears.

To acknowledge the alarms, click Set Acknowledged.

To resolve the alarms, click Set Resolved.

To download a MIB file, which can be loaded into network management software, click Download MIB. The MIB defines a number of traps and real-time statistics which are useful for SNMP monitoring systems.


Configuring Alarm Managers

To configure or delete alarm managers, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Alarms > Alarm Manager. The Alarm Mangers page appears.

To delete an alarm manager, select it, then click Delete.

To add an SNMP manager, click Add SNMP Manager, follow these steps:

a. Enter the SNMP manager address.

b. Select he trigger level for the alarm.

c. Click Save.

To add an SMTP manager, click Add SMTP Manager, follow these steps:

a. Enter the values as described in Table 8-7.

Table 8-7 SMTP Manager Configuration

Field
Description

Recipient

Email address where messages are sent to

Sender

Email address where messages are sent from

Server

SMPT server address

Username

Name for outbound SMTP authentication

Password

Password for outbound authentication

Server Port

SMTP server port

Trigger Level

Error trigger level for alarm

Secure Connection

Select for secure connection


b. Click Save.


Setting Alarms to Ignored

To set alarms to ignored so that they do not continue to be active, follow these steps:

Procedure


Step 1 Log in to the Cisco Unified Application Environment Administration.

Step 2 Choose Serviceability > Alarms > Set Ignored Alarms. The Set Ignored Alarms page appears.

Step 3 Select the alarms you want to ignore, then click Update.