The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Serviceability provides tools to help you monitor, diagnose, and troubleshoot Cisco Unified Application Environment. This chapter includes these topics:
This section includes these topics:
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.
|
|
---|---|
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.
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.
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.
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.
|
|
---|---|
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.
This section contains these topics:
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.
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.
|
|
---|---|
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.
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.
|
|
---|---|
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.
c. Click Save.
.
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.
|
|
---|---|
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.
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.
Real-time alarm messages warn of critical system events, such as a server failing to start.
This section includes these topics:
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.
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.
b. Click Save.
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.