Azure Communication Services: registros de SMS

Artículo
04/18/2023

Azure Communication Services ofrece funcionalidades de registro que sirven para supervisar y depurar la solución de Communication Services. Estas funcionalidades pueden configurarse mediante Azure Portal.

Importante

A continuación se hace referencia a los registros habilitados mediante Azure Monitor (consulte también las preguntas más frecuentes). Para habilitar estos registros para Communications Services, consulte Habilitación del registro en Configuración de diagnósticos.

Requisitos previos

Azure Communications Services proporciona características de supervisión y análisis a través de Información general 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 los datos de los registros y las métricas que se envían a los destinos definidos en la configuración. Las categorías disponibles varían para los distintos tipos de recursos.
Uno o más destinos para enviar los registros. Los destinos actuales incluyen el área de trabajo de Log Analytics, Event Hubs y Azure Storage.
Cada configuración de diagnóstico puede definir un único destino. Si desea enviar datos a más de un tipo de destino determinado (por ejemplo, dos áreas de trabajo de Log Analytics diferentes), cree varias configuraciones. Cada recurso puede tener hasta cinco configuraciones de diagnóstico.

A continuación, se indican instrucciones para configurar el recurso Azure Monitor para empezar a crear registros y métricas para Communication Services. Puede encontrar documentación detallada sobre el uso de Configuración de diagnóstico en todos los recursos de Azure en Habilitación del registro en Configuración de diagnóstico

Nota:

En nombre de configuración de diagnóstico, seleccione "SMS operativos" para habilitar los registros para SMS.

Información general

Los registros operativos de SMS son registros de eventos y actividades que proporcionan información sobre las solicitudes de la API de SMS. Capturaron detalles sobre el rendimiento y la funcionalidad del primitivo SMS, incluidos los detalles sobre el estado del mensaje si se entregaron, bloquearon correctamente o no se pudieron enviar. Los registros operativos de SMS contienen información que ayuda a identificar tendencias y patrones, resolver problemas que podrían afectar al rendimiento, como las entregas de mensajes con error o atender problemas. Los registros incluyen los siguientes detalles:

Mensajes enviados.
Mensaje recibido.
Mensajes entregados.
Participación y rechazo de mensajes.

Categorías del registro de recursos

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

Usage logs (Registros de uso): proporciona datos de uso asociados a cada oferta de servicio facturada.
SMS operational logs (Registros operativos de SMS): proporciona información básica relacionada con el servicio de SMS.

Esquema de los registros de uso

Propiedad	Descripción
`Timestamp`	Marca de tiempo (UTC) de cuando se generó el registro.
`Operation Name`	Operación asociada al registro.
`Operation Version`	`api-version` asociada con la operación, si operationName se ha realizado mediante una API. Si no hay ninguna API que corresponda a 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 determinado. Las propiedades que aparecen en el blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso concretos.
`Correlation ID`	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.
`Record ID`	Identificador único de un registro de uso determinado.
`Usage Type`	Modo de uso. (Por ejemplo, chat, RTC, NAT, etc.).
`Unit Type`	Tipo de unidad que se emplea para el uso en un modo determinado. (Por ejemplo, minutos, megabytes, mensajes, etc.).
`Quantity`	Número de unidades usadas o consumidas en este registro.

Registros operativos de SMS

Propiedad	Descripción
`TimeGenerated`	Marca de tiempo (UTC) de cuando se generó el registro.
`OperationName`	Operación asociada al registro.
`CorrelationID`	Identificador de los eventos correlacionados. Se puede utilizar para identificar eventos correlacionados en varias tablas.
`OperationVersion`	api-version asociada con la operación, si operationName se ha realizado mediante una API. Si no hay ninguna API que corresponda a 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 determinado. Las propiedades que aparecen en el blob de propiedades 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`	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.
`ResultDescription`	Descripción de texto estático de esta operación.
`DurationMs`	Duración de la operación en milisegundos.
`CallerIpAddress`	Dirección IP del autor de la llamada, si la operación se corresponde con una llamada API que podría proceder de una entidad con una dirección IP disponible públicamente.
`Level`	Nivel de gravedad del evento.
`URI`	URI de la solicitud.
`OutgoingMessageLength`	Número de caracteres del mensaje saliente.
`IncomingMessageLength`	Número de caracteres del mensaje entrante.
`DeliveryAttempts`	Número de intentos realizados para entregar el mensaje.
`PhoneNumber`	Número de teléfono desde el que se envía el mensaje SMS.
`SdkType`	Tipo de SDK que se usa en la solicitud.
`PlatformType`	Tipo de plataforma utilizado en la solicitud.
`Method`	Método usado para realizar la solicitud.
`NumberType`	El tipo de número, desde el que se envía el mensaje SMS. Puede ser LongCodeNumber o ShortCodeNumber o DynamicAlphaSenderID
`MessageID`	Representa el messageId único generado para cada mensaje saliente y entrante. Esto se puede encontrar en el objeto de respuesta de la API de SMS
`Country`	Representa los países o regiones desde los que se enviaron o recibieron los mensajes SMS

Ejemplo de registro enviado por SMS


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.100Z",
        "OperationName": "SMSMessagesSent",
        "CorrelationId": "dDRmubfpNZZZZZnxBtw3Q.0",
        "OperationVersion": "2020-07-20-preview1",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 202,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://sms-e2e-prod.communication.azure.com/sms?api-version=2020-07-20-preview1",
        "OutgoingMessageLength": 151,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "azsdk-net-Communication.Sms",
        "PlatformType": "Microsoft Windows 10.0.17763",
        "Method": "POST",
        "MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

Ejemplo de registro de informes de entrega de SMS


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.200Z",
        "OperationName": "SMSDeliveryReportsReceived",
        "CorrelationId": "tl8WpUTESTSTSTccYadXJm.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/DeliveryReport",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 1,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

Ejemplo de registro recibido por SMS


    [
      {
        "TimeGenerated": "2022-09-27T15:58:30.200Z",
        "OperationName": "SMSMessagesReceived",
        "CorrelationId": "e2KFTSTSTI/5PTx4ZZB.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/inbound",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 110,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(consulte también Preguntas más frecuentes).

Compartir vía