Esquema de registro de operaciones de cliente de llamadas

El registro de operaciones de cliente de llamadas proporciona información del lado del cliente sobre los puntos de conexión de llamada y los participantes implicados en una llamada. Actualmente, estos registros se encuentran en versión preliminar y muestran los eventos de cliente que se produjeron en una llamada y qué acciones puede haber realizado un cliente durante una llamada.

Este registro proporciona información detallada sobre las acciones realizadas durante una llamada y se puede usar para visualizar e investigar problemas de llamadas mediante diagnósticos de llamadas para el recurso de Azure Communication Services. Más información sobre los diagnósticos de llamadas

Cómo usar 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 conclusiones 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, 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.

Definiciones de datos

Esquema de registro de operaciones de cliente de llamadas

En esta tabla se describe cada una de las propiedades.

Propiedad Descripción
CallClientTimeStamp La marca de tiempo de cuándo se produjo una operación en el SDK en UTC.
OperationName El nombre de la operación desencadenada en el SDK de llamada.
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 a correlationId en el registro de resumen de la llamada y el registro de diagnósticos de llamadas.
ParticipantId El identificador único de cada segmento de llamada (en llamadas de grupo) o participante de llamada (en llamadas punto a punto). Este id. es el punto de correlación principal entre los registros CallSummary, CallDiagnostic, CallClientOperations y CallClientMediaStats.
OperationType Llame a la operación de cliente.
OperationId Un GGUID único que identifica una operación del SDK.
DurationMs El tiempo que tarda una operación del SDK de llamada para producir un error o realizarse correctamente.
ResultType Campo que describe el éxito o el error de una operación.
ResultSignature Código de error o éxito similar a HTTP (200, 500).
SdkVersion Versión del SDK de llamada que se está usando.
UserAgent Se usa la cadena de agente de usuario estándar basada en el explorador o en el SDK de llamada de la plataforma.
ClientInstanceId Un GGUID único que identifica el objeto CallClient.
EndpointId Id. único que representa cada punto de conexión conectado a la llamada, donde endpointType se define mediante el tipo de punto de conexión. Cuando el valor es nulo, la entidad conectada es el servidor de Communication Services (endpointType = "Server").

El valor endpointId a veces puede persistir para el mismo usuario en varias llamadas (correlationId) para clientes nativos. El número de valores endpointId determina el número de registros de resumen de llamadas. Se crea un registro de resumen distinto para cada valor endpointId.
OperationPayload Una carga dinámica que varía en función de la operación, lo que proporciona detalles más específicos de la operación.

Datos de ejemplo para varios tipos de llamadas

Llamada al registro de operaciones de cliente

Este es un registro de operaciones de cliente de llamada para la operación "CreateView":

"properties": {
    "TenantId":               "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":          "2024-01-09T17:06:50.3Z",
    "CallClientTimeStamp":    "2024-01-09T15:07:56.066Z",
    "OperationName":          "CreateView" ,   
    "CallId":                 "92d800c4-abde-40be-91e9-3814ee786b19",
    "ParticipantId":          "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
    "OperationType":          "client-api-request",
    "OperationId":            "0d987336-37e0-4acc-aba3-e48741d88103",
    "DurationMs":             "577",
    "ResultType":             "Succeeded",
    "ResultSignature":        "200",
    "SdkVersion":             "1.19.2.2_beta",
    "UserAgent":              "azure-communication-services/1.3.1-beta.1 azsdk-js-communication-calling/1.19.2-beta.2 (javascript_calling_sdk;#clientTag:904f667c-5f25-4729-9ee8-6968b0eaa40b). Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "ClientInstanceId":       "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "OperationPayload":       "{"StreamType":"Video","StreamId":"2.0","Source":"remote","RemoteParticipantId":"remote"}",
    "Type":                   "ACSCallClientOperations"
}

Cada participante puede tener muchas métricas diferentes para una llamada. La consulta siguiente se puede ejecutar en Log Analytics en Azure Portal para enumerar todas las operaciones posibles en el registro de operaciones del cliente de llamadas:

ACSCallClientOperations | distinct OperationName

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 en su cuenta de Azure de forma predeterminada, 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 inicio, 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

  • Last updated on