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 mediante 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. Entre los destinos actuales se 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 uno de cada tipo de destino. Si desea enviar datos a más de un tipo de destino (por ejemplo, dos áreas de trabajo de Log Analytics), cree varias opciones de configuración. 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 Almacenamiento de Azure 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 instrucciones siguientes configuran el recurso de Azure Monitor para empezar a crear registros y métricas para la instancia de Communication Services. Para obtener documentación detallada sobre el uso de la configuración de diagnóstico en todos los recursos de Azure, consulte Habilitación del registro en la configuración de diagnóstico.

En el nombre de la 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.

Screenshot of diagnostic settings for Call Automation.

Categorías del registro de recursos

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

  • Registros de uso: proporcione los datos de uso asociados a cada oferta de servicio facturado.
  • 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 multimedia 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 patrones posibles 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 cuando se generó el registro.
OperationName Operación asociada al registro.
OperationVersion Valor api-version asociado a la operación, si la OperationName operación se realizó a través de una API. Si ninguna API corresponde a esta operación, la versión representa la versión de la operación, en caso de que las propiedades asociadas a la operación cambien en el futuro.
Category Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso. Las propiedades que aparecen dentro del properties blob de un evento son las mismas dentro de una categoría de registro y un tipo de recurso.
CorrelationID Identificador de los eventos correlacionados. Puede usarlo para identificar eventos correlacionados entre varias tablas.
Properties Otros datos aplicables a varios modos de Communication Services.
RecordID Identificador ú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 cuando se generó el registro.
OperationName Operación asociada al registro.
CorrelationID Identificador para identificar una llamada y correlacionar eventos para una llamada única.
OperationVersion Versión api-version asociada a la operación, si la operationName operación se realizó a través de una API. Si ninguna API corresponde a esta operación, la versión representa la versión de la operación, en caso de que las propiedades asociadas a la operación cambien en el futuro.
Category Categoría de registro del evento. La categoría es la granularidad en la que puede habilitar o deshabilitar los registros en un recurso. Las propiedades que aparecen dentro del properties blob de un evento son las mismas dentro de una categoría de registro y un tipo de recurso.
ResultType Estado de la operación.
ResultSignature 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 corresponde a 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 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 Identificador único para identificar una llamada.
SDKVersion La versión del SDK que se usa para la solicitud.
SDKType Tipo de SDK que se usa para la solicitud.
ParticipantId Identificador para identificar al participante de la llamada que realizó la solicitud.
SubOperationName Nombre que se usa para identificar el subtipo de operación multimedia (reproducir o reconocer).
operationID 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": "e2a97d52-0cbb-4adf-8c4b-e10f791fb764",
"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, Erroro Critical. 
resourceId Identificador del recurso que emitió el evento.
durationMs Duración de la operación en milisegundos.
callerIpAddress
correlationId Identificador de la cadena de Skype. 
operationName Nombre de la operación que representa este evento.
operationVersion
resultType Estado del evento. Entre los valores típicos se incluyen Completed, Canceledy Failed.
resultSignature 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 Identificador de operación que se usa para correlacionar eventos asincrónicos.
recognizePromptSubOperationName Subtipo de la operación. Los valores potenciales incluyen File, TextToSpeechy 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 todo.
interrupted True si se interrumpe el mensaje. 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": "d149d528-a392-404c-8fcd-69087e9d0802",
"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