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

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

Включение журналов диагностики в ресурсе

Ведение журнала по умолчанию отключено при создании ресурса. Чтобы включить ведение журнала, перейдите в колонку Параметры диагностики в меню ресурсов в разделе Мониторинг. Затем щелкните Add diagnostic setting (Добавить параметр диагностики).

Затем выберите целевой объект архива. Сейчас в качестве целевых объектов архива поддерживаются учетные записи хранения и Log Analytics. После выбора типов журналов, которые вы хотите записать, сохраните параметры диагностики.

Новые параметры вступят в силу в течение 10 минут. Журналы будут отображаться в настроенном целевом объекте архивации на панели "Журналы" в ресурсе Служб коммуникации.

Службы коммуникации Azure параметры диагностики.

Дополнительные сведения о настройке системы диагностики доступны в обзоре журналов ресурса Azure.

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

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

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

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

Свойство Описание
Отметка времени Метка времени создания журнала (в формате UTC).
Имя операции Операция, связанная с записью журнала.
Версия операции api-version, связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
Идентификатор корреляции Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
Свойства Другие данные, применимые к различным режимам Служб коммуникации.
Идентификатор записи Уникальный идентификатор для данной записи использования.
Тип потребления Режим использования. (например, чат, PSTN, NAT и т. д.)
Тип Unit Тип единицы использования для данного режима использования. (например, минуты, мегабайты, число сообщений и т. д.).
Количество Количество единиц, использованных или потребленных для данной записи.

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

Свойство Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
OperationName Операция, связанная с записью журнала.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
OperationVersion Версия API, связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
ResultType Состояние операции.
ResultSignature Подсостояние операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST.
ResultDescription Статическое текстовое описание этой операции.
DurationMs Время выполнения операции в миллисекундах.
CallerIpAddress IP-адрес вызывающего объекта, если операция соответствует вызову API, который будет приходить с объекта с общедоступным IP-адресом.
Level Уровень серьезности события.
URI URI-адрес запроса.
UserId Идентификатор пользователя отправителя запроса.
ChatThreadId Идентификатор потока чата, связанного с запросом.
ChatMessageId Идентификатор сообщения чата, связанного с запросом.
SdkType Тип пакета SDK, используемый в запросе.
PlatformType Тип платформы, используемый в запросе.

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

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

Рабочие журналы проверки подлинности

Свойство Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
OperationName Операция, связанная с записью журнала.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
OperationVersion Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
ResultType Состояние операции.
ResultSignature Подсостояние операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST.
DurationMs Время выполнения операции в миллисекундах.
CallerIpAddress IP-адрес вызывающего объекта, если операция соответствует вызову API, который будет приходить с объекта с общедоступным IP-адресом.
Level Уровень серьезности события.
URI URI-адрес запроса.
SdkType Тип пакета SDK, используемый в запросе.
PlatformType Тип платформы, используемый в запросе.
Идентификация Удостоверение пользователя Службы коммуникации Azure или Teams, связанного с операцией.
Области действия Области Служб коммуникации, представленные в маркере доступа.

Операционные журналы обхода сети

Измерение Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
OperationName Операция, связанная с записью журнала.
CorrelationId Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами.
OperationVersion Версия API, связанная с операцией или версией операции (если версия API отсутствует).
Категория Категория журнала для события. Журналы с той же категорией журнала и типом ресурса будут иметь одинаковые поля свойств.
ResultType Состояние операции (например, "Успешно" или "Сбой").
ResultSignature Подсостояние операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST.
DurationMs Время выполнения операции в миллисекундах.
Level Уровень серьезности операции.
URI URI-адрес запроса.
Идентификация Удостоверение отправителя запроса, если оно указано.
SdkType Тип пакета SDK, используемый в запросе.
PlatformType Тип платформы, используемый в запросе.
RouteType Методология маршрутизации, в которой будет находиться сервер ICE от клиента (например, любой или ближайший).

Email журналы операций отправки почты

Свойство Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
Расположение Регион, в котором была обработана операция.
OperationName Операция, связанная с записью журнала.
OperationVersion Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех Email операционных журналов идентификатор CorrelationId сопоставляется с идентификатором MessageId, который возвращается из успешного запроса SendMail.
Размер Представляет общий размер текста электронной почты, темы, заголовков и вложений в мегабайтах.
ToRecipientsCount Общее число уникальных адресов электронной почты в строке "To".
CcRecipientsCount Общее число уникальных адресов электронной почты в строке "Копия".
BccRecipientsCount Общее число уникальных адресов электронной почты в строке ск.
UniqueRecipientsCount Это дедуплицированное общее число получателей для полей "Кому", "Копия" и "Ск".
AttachmentsCount Общее число вложений.

операционные журналы обновления состояния Email

Свойство Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
Расположение Регион, в котором была обработана операция.
OperationName Операция, связанная с записью журнала.
OperationVersion Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех Email операционных журналов идентификатор CorrelationId сопоставляется с идентификатором MessageId, который возвращается из успешного запроса SendMail.
RecipientId Адрес электронной почты целевого получателя. Если это событие уровня сообщения, свойство будет пустым.
Статус доставки Состояние терминала сообщения.

Email операционных журналов взаимодействия пользователей

Свойство Описание
TimeGenerated Метка времени создания журнала (в формате UTC).
Расположение Регион, в котором была обработана операция.
OperationName Операция, связанная с записью журнала.
OperationVersion Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если для этой операции не существует соответствующего API, то версия представляет версию этой операции, чтобы в дальнейшем изменить свойства, связанные с операцией.
Категория Категория журнала для события. Категория —степень детализации, при которой можно включать или отключать журналы для определенного ресурса. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса.
CorrelationID Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех Email операционных журналов идентификатор CorrelationId сопоставляется с идентификатором MessageId, который возвращается из успешного запроса SendMail.
RecipientId Адрес электронной почты целевого получателя. Если это событие уровня сообщения, свойство будет пустым.
EngagementType Тип отслеживаемого взаимодействия с пользователем.
EngagementContext Контекст представляет то, с чем взаимодействовал пользователь.
UserAgent Строка агента пользователя от клиента.