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.
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 , Error o 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 , Canceled y 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 , 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 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
- Obtenga información sobre el panel de información para supervisar las métricas y los registros de Automatización de llamadas.