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

журналы SMS Службы коммуникации Azure

  • Статья

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

Внимание

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

Предварительные требования

Службы коммуникации Azure предоставляют функции мониторинга и аналитики с помощью обзоров журналов Azure Monitor и метрик Azure Monitor. Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:

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

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

Примечание.

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

Обзор

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

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

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

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

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

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

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

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

Свойство Description
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 Представляет уникальный идентификатор сообщения, созданный для каждого исходящего и входящего сообщения. Это можно найти в объекте ответа API SMS
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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "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": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(см. также Часто задаваемые вопросы).