Diagnostics & monitoring
Narrow down a call problem: procedure step by step
From the reported problem through call list, call diagnostics and call analysis to a documented finding.
In EasyUC: EasyUC Cisco → Reporting → Nutzung & Erreichbarkeit → Calls; Logs → Call Diagnostics / Call Analysis
What it is for
"The call at 10:42 did not get through." Most fault reports start like this or similarly. This chapter describes a fixed procedure for turning such a report into a documented finding: which call it was, how it ended, where it failed and what the evidence is.
EasyUC offers several tools for this. The call list shows finished calls from the CDRs. Call diagnostics fetches the SIP flow of a known call from the traces. Call analysis pulls all calls of a period, including those that were never completed. Live Calls shows what is in progress right now. For Teams calls over the integrated SBC there is the call history.
Time is decisive. The CUCM traces are overwritten after a few hours. Therefore start the investigation on the same day if possible.
Prerequisites
- Role
ROLE_APP_CALL_DIAGNOSTICS. It includes read access to the call list. - The CDR import of the CUCM connection is running.
- On the CUCM, Cisco CallManager uses trace level Detailed with Enable SIP Call Processing Trace.
- From the person reporting: the time as exactly as possible, their own number, the number of the other party, the direction of the call and what they heard or saw.
- For calls through a CUBE: debug capture switched on at the CUBE if you want to see the leg to the provider.
Step by step: record the report
Step by step: find the call
Step by step: evaluate the call
Fields and options: which tool for what
| Field / action | Meaning and use |
|---|---|
| Call list (Reporting) | Finished calls from the CDRs with time, numbers, duration and cause. The first place to look when time and number are known. Calls appear only after the CDR interval of the CUCM and the import. |
| Call diagnostics | SIP flow of a single, known call from the traces of all CallManager nodes. Time window one second to 30 minutes. |
| Call analysis | All calls of a period from CDRs and traces, including calls that were not completed or are still in progress. With call flow up to 60 minutes, CDRs only up to 24 hours. |
| Live Calls | Calls in progress in the cluster. Suitable when the problem can be reproduced. |
| CURRI logs | Shows whether a rule rejected or redirected the call. Call diagnostics can be started directly from there. |
| Call history in the Teams tenant | SIP ladder diagram per Teams call over the integrated SBC. |
| CUBE debug capture | Adds the leg between CUBE and provider to the flow. |
| Registration history | Shows whether the destination device was registered at the time of the call. |
Fields and options: typical findings
| Field / action | Meaning and use |
|---|---|
| Busy although nobody is on a call | 486 comes from the CUCM without an INVITE to the destination: the busy trigger of the line is reached, often because of a held or stuck call. Check the busy trigger and Live Calls. |
| External call does not arrive | No call in CDRs and traces: it did not reach the CUCM. 404 from the CUCM: the number arrives in a format that matches no pattern. Read the destination number in the INVITE. |
| Outbound external call fails immediately | 503 or 403 from the lane of the trunk: trunk faulty, channels in use or calling number not permitted. |
| It rings, but nobody picks up | 180 Ringing, then CANCEL from the caller or a forwarding. Not a technical error. Check the ring time and call forward no answer. |
| Call ends up at the wrong destination | Dialled and Reached differ. The redirect chain names who redirected. |
| No audio or audio in one direction only | Signalling complete with 200 OK and ACK. Compare the SDP of both sides. The error is in the media path: firewall, routing or NAT. |
| Disconnect after fixed times | BYE after the same duration every time: a session timer or a firewall ends the connection. Read the gaps in the time column. |
| Poor audio quality | Quality Fair or Poor with packet loss or jitter. Check the network path of the reporting device. |
Check the result and narrow down errors
- A finding is complete when it contains five items: time and numbers of the call, result, cause, the place in the flow with the decisive message and the exported evidence.
- The call is older than two hours and the diagnosis finds no messages: the traces have been overwritten on the CUCM. The CDRs remain available and provide result and cause, but no call flow.
- The call list does not show the call yet: the CDRs arrive with a delay. Call analysis with the traces source shows it immediately.
- Several calls match time and number: compare devices and duration. Call diagnostics lists Other matching calls.
- The call flow is missing for a device with SCCP or on an analogue port: for these devices there are only CDRs.
- If the problem can be reproduced, do so and start the call diagnosis directly afterwards. For calls through the CUBE, switch on its debug capture beforehand.
- Pass exports on only to the intended recipient. They contain phone numbers and device names. Credentials and keys are removed.