Compartir vía

Llamada al esquema de registro de series temporales de estadísticas multimedia de cliente

  • Artículo

El registro de llamar a la serie temporal de estadísticas de medios de cliente proporciona información del lado cliente sobre las secuencias multimedia entre los participantes individuales implicados en una llamada. Estos registros se encuentran actualmente en versión preliminar limitada y proporcionan datos detallados de series temporales sobre las secuencias multimedia de audio, vídeo y recursos compartidos de pantalla entre los participantes con un intervalo de agregación predeterminado de 10 segundos. Los registros contienen información de serie temporal pormenorizada sobre el tipo de secuencia multimedia, la dirección, el códec y las propiedades de velocidad de bits (por ejemplo, max, min, average).

Este registro proporciona información más detallada que el registro de diagnóstico de llamadas para comprender la calidad de los flujos multimedia entre los participantes. Se puede usar para visualizar e investigar problemas de calidad de las llamadas mediante el diagnóstico de llamadas para el recurso de Azure Communication Services. Más información sobre los diagnósticos de llamadas

Procedimiento para usar 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 su calidad, 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.

Conceptos de datos

Importante

Debe recopilar registros si quiere analizarlos. Para más información, vea: ¿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.

Definiciones de datos

Llamada al esquema de registro de series temporales de estadísticas multimedia de cliente

En esta tabla se describe cada una de las propiedades.

Propiedad Descripción
OperationName Operación asociada al registro.
CallId El id. único de una llamada. Identifica los eventos correlacionados de todos los participantes y puntos de conexión que se conectan durante una sola llamada. Puede usarlo para combinar datos de distintos registros. Es similar al valor correlationId en el registro de resumen de la llamada y el registro de diagnósticos de llamadas.
CallClientTimeStamp Marca de tiempo cuando se graban las estadísticas multimedia.
MetricName Nombre de las estadísticas multimedia, como Bitrate, JitterInMs, PacketsPerSecond, etc.
Count Número de puntos de datos muestreados en una marca de tiempo determinada.
Sum Suma de los valores de métrica de todos los puntos de datos muestreados.
Average Valor medio de métrica de los puntos de datos muestreados. Media = Suma / Recuento.
Minimum El mínimo de valores de métrica de todos los puntos de datos muestreados.
Maximum El máximo de valores de métrica de todos los puntos de datos muestreados.
MediaStreamDirection Dirección de la secuencia multimedia. Puede ser sendoreceive.
MediaStreamType Tipo de la secuencia de medios. Puede ser video, audio o screen.
MediaStreamCodec Códec usado para codificar o descodificar la secuencia multimedia, como H264OPUSVP8, etc.
ParticipantId Identificador único que se genera para representar cada punto de conexión de la llamada.
ClientInstanceId Identificador único que representa el objeto Call Client creado en el SDK que realiza la llamada.
EndpointId Identificador único que representa cada punto de conexión que está conectado a la llamada. EndpointId puede persistir para el mismo usuario en varias llamadas (callIds) para clientes nativos, pero es único para cada llamada cuando el cliente es un explorador web. EndpointId no se instrumenta actualmente en este registro. Cuando se implementa, coincide con los valores de los registros CallSummary/Diagnostics.
RemoteParticipantId Identificador único que representa el punto de conexión remoto en la secuencia de medios. Por ejemplo, un usuario puede representar varias secuencias de vídeo para los demás usuarios en la misma llamada. Cada secuencia de vídeo tiene un valor RemoteParticipantId diferente.
RemoteEndpointId Igual que EndpointId, pero representa al usuario en el lado remoto de la secuencia.
MediaStreamId Identificador único que representa cada secuencia multimedia de la llamada. MediaStreamId no se instrumenta actualmente en los clientes. Cuando se implementa, coincide con la columna streamId de los registros CallDiagnostics.
AggregationIntervalSeconds Intervalo de tiempo para agregar las estadísticas multimedia. Actualmente en el SDK de llamada, las métricas multimedia se muestran cada 1 segundo y, cuando se notifican en el registro, se agregan todas las muestras cada 10 segundos. Por lo tanto, cada fila de esta tabla tiene como máximo 10 puntos de muestreo.

Datos de ejemplo para varios tipos de llamadas

Registros de estadísticas multimedia de cliente de llamadas para llamadas de grupo y P2P

En el caso del registro de series temporales de estadísticas multimedia de cliente de llamadas, no hay ninguna diferencia entre los escenarios de llamadas de grupo y P2P. El número de registros depende de las operaciones del SDK y la duración de la llamada. El código siguiente es un ejemplo genérico que muestra el esquema de estos registros.

Llamada al registro de series temporales de estadísticas multimedia de cliente

A continuación se muestra un ejemplo del registro de series temporales de estadísticas multimedia. Muestra la métrica Jitter del participante para recibir una secuencia de audio en una marca de tiempo específica.

"properties": {
    "TenantId":                     "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":                "2024-01-10T07:36:51.771Z",
    "OperationName":                "CallClientMediaStatsTimeSeries" ,  
    "CallId":                       "92d800c4-abde-40be-91e9-3814ee786b19", 
    "CallClientTimeStamp":          "2024-01-09T15:07:56.066Z",
    "MetricName":                   "JitterInMs",
    "Count":                        "2",
    "Sum":                          "34",
    "Average":                      "17",
    "Minimum":                      "10",
    "Maximum":                      "25",
    "MediaStreamDirection":         "recv",
    "MediaStreamType":              "audio",
    "MediaStreamCodec":             "OPUS",
    "ParticipantId":                "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
     "ClientInstanceId":            "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "AggregationIntervalSeconds":   "10",
    "Type":                         "ACSCallClientMediaStatsTimeSeries"
}

Cada participante puede tener muchas métricas de estadísticas multimedia diferentes para una llamada. La consulta siguiente se puede ejecutar en Log Analytics en Azure Portal para mostrar todas las métricas posibles en este registro:

ACSCallClientMediaStatsTimeSeries | distinct MetricName

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 que inicialmente recopile 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