Compartir vía


Registros de Automatización de llamadas de Azure Communication Services

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.

Requisitos previos

Azure Communication Services proporciona características de supervisión y análisis a través de Registros de Azure Monitor y Métricas de Azure Monitor. Cada recurso de Azure necesita su propia configuración de diagnóstico, que establece los siguientes criterios:

  • Categorías de datos de registro y métricas enviados a los destinos que define la configuración. Las categorías disponibles varían según el tipo de recurso.

  • Uno o más destinos para enviar los registros. Los destinos actuales incluyen el área de trabajo de Log Analytics, Azure Event Hubs y Azure Storage.

    Una única configuración de diagnóstico no puede definir más de un tipo de destino. Si quiere enviar datos a más de un tipo de destino (por ejemplo, dos áreas de trabajo de Log Analytics), cree varias configuraciones. Cada recurso puede tener hasta cinco configuraciones de diagnóstico.

Importante

Debe habilitar una configuración de diagnóstico en Azure Monitor para enviar los datos de registro de las encuestas a un área de trabajo de Log Analytics, un centro de eventos o una cuenta de Azure Storage para recibir y analizar los datos de la encuesta. Si no envía datos de Automatización de llamadas a una de estas opciones, los datos de la encuesta no se almacenarán y se perderán.

Las siguientes instrucciones configuran el recurso Azure Monitor para empezar a crear registros y métricas para la instancia de Communication Services. Puede encontrar documentación detallada sobre el uso de la configuración de diagnóstico en todos los recursos de Azure en Habilitación del registro en la configuración de diagnóstico.

En el nombre de configuración de diagnóstico, seleccione Registros de Automatización de llamadas de operación y Registros de resumen de eventos de Automatización de llamadas para habilitar los registros de Automatización de llamadas.

Recorte de pantalla de la configuración de diagnóstico para Automatización de llamadas.

Categorías del registro de recursos

Communication Services ofrece los siguientes tipos de registros que se pueden habilitar:

  • Registros de uso: proporcionan datos de uso asociados a cada oferta de servicio facturada.
  • Registros operativos de automatización de llamadas: proporcione información operativa sobre las solicitudes de la API de Automatización de llamadas. Puede usar estos registros para identificar los puntos de error y consultar todas las solicitudes realizadas en una llamada (mediante el identificador de correlación o el identificador de llamada del servidor).
  • Registros de resumen de medios de Automatización de llamadas: proporcione información sobre el resultado de las operaciones multimedia. Estos registros le llegan de forma asincrónica cuando realiza solicitudes multimedia mediante las API de Automatización de llamadas. Puede usar estos registros para ayudar a identificar puntos de error y posibles patrones sobre cómo interactúan los usuarios con la aplicación.

Esquema del registro de uso

Propiedad Descripción
Timestamp Marca de tiempo (UTC) de cuándo se generó el registro.
OperationName Operación asociada al registro.
OperationVersion El valor api-version asociado a la operación, si la operación OperationName se realizó a través de una API. Si ninguna API se corresponde con esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas con la operación cambien en el futuro.
Category Categoría de registro del evento. La categoría es la granularidad con la que se pueden habilitar o deshabilitar los registros en un recurso. Las propiedades que aparecen en el blob properties de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos.
CorrelationID Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas.
Properties Otros datos aplicables a distintos modos de Communication Services.
RecordID Id. único de un registro de uso.
UsageType Modo de uso (por ejemplo, Chat, RTC o NAT).
UnitType El tipo de unidad en la que se basa el uso para un modo de uso (por ejemplo, minutos, megabytes o mensajes).
Quantity Número de unidades usadas o consumidas en este registro.

Registros operativos de Automatización de llamadas

Propiedad Descripción
TimeGenerated Marca de tiempo (UTC) de cuándo se generó el registro.
OperationName Operación asociada al registro.
CorrelationID El identificador para identificar una llamada y correlacionar eventos para una llamada única.
OperationVersion La versión api-version asociada a la operación, si la operación operationName se realizó a través de una API. Si ninguna API se corresponde con esta operación, la versión representa la versión de esa operación en caso de que las propiedades asociadas con la operación cambien en el futuro.
Category Categoría de registro del evento. La categoría es la granularidad con la que se pueden habilitar o deshabilitar los registros en un recurso. Las propiedades que aparecen en el blob properties de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos.
ResultType Estado de la operación.
ResultSignature El subestado de la operación. Si esta operación se corresponde con una llamada API de REST, este campo es el código de estado HTTP de la llamada REST correspondiente.
DurationMs Duración de la operación en milisegundos.
CallerIpAddress La dirección IP del autor de la llamada, si la operación se corresponde con una llamada API que procede de una entidad con una dirección IP disponible públicamente.
Level Nivel de gravedad del evento.
URI URI de la solicitud.
CallConnectionId El identificador que representa la conexión de llamada, si está disponible. Este identificador es diferente para cada participante y se usa para identificar su conexión a la llamada.
ServerCallId Un identificador único para identificar una llamada.
SDKVersion La versión del SDK que se usa para la solicitud.
SDKType El tipo de SDK que se usa para la solicitud.
SubOperationName El nombre que se usa para identificar el subtipo de operación multimedia (reproducir o reconocer).
operationID El identificador que se usa para correlacionar eventos asincrónicos.

Este es un ejemplo de un registro operativo de Automatización de llamadas:

[
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"OperationName": "Play",
"OperationVersion": "3/6/23",
"URI": "ccts-media-synthetics-prod.communication.azure.com",
"ResultType": "Succeeded",
"ResultSignature": "202",
"DurationMs": "82",
"CallerIpAddress": "40.88.50.228",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"ServerCallId": "aHR0cHM6Ly9hcGkuZmxpZ2h0cHJveHkuc2t5cGUuY29tL2FwaS92Mi9jcC9jb252LXVzZWEyLTAxLmNvbnYuc2t5cGUuY29tL2NvbnYvZzRoWlVoS1ZEVUtma19HenRDZ1JTQT9pPTEyJmU9NjM4MjA1NDc4MDg5MzEzMjIz",
"SdkVersion": "",
"SdkType": "unknown",
"SubOperationName": "File",
"OperationId": "5fab0875-3211-4879-8051-c688d0854c4d",
}

Registros de resumen multimedia de Automatización de llamadas

Propiedad Descripción
TimeGenerated Marca de tiempo (UTC) del evento.
level Nivel de gravedad del evento. Debe ser uno de Informational, Warning, Error o Critical. 
resourceId El identificador del recurso que emitió el evento.
durationMs Duración de la operación en milisegundos.
callerIpAddress
correlationId El identificador de la cadena de Skype. 
operationName Nombre de la operación que representa este evento.
operationVersion
resultType El estado del evento. Entre los valores típicos se incluyen Completed, Canceled y Failed.
resultSignature El subestado de la operación. Si esta operación se corresponde con una llamada API de REST, este campo es el código de estado HTTP de la llamada REST correspondiente.
operationId El identificador de operación que se usa para correlacionar eventos asincrónicos.
recognizePromptSubOperationName Un subtipo de la operación. Los valores posibles incluyen File, TextToSpeech y SSML.
playInLoop True si se solicitó un bucle para la operación de reproducción. False si no.
playToParticipant True si la operación de reproducción tenía un destino. False si era una operación de reproducción a todos.
interrupted True si se interrumpe la solicitud. False si no.
resultCode Código de resultado de la operación.
resultSubcode Subcódigo de resultado de la operación.
resultMessage Mensaje de resultado de la operación.

Este es un ejemplo de un registro de resumen multimedia de Automatización de llamadas:

[
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
"ResultType": "Completed",
"OperationName": "Play",
"OperationId": "7bef24d5-eb95-4ee6-bbab-0b7d45d91288",
"PlayInLoop": "FALSE",
"PlayToParticipant": "TRUE",
"PlayInterrupted": "FALSE",
"RecognizePromptSubOperationName": "",
"ResultCode": "200",
"ResultSubcode": "0",
"ResultMessage": "Action completed successfully."
}

Pasos siguientes