Call analysis: extraer todas las llamadas de un período

Para qué sirve

Call analysis extrae todas las llamadas de un período para una conexión CUCM y las muestra como lista. Lo necesita cuando todavía no conoce la llamada afectada: "calls did not get through between 10:00 and 10:30". Call diagnostics, en cambio, examina una única llamada que ya se conoce.

Una extracción de este tipo se denomina run (ejecución). Combina dos fuentes. Los CDR aportan la lista completa de llamadas finalizadas con horas, números, dispositivos y causas. Las trazas SDL de los nodos CallManager aportan los mensajes SIP y, con ello, el flujo de la llamada, incluidas las llamadas que no se completaron o que siguen en curso. Si falta una fuente, la lista se construye con la otra, con un aviso en la ejecución.

La ejecución trabaja en segundo plano y después se almacena durante 7 días. Durante ese tiempo puede abrir el resultado tantas veces como desee sin volver a consultar CUCM. Sin la fuente de trazas no se contacta con CUCM en absoluto.

Requisitos previos

• Módulo de licencia cucm. La función se describe tal como se ejecuta en el sistema de laboratorio (entrada de menú Logs → Call Analysis).
• Rol ROLE_APP_CALL_DIAGNOSTICS con rol de página ROLE_APP_VIEW_CALL_DIAGNOSTICS_PAGE. Las cuentas de solo lectura pueden ver y exportar ejecuciones almacenadas, pero no iniciar, cancelar ni eliminar ejecuciones.
• La cuenta no está restringida a ubicaciones. El análisis muestra todas las llamadas del clúster y no está disponible para cuentas restringidas por ubicación.
• Para la lista de llamadas finalizadas: la importación de CDR de la conexión CUCM está activada.
• Para los flujos de llamada: en CUCM, Cisco CallManager utiliza el nivel de traza Detailed con Enable SIP Call Processing Trace.
• Para los flujos de llamada: el usuario AXL de la conexión tiene los roles de CUCM Standard CCM Admin Users y Standard RealtimeAndTraceCollection.
• En el servidor EasyUC hay libres al menos 256 MiB de espacio en disco para la ejecución.

Paso a paso: extraer llamadas

1. Seleccione la conexión CUCM en la cabecera. La página la muestra arriba a la derecha bajo CUCM connection.
2. Abra Logs → Call Analysis.
3. En el área Pull calls, elija una selección rápida en Period: Last 15 minutes, Last 30 minutes o Last 60 minutes.
4. Para otro intervalo, haga clic en Custom period e introduzca From y To.
5. En Data sources, seleccione CDRs (finished calls) y Call flows from CUCM traces (SIP). Debe seleccionarse al menos una fuente.
6. Si es necesario, abra Filters (optional) e introduzca un Number o un Device name para conservar solo las llamadas coincidentes.
7. Lea las indicaciones bajo el botón. Señalan la duración permitida y lo actualizados que están los CDR, por ejemplo "CDRs are available up to …. Later calls come from the traces only."
8. Haga clic en Pull calls. EasyUC crea la ejecución y abre su página.
9. Siga el progreso. El indicador nombra la fase ("Reading CDRs", "Downloading and reading trace files", "Combining calls" …), el nodo, el contador de archivos y los CDR y mensajes SIP leídos hasta el momento.
10. Cuando la ejecución ha terminado, la página muestra la lista de llamadas. El capítulo sobre la lista de llamadas continúa a partir de aquí.

Paso a paso: cancelar, reabrir o eliminar una ejecución

1. Para detener una ejecución en curso, haga clic en Cancel run en su página. Una ejecución cancelada no almacena llamadas.
2. Para abrir un resultado anterior, abra Logs → Call Analysis y haga clic en la fila bajo Stored runs.
3. Para repetir el mismo período con CDR más recientes, haga clic en Pull this period again en la página de la ejecución.
4. Para eliminar una ejecución, haga clic en el icono de papelera de su fila y confirme Delete this run with all its stored calls?. Una ejecución en curso debe cancelarse antes.

Campos y opciones

Cómo leer la página de una ejecución

Comprobar el resultado y acotar errores

• Reconocerá el éxito por el estado Completed y porque el número bajo With call flow coincide con el número de llamadas SIP del período.
• "A run is already active for this connection.": una sola ejecución por conexión a la vez. Open the active run le lleva a ella.
• "Several runs are already waiting. Please try again later.": como máximo tres ejecuciones están activas a la vez en total.
• "The run is waiting. If another diagnosis is running, it starts afterwards.": las recopilaciones de trazas se ejecutan una tras otra, también en relación con Call diagnostics.
• "The period must not be longer than … minutes." o "The period must be at least … seconds long.": ajuste el período o desmarque la fuente de trazas.
• "Call analysis shows all calls of the cluster and is not available to accounts restricted to locations.": utilice una cuenta sin restricción de ubicación.
• "There is not enough free disk space on the server for a run.": elimine ejecuciones antiguas y revise la página de almacenamiento.
• "The traces contain no SIP messages. Set the trace level "Detailed" with "Enable SIP Call Processing Trace".": corrija el ajuste de traza en CUCM.
• "Node … could not be read (role missing)": añada los roles de CUCM al usuario AXL. En el caso de "TLS error" o "not reachable", revise el certificado y la ruta de red hasta el nodo.
• "CDR import is off for this connection. The list comes from the traces only.": configure la importación de CDR en la conexión CUCM si desea ver las llamadas finalizadas de forma completa.
• Las ejecuciones fallidas indican el motivo, por ejemplo "The worker stopped responding." o "The run was not started in time." En ese caso, revise los servicios en segundo plano.
• Límites de protección por ejecución: 40 archivos de traza por nodo y 120 en total, 40 000 mensajes SIP, 20 000 filas CDR, 10 000 llamadas, 10 minutos de tiempo de lectura de trazas y 15 minutos de tiempo total de ejecución.
• "The period is … hours old; the traces may already be overwritten on the CUCM.": la ejecución lo intenta de todos modos. Si faltan los flujos de llamada, queda la lista de los CDR.
• "More than … CDRs in the period; the rest is missing. Choose a shorter period." y "More than … calls in the period; the list is cut off. Choose a shorter period or a filter.": se alcanzó un límite de protección.
• "More than … SIP messages in the period; later ones are missing. Choose a shorter period.", "Reading the traces stopped after … seconds." y "The worker's memory limit was reached; later SIP messages are missing.": en un clúster con mucho tráfico, el límite no alcanza para 60 minutos. El aviso "Call flows were read only for … – …." indica el intervalo cubierto.
• "… calls began before the period and are not listed.": una llamada pertenece a la ejecución si comenzó dentro del período. Haga que el período empiece antes.
• "The devices could not be resolved; the call flow shows addresses.": los carriles llevan entonces direcciones IP en lugar de nombres de dispositivo. El flujo en sí está completo.
• "Run filter: … calls kept, … dropped.": confirma el efecto de los filtros Number y Device name.
• Otros motivos de ejecuciones fallidas: "The CUCM connection is not available.", "The result could not be stored.", "The run could not be handed to the worker." y "Internal error. See the worker log for details."
• Una ejecución sin señal de vida se considera fallida a los 5 minutos; una ejecución en espera, a los 60 minutos.