Call diagnostics: el flujo SIP de una llamada individual

Para qué sirve

Call diagnostics responde a la pregunta de qué ocurrió con una llamada concreta a nivel de señalización. Usted selecciona la llamada en la lista de llamadas (CDR) o en el registro CURRI. EasyUC carga entonces las trazas SDL del servicio Cisco CallManager de todos los nodos CallManager del clúster para ese intervalo exacto, extrae los mensajes SIP de esa llamada y los muestra como diagrama de escalera.

Esto sustituye la recopilación y la búsqueda manual de archivos de traza con RTMT. La función solo lee archivos de traza existentes a través de la interfaz de recopilación de logs de CUCM. No modifica ninguna configuración de CUCM y no activa trazas.

Si la llamada pasó por un CUBE con la captura de depuración activada, EasyUC incorpora sus mensajes SIP al mismo flujo. Esto solo ocurre para usuarios con acceso de lectura a los CUBE.

Requisitos previos

• Módulo de licencia cucm y una conexión CUCM operativa.
• Rol ROLE_APP_CALL_DIAGNOSTICS ("Analyze CUCM Calls" en el editor de roles). Permite iniciar, ver y exportar, e incluye el rol de página ROLE_APP_VIEW_CALL_DIAGNOSTICS_PAGE y el acceso de lectura a la lista de llamadas.
• El usuario AXL de la conexión CUCM tiene los roles de CUCM Standard CCM Admin Users y Standard RealtimeAndTraceCollection. Sin ellos, el nodo informa de que falta un rol.
• En CUCM, el servicio Cisco CallManager utiliza el nivel de traza Detailed con Enable SIP Call Processing Trace. Sin este ajuste, las trazas no contienen mensajes SIP.
• EasyUC alcanza cada nodo CallManager por su nombre desde CUCM mediante HTTPS (puerto 8443).
• Al iniciar desde la lista de llamadas: la importación de CDR de la conexión está en funcionamiento. Al iniciar desde CURRI: la llamada figura en el registro CURRI.
• Para Call diagnostics no se necesitan credenciales SSH (administrador de plataforma/SO). Solo se utilizan para "Details (SSH)" de los nodos CUCM.
• El servicio en segundo plano para la recopilación de trazas está en funcionamiento. Procesa una sola recopilación a la vez.
• Para los mensajes del CUBE en el flujo: acceso de lectura a los CUBE (ROLE_APP_GATEWAYS con ROLE_APP_GATEWAYS_CUBE). Los administradores lo tienen siempre.

Paso a paso: iniciar un diagnóstico desde la lista de llamadas

1. Seleccione en la cabecera la conexión CUCM por la que pasó la llamada.
2. Abra Logs → Call Diagnostics y haga clic en Select a call. Así accederá a la lista de llamadas en Reporting → Nutzung & Erreichbarkeit → Calls.
3. Busque la llamada por período y número.
4. En la fila de la llamada, haga clic en Analyze en la columna Call diagnostics.
5. En el diálogo Analyze this call, compruebe Timezone y el intervalo de tiempo rellenado previamente. Abarca 60 segundos antes y después de la llamada.
6. Si es necesario, acote el intervalo con Start Time y End Time.
7. Haga clic en Start call analysis. EasyUC abre la página de detalle del diagnóstico.
8. Espere a que termine el indicador de progreso. Muestra por turno "Determining CallManager nodes", "Listing trace files", "Downloading trace files", "Correlating SIP messages" y "Saving the call flow", junto con el nodo y el contador de archivos.
9. Lea el resultado en la pestaña Call flow.

Paso a paso: iniciar un diagnóstico desde el registro CURRI

1. Abra CURRI → Curri Logs.
2. Busque la fila de la llamada.
3. En la columna Call flow, haga clic en el icono de diagrama (Show SIP flow).
4. EasyUC inicia el diagnóstico sin otro diálogo y abre la página de detalle. El intervalo va desde 60 segundos antes de la entrada CURRI hasta 10 minutos después.
5. Si la misma fila se analizó en los últimos 15 minutos, EasyUC abre el diagnóstico existente en lugar de iniciar uno nuevo.

Paso a paso: exportar un resultado y volver a encontrarlo

1. Abra Logs → Call Diagnostics. Bajo Recent diagnoses hay una tarjeta por diagnóstico con estado, origen (CDR o CURRI), número de diagnóstico, llamante, destino, hora y dispositivo.
2. Haga clic en una tarjeta para abrir de nuevo el diagnóstico.
3. Haga clic en SIP messages (text), Filtered logs o Analysis (JSON), arriba a la derecha, para descargar el resultado.
4. En la pestaña Call flow, haga clic en Download SVG para guardar el diagrama como imagen.

Campos y opciones

Cómo leer el diagrama de escalera

Comprobar el resultado y acotar errores

• Reconocerá el éxito por el estado Completed y por un diagrama que empieza con INVITE y termina con BYE o con una respuesta de error.
• "The traces contain no SIP messages. Set the trace level of the Cisco CallManager service to "Detailed" and enable "Enable SIP Call Processing Trace".": corrija el ajuste de traza en todos los nodos CallManager de CUCM y repita la llamada.
• "The call is older than two hours; its traces may have been rotated on the CUCM.": CUCM rota sus archivos de traza. Inicie el diagnóstico lo antes posible después de la llamada.
• "Role missing: the AXL user needs "Standard CCM Admin Users" and "Standard RealtimeAndTraceCollection"": añada los roles al usuario AXL en CUCM.
• "Only the calling number matched; the call flow may belong to another call of this caller.": compare la hora y el destino y revise la tabla Other matching calls.
• "The call was still in progress when the traces were read; the call flow ends there.": inicie de nuevo el diagnóstico cuando la llamada haya terminado.
• "Another call diagnosis is running on this CUCM connection": por cada conexión CUCM se ejecuta un solo diagnóstico a la vez. EasyUC abre el que está en curso. Los demás esperan en el orden en que se iniciaron.
• "The analysis did not finish: the background worker has not reported for 10 minutes." o el aviso de que el worker no lo ha recogido en una hora: el worker en segundo plano para la recopilación de trazas no funciona. Inicie de nuevo el diagnóstico y revise los workers si ocurre repetidamente.
• "Das Zeitfenster der Anrufdiagnose muss zwischen einer Sekunde und 30 Minuten liegen." (el servidor devuelve este mensaje en alemán): reduzca el intervalo con Start Time y End Time.
• Límites por diagnóstico: como máximo 8 nodos CallManager, 12 archivos de traza por nodo, 64 MiB por archivo y 800 mensajes en el diagrama. Cuando se alcanza un límite, el resultado sigue visible y recibe el estado Partial con un aviso.
• Si el diagrama no muestra el CUBE aunque la llamada pasó por él, los avisos indican el motivo, por ejemplo que su captura de depuración está desactivada o que la captura se conserva durante menos días que la antigüedad de la llamada.
• "The CUCM node list was not available; only the AXL host was searched.": EasyUC no pudo determinar los nodos del clúster. Si la llamada pasó por otro nodo, falta. Revise el acceso AXL.
• "The time zone of … is unknown; UTC is assumed.": las horas de este nodo pueden estar desplazadas. Compárelas con las horas de los demás nodos.
• "The traces on … start after the call began; the beginning may be missing." y "The CUCM did not provide SDL trace files for the time of the call.": las trazas ya se han sobrescrito.
• "More trace files cover the call on … than the limit of …; the end of the call may be missing." y "The trace analysis stopped after … MiB of trace data.": reduzca el intervalo de tiempo.
• "More than … SIP messages in the call window; later messages were ignored." y "The call flow was limited to … messages.": el intervalo de tiempo es demasiado grande para el tráfico del clúster. Redúzcalo.
• "The traces contain SIP messages, but none at the time of the call (rotated traces or a time zone offset).": revise la zona horaria en el diálogo y el reloj de CUCM.
• "No SIP dialog in the traces matches the numbers and the time of the call.": la llamada no utilizó SIP, o los números se reescribieron antes del nodo. Amplíe el intervalo de tiempo.
• Avisos sobre el CUBE: "The debug capture of the CUBE … holds no SIP messages of this call.", "The CUBE debug capture could not be read; the call flow shows the CUCM traces only." y "… could only be read in part". El flujo de las trazas de CUCM sigue siendo válido en todos los casos.
• Las credenciales y las claves SRTP se eliminan antes de la visualización y en todas las exportaciones. La función solo lee y no modifica nada en CUCM.