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.
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. |
ParticipantId |
El identificador para identificar al participante de la llamada que realizó 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": "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, 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": "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
- Obtenga información sobre el panel de información para supervisar los registros y las métricas de Automatización de llamadas.