Llamadas de Teams, flujo SIP y capturas

Para qué sirve

Cuando una llamada de Teams no llega, termina demasiado pronto o no tiene audio, necesita la secuencia exacta de los eventos. EasyUC ofrece cuatro herramientas de profundidad creciente: la lista de llamadas en curso, el historial de llamadas con un diagrama de escalera SIP por llamada, el seguimiento SIP de todo el tenant y la captura de red como archivo pcap.

El historial de llamadas almacena, para cada llamada, todos los mensajes SIP entre Microsoft y el SBC de EasyUC, sin los OPTIONS periódicos. El diagrama de escalera los muestra en orden cronológico con flechas. De un vistazo se ve quién dio qué respuesta. Las claves del cifrado de audio se ocultan antes del almacenamiento.

El seguimiento SIP registra además los OPTIONS y todo lo demás del tenant. La captura de red escribe los propios paquetes. El tramo hacia Microsoft va cifrado en ella y no se puede leer; solo se puede leer el tramo interno entre el SBC y EasyUC.

Requisitos previos

Módulo de licencia teams. Sin este módulo no aparece el espacio de trabajo EasyUC Teams.
Rol EasyUC Teams (ROLE_APP_TEAMS_WORKSPACE) con el subpermiso TENANTS (ROLE_APP_TEAMS_TENANTS). Para cambiar de vista y eliminar, además TENANTS bearbeiten (ROLE_APP_TEAMS_TENANTS_EDIT).
Para el flujo SIP de llamadas pasadas: Save the SIP flow of every call estaba activado en el momento de la llamada y el periodo de conservación no ha caducado.
Para la captura de red: el servicio SBC está en ejecución y se registra. En el SBC pueden ejecutarse como máximo dos capturas de red al mismo tiempo.
Un programa como Wireshark para analizar un archivo pcap.

Paso a paso: examinar una llamada en el historial de llamadas

Abra Teams Tenants, haga clic en el tenant y seleccione Call history en la barra del tenant. La página se abre filtrada para este tenant.
Acote el periodo con Date from y Date to.
En Direction, elija inbound u outbound.
En Search, escriba el número, el número marcado, el Call-ID o el UUID y confirme con el botón de la lupa.
Haga clic en la fila de la llamada. Se abre la página SIP flow.
Lea el encabezado: Tenant, Direction, From, To, en su caso Pilot, State, Codec, Remote IP, Start, Duration y SIP Call-ID.
Lea el diagrama de escalera de arriba abajo. Microsoft está a la izquierda y el SBC de EasyUC a la derecha. Los mensajes con SDP llevan la etiqueta SDP.
Haga clic en un mensaje para ver su contenido. Las teclas de flecha mueven la selección. Copy coloca el texto en el portapapeles.
Haga clic en Download SIP flow (.txt) si desea transmitir la secuencia.

Paso a paso: observar las llamadas en curso

Seleccione Show calls en la barra del tenant. El número del elemento de menú es el número de llamadas en curso.
De cada llamada, lea Direction, From, To, State, Codec, Remote, Duration y Call-ID.
Haga clic en una fila. Se abre el flujo SIP y se actualiza cada 2 segundos mientras la llamada está en curso.
Si indica “No call running through this trunk right now.”, realice la llamada de prueba y espere un momento.

Paso a paso: registrar un seguimiento SIP del tenant

En el encabezado de la página del tenant, haga clic en Start SIP trace. Aparece el aviso SIP trace is running con la hora de finalización. El seguimiento termina por sí solo a los 30 minutos.
Realice la llamada de prueba.
Seleccione SIP log en la barra del tenant.
En Filter, escriba, por ejemplo, INVITE, un número o un Call-ID.
Haga clic en una entrada para expandir el mensaje completo.
Haga clic en Download log para obtener un archivo de texto o en Export pcap (TranslatorX/Wireshark) para obtener un archivo pcap. Si el filtro se limita a un Call-ID, el archivo pcap contiene solo esa llamada.
Haga clic en Stop SIP trace en el encabezado cuando termine. Clear elimina el registro del tenant.

Paso a paso: registrar una captura de red (pcap)

Seleccione Captures en la barra del tenant.
En Capture for, elija la duración: 5, 10, 15, 30 o 60 minutos.
En At most, elija el tamaño del archivo: 50, 100, 200 o 500 MB.
Marque Include the internal leg to EasyUC solo si necesita SIP y audio en texto claro. Lea la advertencia: el archivo contiene entonces las llamadas de todos los tenants de este SBC.
Haga clic en Start network capture y confirme el aviso si aparece.
Espere a Network capture is running y realice la llamada de prueba.
Haga clic en Stop network capture o espere al final.
El archivo aparece en la lista en cuanto el SBC lo ha transferido. Hasta entonces muestra Being transferred.
Haga clic en el icono de descarga de la fila. El icono de la papelera elimina el archivo.

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Last OPTIONS	Hora del último SIP OPTIONS de Microsoft en este tenant. Se muestra en el encabezado de la página del tenant.
To	El número marcado. Con Operator Connect mediante reenvío de Teams, es el número de Operator Connect; el número piloto se muestra debajo como adición “via pilot …”.
State	Estado de la llamada. Las llamadas en curso llevan la etiqueta Live en el historial.
SIP messages	Número de mensajes SIP almacenados para esta llamada. 0 significa: el flujo SIP estaba desactivado o ya se ha eliminado.
Start SIP trace / Stop SIP trace	Escribe en la base de datos cada mensaje SIP de este tenant, incluidos los OPTIONS. Se ejecuta durante 30 minutos. El registro conserva como máximo los 20 000 mensajes más recientes por tenant.
Start network capture / Stop network capture	Escribe en un archivo pcap los puertos SIP y RTP de este tenant y las conexiones TLS de todos los tenants hacia Microsoft. Duración de 1 a 60 minutos, tamaño de 1 a 500 MB, por defecto 15 minutos y 200 MB.
Include the internal leg to EasyUC	Registra además el tramo sin cifrar entre el SBC y EasyUC. Solo con esta opción se pueden leer SIP y audio en Wireshark.
Storage used	Almacenamiento de las grabaciones y capturas de este tenant, limitado a 1 GB. Junto a él, el almacenamiento compartido de todos los tenants.
Capture list	Started, Finished, Duration, File size, Packets. Las capturas se eliminan automáticamente a los 7 días.
Call history: búsqueda y filtros	La búsqueda encuentra llamante, destino, número marcado, Call-ID y UUID. Además, Date from, Date to y Direction. Las llamadas más recientes están arriba.
Save the SIP flow of every call	Conmutador en los ajustes del tenant, activado por defecto. Se almacenan todos los mensajes SIP de una llamada entre Microsoft y el SBC, sin los OPTIONS.
Keep call history (days)	De 1 a 365 días, por defecto 14. Las llamadas más antiguas y sus mensajes SIP se eliminan.
Diagrama de escalera: estructura	A la izquierda la hora con milisegundos, después el carril Microsoft con la dirección del interlocutor y a la derecha el carril EasyUC SBC. Una flecha hacia la derecha procede de Microsoft; una flecha hacia la izquierda va a Microsoft. Las respuestas llevan código y texto, por ejemplo `200 OK`.
Download SIP flow (.txt)	Archivo de texto con todos los mensajes de la llamada. Si el número marcado difiere del destino, el archivo indica ambos.
No incluido	El tramo interno entre el SBC y el entorno de ejecución de scripts de EasyUC no se registra en el historial de llamadas. Utilice para ello la captura de red con el tramo interno.
Claves	Las claves SRTP se ocultan antes del almacenamiento, tanto en el historial de llamadas como en el registro SIP.

Comprobar el resultado y acotar errores

Éxito: la llamada de prueba está en el historial de llamadas y el diagrama de escalera muestra INVITE, 200 OK y BYE.
La llamada no figura en el historial de llamadas: Teams no la envió por el trunk de EasyUC. Compruebe si la política de EasyUC está asignada a quien llama, si el número figura como Reachable en Scripts over this trunk y si Routes in Teams muestra Up to date.
“SIP flow recording is off for this tenant” Active Save the SIP flow of every call en los ajustes del tenant. Se almacenan las llamadas que comiencen después.
“No SIP messages were stored for this call.” El flujo estaba desactivado durante la llamada o se ha eliminado tras el periodo de conservación.
Sin audio o con audio en un solo sentido: compruebe Public IP y Media IP en la página del SBC y la regla UDP para el rango RTP. Unos OPTIONS correctos solo demuestran la vía de señalización.
La llamada termina unos 10 segundos después de ser contestada, sin audio: el entorno de ejecución de scripts no entrega audio al SBC. Compruebe que el script está habilitado y que el servicio de ejecución de scripts está en funcionamiento.
Teams indica de inmediato una llamada fallida a un número de script: el script es desconocido, está desactivado o no está Reachable via MS Teams, o el entorno de ejecución de scripts no responde.
“The SBC has not confirmed the network capture yet.” o “Network capture not available: …” El servicio SBC no se registra o el componente de captura no está en ejecución. Compruebe el servicio en EasyUC Manager.
„Es laufen bereits 2 Netzwerk-Mitschnitte auf anderen Tenants. Bitte einen davon beenden oder sein Ende abwarten.“ Detenga una de las capturas en curso.
“The SIP trace is off. Turn it on above to record what goes over this trunk.” El registro SIP está vacío mientras no se haya ejecutado ningún seguimiento.
Las capturas contienen números de teléfono y, con el tramo interno, el contenido de las llamadas. Transmítalas únicamente al destinatario previsto.
Una llamada en curso se considera terminada cuando el SBC no la ha notificado durante dos minutos. Hasta entonces lleva la etiqueta Live.
Con Operator Connect mediante reenvío de Teams, el INVITE del diagrama de escalera muestra la cabecera History-Info con el número de Operator Connect. Por eso, el historial de llamadas almacena también el nombre de inicio de sesión de la cuenta de servicio de reenvío. Está sujeto al mismo periodo de conservación.
Lea el flujo como en el capítulo sobre el diagrama de escalera SIP: primer INVITE, última respuesta a este, BYE. Una respuesta roja del SBC indica el motivo en el lado de EasyUC; una respuesta roja de Microsoft, el motivo en el tenant.