Compartir vía

Introducción a los registros de llamadas de Azure Communication Services

  • Artículo

Azure Communication Services ofrece funcionalidades de registro que sirven para supervisar y depurar la solución de Communication Services. Estas funcionalidades se configuran a través de Azure Portal.

El contenido de este artículo hace referencia a los registros habilitados a través de Azure Monitor (consulte también preguntas más frecuentes). Para habilitar estos registros para Communication Services, consulte Habilitación del registro en Configuración de diagnósticos.

Importante

Debe recopilar registros si quiere analizarlos. Para más información, consulte: ¿Cómo almaceno los registros?

Azure no almacena los datos del registro de llamadas hasta que habilite esta configuración de diagnóstico específica. Los datos de las llamadas no están disponibles de forma retroactiva. Los datos se acumulan una vez que se crea la configuración de diagnóstico.

Uso de los registros de llamadas

Se recomienda recopilar todos los registros de llamadas disponibles en un recurso de Log Analytics para que pueda supervisar el uso de las llamadas y mejorar la calidad de las llamadas y recibir nuevos registros de Azure Communication Services a medida que los publicamos.

Hay dos herramientas que son las que más se usan para supervisar las llamadas y mejorar su calidad.

Le recomendamos usar los paneles de información de voz y vídeo para iniciar cualquier investigación de calidad, así como usar diagnóstico de llamadas, siempre que sea necesario, para explorar llamadas individuales cuando se necesite un mayor nivel de detalle.

Registros disponibles

Azure Communication Services crea ocho registros de llamadas:

Registros de actualizaciones de resumen de llamadas:

Estos datos de registro llegan a Azure Monitor más rápido que los registros de resumen de llamadas y se recomienda usar estos registros en lugar del esquema del registro de resumen de llamadas. Este registro contiene información básica sobre la llamada, incluidos todos los identificadores pertinentes, las marcas de tiempo, los puntos de conexión y la información del SDK.

Para más información, consulte Esquema de los registros de actualizaciones de resumen de llamadas.

Registros de resumen de llamadas:

Este registro es un subconjunto del esquema de registro de actualizaciones de resumen de llamadas. Contiene información básica sobre la llamada, incluidos todos los identificadores pertinentes, las marcas de tiempo, los puntos de conexión y la información del SDK. Para una latencia de registro más rápida, utilice en su lugar los registros de actualizaciones de resumen de llamadas.

Para más información, consulte Esquema de los registros de resumen de llamadas.

Registros de actualizaciones de diagnósticos de llamadas:

Estos datos de registro llegan a Azure Monitor más rápido que los registros de diagnósticos de llamadas y se recomienda usar estos registros en lugar del esquema del registro de diagnóstico de llamadas. Estos registros contienen información sobre la secuencia de elementos multimedia de la llamada de un participante, así como un conjunto de métricas que indican las medidas de calidad de la experiencia.

Para más información, consulte Esquema de los registros de actualizaciones de diagnósticos de llamadas.

Registros de diagnósticos de llamadas:

Este registro es un subconjunto del esquema de registro de actualizaciones de diagnósticos de llamadas. Contiene información sobre la secuencia, así como un conjunto de métricas que indican las medidas de calidad de la experiencia. Para una latencia de registro más rápida, utilice en su lugar los registros de actualizaciones de resumen de llamadas.

Para más información, consulte Esquema de los registros de diagnósticos de llamadas.

Registros de operaciones de cliente de llamadas:

Contienen eventos de cliente de llamadas detallados. Estos eventos de registro se generan para cada EndpointId en una llamada y el número de registros de eventos generados dependerá de las operaciones que el participante haya realizado durante la llamada.

Para más información, consulte Esquema de registro de operaciones de cliente de llamadas.

Registros de estadísticas de elementos multimedia de cliente de llamadas:

Contienen valores detallados de la secuencia de elementos multimedia. Estos registros se generan para cada secuencia multimedia en una llamada. Para cada EndpointId dentro de una llamada (incluido el servidor), Azure Communication Services crea un registro distinto para cada secuencia de medios (audio o vídeo, por ejemplo) entre puntos de conexión. El volumen de datos generados en cada registro depende de la duración de la llamada y del número de vapores multimedia de la llamada.

En una llamada P2P, cada registro contiene datos relacionados con cada una de las secuencias salientes asociadas a cada punto de conexión. En una llamada de grupo, cada secuencia asociada a endpointType = "Server" crea un registro que contiene datos para las secuencias entrantes. Todas las demás secuencias crean registros que contienen datos para las secuencias salientes de todos los puntos de conexión que no son de servidor. En las llamadas de grupo, use el valor participantId como clave para unir los registros entrantes y salientes relacionados a una conexión de participante distinta.

Para más información, consulte: Esquema del registro de series temporales de las estadísticas multimedia del cliente de llamadas.

Registros de encuesta de final de llamada:

Estos registros se rellenan cuando el cliente de llamada web envía una encuesta al final de la llamada. Puede usar estos registros para conocer la percepción subjetiva de la calidad de las llamadas de los usuarios.

Para más información, consulte Información general sobre la encuesta de final de llamadas.

Registros de métricas de llamadas:

Estos registros contienen métricas agregadas en contenedores diarios basadas en atributos como la versión del SDK, el nombre del sistema operativo y el subcódigo de error. Estos registros se usan en el panel de información sobre voz y vídeo para visualizar gráficos a largo plazo de confiabilidad, calidad y rendimiento en función del número de llamadas correctas y erróneas de la API del SDK de llamadas en varias operaciones.

Para más información, consulte Esquema de los registros de métricas de llamadas.

Conceptos de datos

Las siguientes descripciones generales de los conceptos de datos son específicas de las llamadas de voz y videollamadas. Estos conceptos son importantes para revisar para que pueda comprender el significado de los datos capturados en los registros.

Entidades e id.

Familiarícese con los siguientes términos:

  • Llamada: como se representa en los datos, una llamada es una abstracción representada por correlationId. Los valores de correlationId son únicos para cada llamada y están limitados por el tiempo en función de callStartTime y callDuration.

  • Participante: representa la conexión entre un punto de conexión y el servidor. Un participante (participantId) solo está presente cuando la llamada es una llamada de grupo.

  • Punto de conexión: es la entidad más única, representada por endpointId. Cada llamada es un evento que contiene datos de dos o más puntos de conexión. Los puntos de conexión representan a los participantes en la llamada.

    EndpointType indica si el punto de conexión es un usuario humano (RTC, VoIP), un bot o el servidor que administra varios participantes dentro de una llamada. Cuando un valor endpointType es "Server", el punto de conexión no tiene asignado un identificador único. Puede analizar endpointType y el número de valores endpointId para determinar cuántos usuarios y otros participantes no humanos (bots y servidores) se unen a una llamada.

    Los SDK nativos para Android e iOS reutilizan el mismo valor endpointId para un usuario en varias llamadas, por lo que puede comprender las experiencias entre sesiones. Este proceso difiere de los puntos de conexión basados en web, que siempre generan un nuevo valor endpointId para cada nueva llamada.

  • Stream: la entidad más granular. Hay una secuencia para cada dirección (entrante o saliente) y el valor mediaType (por ejemplo, Audio o Video).

P2P frente a llamadas grupales

Nota:

En este artículo, las llamadas de grupo y P2P se encuentran dentro del mismo inquilino, de forma predeterminada. Todos los escenarios de llamada entre inquilinos se especifican a lo largo del artículo.

Hay dos tipos de llamadas, como se representa mediante callType:

  • Llamadas punto a punto (P2P): una conexión entre solo dos puntos de conexión, sin ningún punto de conexión de servidor. Las llamadas P2P se inician como una llamada entre esos puntos de conexión y no se crean como un evento de llamada grupal antes de la conexión.

    Diagrama que muestra una llamada P2P entre dos puntos de conexión.

  • Llamada grupal: cualquier llamada que tenga más de dos puntos de conexión conectados. Las llamadas grupales incluyen un punto de conexión de servidor, la conexión entre cada punto de conexión y el servidor. Las llamadas P2P que agregan otro punto de conexión durante la llamada dejan de ser P2P y se convierten en una llamada grupal. Puede determinar la escala de tiempo de cuándo cada punto de conexión se unió a la llamada mediante las métricas participantStartTime y participantDuration.

    Diagrama que muestra una llamada grupal entre varios puntos de conexión.

Ejemplos de diversos tipos de llamadas

Nota:

En este artículo, las llamadas de grupo y P2P se encuentran dentro del mismo inquilino, de forma predeterminada. Todos los escenarios de llamada entre inquilinos se especifican a lo largo del artículo.

Ejemplo: llamada P2P

El diagrama siguiente representa dos puntos de conexión conectados directamente en una llamada P2P. En este ejemplo, Communication Services crea dos registros de resumen de llamadas (uno para cada valor participantID) y cuatro registros de diagnóstico de llamadas (uno para cada secuencia de elementos multimedia).

En el caso de los participantes del cliente de llamadas de Azure Communication Services (ACS), también hay una serie de registros de operaciones de cliente de llamadas y registros de series temporales de estadísticas multimedia de cliente. El número exacto de estos registros depende del tipo de operaciones del SDK que se llaman y de la duración de la llamada.

Diagrama que muestra una llamada P2P dentro del mismo inquilino.

Ejemplo: llamada grupal

El siguiente diagrama representa un ejemplo de llamada grupal con tres valores participantId (lo que significa tres participantes) y un punto de conexión de servidor. Varios valores de endpointId pueden aparecer potencialmente en varios participantes, por ejemplo, cuando vuelven a unirse a una llamada desde el mismo dispositivo. Communication Services crea un registro de resumen de llamadas para cada valor participantId. Crea cuatro registros de diagnóstico de llamadas: uno para cada secuencia de elementos multimedia por participantId.

En el caso de los participantes del cliente de llamadas de Azure Communication Services (ACS), los registros de operaciones de cliente de llamada son los mismos que las llamadas P2P. Para cada participante que use el SDK de llamada, habrá una serie de registros de operaciones del cliente de llamadas.

En el caso de los participantes del cliente de llamadas de Azure Communication Services (ACS), los registros de operaciones del cliente de llamadas y los registros de series temporales de estadísticas multimedia del cliente son los mismos que en las llamadas P2P. Para cada participante que use el SDK de llamada, habrá una serie de registros de operaciones del cliente de llamadas y registros de series temporales de estadísticas multimedia del cliente.

Diagrama que muestra una llamada grupal dentro del mismo inquilino.

Ejemplo: llamada P2P entre inquilinos

En el diagrama siguiente, se representan dos participantes entre varios inquilinos que están conectados directamente en una llamada P2P. En este ejemplo, Communication Services crea un registro de resumen de llamadas (uno para cada participante) con versiones redactadas del sistema operativo y del SDK. Communication Services también crea cuatro registros de diagnóstico de llamadas (uno para cada secuencia de elementos multimedia). Cada registro contiene datos relacionados con el flujo de salida de participantID.

Diagrama que muestra una llamada P2P entre inquilinos.

Ejemplo: llamada grupal entre inquilinos

En el diagrama siguiente, se representa un ejemplo de llamada grupal con tres valores participantId en varios inquilinos. Communication Services crea un registro de resumen de llamadas para cada participante con versiones redactadas del SO y del SDK. Communication Services también crea cuatro registros de diagnóstico de llamadas relacionados con cada valor participantId (uno para cada secuencia de elementos multimedia).

Diagrama que muestra una llamada grupal entre inquilinos.

Nota:

Esta versión solo admite registros de diagnóstico de salida. Las versiones del SO y del SDK asociadas al bot y el participante se pueden censurar porque Communication Services trata las identidades de los participantes y bots de la misma manera.

Preguntas más frecuentes

¿Cómo almaceno los registros?

En la siguiente sección se explica este requisito.

Los registros de Azure Communication Services no se almacenan de manera predeterminada en la cuenta de Azure, por lo que debe empezar a almacenarlos para que herramientas como el panel de información de voz y vídeo y los diagnósticos de llamadas puedan funcionar. Para recopilar estos registros de llamadas, debe habilitar una configuración de diagnóstico que dirija los datos de las llamadas a un área de trabajo de Log Analytics.

Los datos no se almacenan de forma retroactiva, por lo que no comenzará a capturar registros de llamadas hasta que se configure el diagnóstico.

Siga las instrucciones para agregar la configuración de diagnóstico del recurso en Habilitar registros a través de la configuración de diagnóstico en Azure Monitor. Le recomendamos, en un incio, recopilar todos los registros. Después de comprender las funcionalidades de Azure Monitor, determine qué registros desea conservar y durante cuánto tiempo. Al agregar la configuración de diagnóstico, se le pedirá que seleccione registros. Para recopilar todos los registros, seleccione allLogs.

El volumen, la retención y el uso de datos en Log Analytics dentro de Azure Monitor se factura a través de medidores de datos de Azure existentes. Se recomienda que supervise las directivas de uso y retención de datos por razones de costes según sea necesario. Para obtener más información, consulte Control de costos.

Si tiene varios identificadores de recursos de Azure Communications Services, debe habilitar esta configuración para cada identificador de recurso.

Pasos siguientes