Поделиться через

Логи SMS-сообщений

Службы коммуникации Azure предоставляют возможности ведения журнала, которые можно использовать для мониторинга и отладки решения служб коммуникации. Эти возможности можно настроить на портале Azure.

Внимание

В этой статье описываются журналы, включенные с помощью Azure Monitor, см. также часто задаваемые вопросы. Чтобы включить эти журналы для служб коммуникации, см. раздел "Включить ведение журнала в параметрах диагностики".

Предпосылки

Службы коммуникации Azure предоставляют функции мониторинга и аналитики через Обзор журналов Azure Monitor и Azure Monitor Metrics.

Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:

  • Категории журналов и данных метрик, направленных в места назначения, определённые в настройке. Доступные категории зависят от различных типов ресурсов.
  • здесь указываются одно или несколько назначений для отправки журналов. Текущие назначения включают рабочую область Log Analytics, Центры событий и Хранилище Azure.
  • Один параметр диагностики может определять не более одного назначения каждого типа. Если вы хотите отправить данные в несколько определенных типов назначения (например, две разные рабочие области Log Analytics), необходимо создать несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.

Выполните эти инструкции, чтобы настроить ресурс Azure Monitor, чтобы начать создавать журналы и метрики для служб коммуникации. Подробные сведения об использовании параметров диагностики во всех ресурсах Azure см. в статье "Включение ведения журнала в параметрах диагностики".

Примечание.

T, чтобы включить журналы для SMS, в разделе "Имя параметра диагностики" выберите "Операционная служба SMS".

Обзор

Журналы операций SMS — это записи событий и действий, которые предоставляют аналитические сведения о запросах API SMS. Журналы записывают сведения о производительности и функции SMS. Сведения включают состояние сообщений, успешно ли сообщение доставлено, заблокировано или не удалось отправить.

Операционные журналы SMS содержат сведения для выявления тенденций и шаблонов, устранения проблем, которые могут повлиять на производительность таких неудачных поставок сообщений или обслуживания. Журналы содержат следующие сведения:

  • Отправленные сообщения.
  • Получено сообщение.
  • Сообщения доставлены.
  • Настройка сообщений: Подписаться и Отказаться.

Категории журналов ресурсов

Службы коммуникации предлагают следующие типы журналов:

  • Журналы использования — предоставляют данные об использовании, связанные с каждым предложением платной услуги.
  • Рабочие журналы SMS — предоставляют основные сведения, относящиеся к службе SMS.

Схема журналов использования

Свойство Описание
Timestamp Метка времени (UTC), когда был сгенерирован журнал.
Operation Name Операция, связанная с записью журнала.
Operation Version api-version, связанного с операцией, если операция operationName выполнялась с помощью API. Если API не соответствует этой операции, версия представляет версию этой операции в случае изменения свойств, связанных с операцией в будущем.
Category Категория события в журнале. Категория — степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
Correlation ID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
Properties Другие данные, применимые к различным режимам Служб коммуникации.
Record ID Уникальный идентификатор для данной записи использования.
Usage Type Режим использования. Например, чат, ТСОП, NAT и т. д.
Unit Type Тип единицы, на которой основано использование для данного режима использования. Например, минуты, мегабайты, сообщения и т. д.
Quantity Количество единиц, использованных или потребленных для данной записи.

Журналы операций SMS

Свойство Описание
TimeGenerated Метка времени (UTC), когда был сгенерирован журнал.
OperationName Операция, связанная с записью журнала.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
OperationVersion Версия API, связанного с операцией, если операция operationName выполнялась с помощью API. Если API не соответствует этой операции, версия представляет версию этой операции в случае изменения свойств, связанных с операцией в будущем.
Category Категория события в журнале. Категория — степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства в blob-объекте свойств события совпадают с определенной категорией журнала и типом ресурса.
ResultType Состояние операции.
ResultSignature Подстатус операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST.
ResultDescription Статическое текстовое описание этой операции.
DurationMs Время выполнения операции в миллисекундах.
CallerIpAddress IP-адрес вызывающего объекта, если операция соответствует вызову API, который будет приходить с объекта с общедоступным IP-адресом.
Level Уровень серьезности события.
URI URI-адрес запроса.
OutgoingMessageLength Количество символов в исходящем сообщении.
IncomingMessageLength Количество символов во входящем сообщении.
DeliveryAttempts Количество попыток доставить это сообщение.
PhoneNumber Номер телефона, с которого отправляется SMS-сообщение.
SdkType Тип пакета SDK, используемый в запросе.
PlatformType Тип платформы, используемый в запросе.
Method Метод, используемый в запросе.
NumberType Тип номера, из которой отправляется SMS-сообщение. Это может быть LongCodeNumber, ShortCodeNumber или DynamicAlphaSenderID.
MessageID Представляет уникальный идентификатор сообщения, созданный для каждого исходящего и входящего сообщения. Найдите MessageId в объекте ответа API SMS. Формат идентификатора сообщения, возвращаемого этим API, считается внутренней информацией о реализации и подлежит изменению без уведомления. Клиенты должны рассматривать идентификатор сообщения как недоступные идентификаторы и не должны анализировать, выводить структуру или строить логику на основе их формата или содержимого.
Country Представляет страны или регионы, из которых отправляются или получают SMS-сообщения.

Пример журнала отправки 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"
      }
    ]

Пример журнала отчета о доставке 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"
      }
    ]

Пример журнала получения 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"
      }
    ]

Вопросы и ответы о SMS