Compartir a través de

Registros de SMS

Azure Communication Services proporciona funcionalidades de registro que puede usar para supervisar y depurar la solución de Communication Services. Puede configurar estas funcionalidades a través de Azure Portal.

Importante

En este artículo se describen los registros habilitados a través de Azure Monitor . Consulte también las preguntas más frecuentes. Para habilitar estos registros para Communications Services, consulte: Habilitar el registro en Configuración de diagnóstico.

Prerrequisitos

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.
  • Una sola configuración de diagnóstico puede definir no más de uno de cada tipo de destino. Si desea enviar datos a más de uno de un tipo de destino determinado (por ejemplo, dos áreas de trabajo de Log Analytics diferentes), debe crear varias configuraciones. Cada recurso puede tener hasta cinco configuraciones de diagnóstico.

Complete estas instrucciones para configurar el recurso de Azure Monitor para empezar a crear registros y métricas para Communications 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 Configuración de diagnóstico.

Nota:

Para habilitar los registros para SMS, en nombre de configuración de diagnóstico, seleccione SMS Operational.

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. Los registros capturan detalles sobre el rendimiento y la función de SMS. Los detalles incluyen el estado de los mensajes, si el mensaje se entregó correctamente, bloqueó o no se pudo enviar.

Los registros operativos de SMS contienen información para ayudar 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:

  • 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 ninguna API corresponde a esta operación, la versión representa la versión de esa 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 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 Servicios de Comunicación.
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 en la cual se basa el uso para 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 ninguna API corresponde a esta operación, la versión representa la versión de esa 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 con la que se pueden habilitar o deshabilitar los registros en un recurso determinado. Las propiedades del blob de propiedades de un evento son las mismas dentro de una categoría de registro y un tipo de recurso determinado.
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, ShortCodeNumber o DynamicAlphaSenderID.
MessageID Representa el identificador de mensaje único generado para cada mensaje saliente y entrante. Busque messageId en el objeto de respuesta de la API de SMS. El formato del identificador de mensaje devuelto por esta API se considera un detalle de implementación interno y está sujeto a cambios sin previo aviso. Los clientes deben tratar el identificador de mensaje como identificadores opacos y no deben analizar, inferir estructura ni crear lógica en función de su formato o contenido.
Country Representa los países o regiones desde los que se envían o reciben 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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "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": "11c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

Preguntas más frecuentes sobre SMS

  • Last updated on