Get Troubleshooting Logs

This article explains how to enable and gather UDS logs from CUCM. UDS logs are useful for debugging service issues.  They provide details on exactly what services were invoked, when they were invoked, and what they actually did including any run time errors.

The system writes the UDS trace logs to the Tomcat logs directory accessible via RTMT. File names are cucm-uds####.log, where # represents a number from 0000 (zero) to the maximum number of files allowed. The maximum file size is 1 MB by default. The maximum number of stored files defaults to 10. You can change these settings through the Serviceability windows.

Enabling UDS Logs from the Serviceability Window

1. From the Unified CM Administration window, choose Application > Cisco Unified Serviceability.

2. Choose Trace > Configuration.

3. From the Servers column, select the server and click GO.

4.From the Service Group box, select CM Services and click GO.

5.From the Services box, select the Cisco User Data Services and click GO.

6. If you want the trace to apply to all Unified CM servers in the cluster, select the Apply to All Nodes check box.

7.Check the Trace On check box.

8.In Debug Trace Level box, select Debug.

9.Check the Enable All Trace check box.

NOTE: When you change either the Maximum No. of Files or the Maximum File Size settings in the Trace Configuration window, the system deletes all service log files except for the current file, that is, if the service is running; if the service has not been activated, the system deletes the files immediately after you activate the service. Before you change the Maximum No. of Files setting or the Maximum File Size setting, download and save the service log files to another server if you want to keep a record of the log files; to perform this task, use Trace and Log Central in RTMT.

Gathering UDS logs through Real-time Monitoring Tool (RTMT)

To use this tool, you must download it from Cisco Unified Communications Manager.

1.Log into CUCM Administration.

2.Click Application > Plugins.

3. Search and find the Cisco Unified Real-Time Monitoring Tool.

4. Click Download next to Cisco Unified Real-Time Monitoring-Linux if your OS is Linux or Download next to Cisco Unified Real-Time Monitoring-Windows if your OS is Windows.

5.Install the RTMT tool.

6.Start the RTMT tool.

7.In the Host IP Address box, enter the IP address of the CUCM server you want to monitor.

8.In the User Name box, enter the user name for the CUCM server you want to monitor

9.In the Password box, enter the password for the CUCM server you want to monitor

10. To collect logs and traces, go to System, click Trace & Log Central, and double-click Collect Files.

11. Select the Cisco CallManager check boxes in both columns.

12. Select the Cisco User Data Services check boxes in both columns.

13. Click Next.

14. Click Next.

15. On the Collect File Options screen, select an Absolute Range approximately 30 minutes before and after your test run.

16. Click Finish

17. For convenience, zip the resulting files.

If you need additional support you can open a developer support case.



Visit the UDS Developer Forums to ask questions and interact with other developers.