журналы электронной почты Службы коммуникации Azure
Службы коммуникации Azure предоставляют возможности ведения журналов, которые можно использовать для мониторинга и отладки решения Служб коммуникации. Эти возможности можно настроить с помощью портала Azure.
Необходимые компоненты
Службы коммуникации Azure предоставляют функции мониторинга и аналитики с помощью обзоров журналов Azure Monitor и метрик Azure Monitor. Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:
- Категории журналов и данных метрик, отправленных в назначения, определенные в параметре. Доступные категории зависят от разных типов ресурсов.
- здесь указываются одно или несколько назначений для отправки журналов. Текущие назначения включают рабочую область Log Analytics, Центры событий и служба хранилища Azure.
- Один параметр диагностики может определять не более одного назначения каждого типа. Если вы хотите отправить данные в несколько определенных типов назначения (например, две разные рабочие области Log Analytics), создайте несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.
Важно!
Необходимо включить параметр диагностики в Azure Monitor для отправки данных журнала опросов в рабочую область Log Analytics, Центры событий или учетную запись хранения Azure для получения и анализа данных опроса. Если вы не отправляете данные службы автоматизации звонков в один из этих вариантов, данные опроса не будут храниться и будут потеряны. Ниже приведены инструкции по настройке ресурса Azure Monitor для начала создания журналов и метрик для служб коммуникации. Подробные сведения об использовании диагностических Параметры во всех ресурсах Azure см. в статье "Включение ведения журнала в диагностических Параметры
Примечание.
В разделе "Имя параметра диагностики" выберите "Журналы обновления состояния доставки службы электронной почты", "Журналы отправки почты электронной почты" и "Журналы взаимодействия пользователей службы электронной почты", чтобы включить журналы для сообщений электронной почты
Категории журналов ресурсов
Службы коммуникации предоставляют следующие типы журналов, которые можно включить:
- Журналы использования — предоставляют данные об использовании, связанные с каждым предложением платной услуги.
- Журналы операций отправки почты электронной почты — предоставляют подробные сведения, связанные с отправкой почтовых запросов службой электронной почты.
- Операционные журналы обновления состояния электронной почты — предоставляют обновления состояния доставки сообщений и получателей, связанные с отправкой запросов на отправку почты службой электронной почты.
- Операционные журналы взаимодействия пользователей по электронной почте предоставляют сведения, связанные с метриками "открыть" и "click" для сообщений, отправленных из службы электронной почты.
Схема журналов использования
| Свойство | 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 |
Количество единиц, использованных или потребленных для данной записи. |
Операционные журналы отправки почты электронной почты
Журналы операций отправки почты электронной почты предоставляют ценные сведения о тенденциях запросов API со временем. Эти данные помогают обнаруживать ключевые аналитические данные электронной почты, такие как общее количество отправленных сообщений электронной почты, размер электронной почты и количество сообщений электронной почты с вложениями. Эти сведения можно быстро проанализировать практически в реальном времени и визуализировать в удобном для пользователя способе повышения качества принятия решений.
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени создания журнала (в формате UTC). |
Location |
Регион, в котором была обработана операция. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если нет API, соответствующий этой операции, версия представляет версию этой операции в случае, если свойства, связанные с изменением операции в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в определенном ресурсе. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех операционных журналов электронной почты Идентификатор Корреляции сопоставляется с MessageId, который возвращается из успешного запроса SendMail. |
Size |
Представляет общий размер текста электронной почты, темы, заголовков и вложений в мегабайтах. |
ToRecipientsCount |
Общее число уникальных адресов электронной почты в строке "To". |
CcRecipientsCount |
Общее число уникальных адресов электронной почты в строке "Копия". |
BccRecipientsCount |
Общее число уникальных адресов электронной почты в строке Bcc. |
UniqueRecipientsCount |
Это дедупликированное общее число получателей для полей адресов To, Cc и Bcc. |
AttachmentsCount |
Общее число вложений. |
TrafficSource |
Имя клиента, из которого был получен запрос электронной почты. |
Примеры
{
"OperationType":"SendMail",
"OperationCategory":"EmailSendMailOperational",
"Size":0.026019,
"ToRecipientsCount":2,
"CcRecipientsCount":3,
"BccRecipientsCount":1,
"UniqueRecipientsCount":6,
"AttachmentsCount":0,
"TrafficSource":"Email .NET SDK"
}
Операционные журналы обновления состояния электронной почты
Журналы обновления состояния электронной почты предоставляют подробные сведения о состоянии доставки сообщений и получателей в запросах API отправки. Эти журналы предлагают сведения о сообщении, такие как время доставки, а также сведения на уровне получателя, такие как адреса электронной почты и обновления состояния доставки. Отслеживая эти журналы, вы можете обеспечить полную видимость процесса доставки электронной почты, быстро идентифицируя все проблемы, которые могут возникнуть и принимать корректирующие меры по мере необходимости.
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени создания журнала (в формате UTC). |
Location |
Регион, в котором была обработана операция. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если нет API, соответствующий этой операции, версия представляет версию этой операции в случае, если свойства, связанные с изменением операции в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в определенном ресурсе. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех операционных журналов электронной почты Идентификатор Корреляции сопоставляется с MessageId, который возвращается из успешного запроса SendMail. |
RecipientId |
Адрес электронной почты целевого получателя. Если это событие уровня сообщения, свойство будет пустым. |
DeliveryStatus |
Состояние терминала сообщения. |
SmtpStatusCode |
Код состояния SMTP, возвращенный с почтового сервера получателя в ответ на запрос на отправку почты. |
EnhancedSmtpStatusCode |
Расширенный код состояния SMTP, возвращенный с почтового сервера получателя. |
SenderDomain |
Доменная часть отправителяAddress, используемая для отправки сообщений электронной почты. |
SenderUsername |
Часть имени пользователя отправителяAddress, используемая при отправке сообщений электронной почты. |
IsHardBounce |
Указывает, возникла ли ошибка доставки из-за постоянной или временной проблемы. IsHardBounce == true означает, что проблема с постоянным почтовым ящиком предотвращает доставку сообщений электронной почты. |
Примеры
{
"OperationType":"DeliveryStatusUpdate",
"OperationCategory":"EmailStatusUpdateOperational",
"RecipientId":"user@email.com",
"DeliveryStatus":"Delivered",
"SenderDomain":"contoso.com",
"SenderUsername":"donotreply",
"IsHardBounce":false
}
Операционные журналы взаимодействия пользователей электронной почты
Операционные журналы взаимодействия с пользователями электронной почты предоставляют аналитические сведения о тенденциях взаимодействия с электронной почтой для вашей электронной почты. Эти данные помогают отслеживать и анализировать ключевые метрики электронной почты, такие как открытые тарифы, ставки щелчка по щелчку и отмена подписки. Эти журналы можно хранить и анализировать, позволяя получить более подробную информацию о производительности системы электронной почты и адаптировать стратегию соответствующим образом. В целом операционные журналы взаимодействия пользователей электронной почты предоставляют мощный инструмент для повышения производительности системы электронной почты, упреждающего измерения и оптимизации кампаний электронной почты и улучшения взаимодействия пользователей с течением времени.
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени создания журнала (в формате UTC). |
Location |
Регион, в котором была обработана операция. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если нет API, соответствующий этой операции, версия представляет версию этой операции в случае, если свойства, связанные с изменением операции в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в определенном ресурсе. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех операционных журналов электронной почты Идентификатор Корреляции сопоставляется с MessageId, который возвращается из успешного запроса SendMail. |
RecipientId |
Адрес электронной почты целевого получателя. Если это событие уровня сообщения, свойство будет пустым. |
EngagementType |
Тип отслеживаемого взаимодействия пользователей. |
EngagementContext |
Контекст представляет то, с чем взаимодействует пользователь. |
UserAgent |
Строка агента пользователя из клиента. |
Примеры
{
"OperationType": "UserEngagementUpdate",
"OperationCategory": "EmailUserEngagementOperational",
"EngagementType": "View",
"UserAgent": "Mozilla/5.0"
}
{
"OperationType":"UserEngagementUpdate",
"OperationCategory":"EmailUserEngagementOperational",
"EngagementType":"Click",
"EngagementContext":"https://www.contoso.com/support?id=12345",
"UserAgent":"Mozilla/5.0"
}