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.
Feedback
