журналы электронной почты Службы коммуникации 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 sendmail.
- Обновления состояния уровня сообщения предоставляют состояние длительной операции отправки электронной почты (аналогично обновлениям состояния, которые вы получаете при вызове НАШИХ API GET). Они отмечены отсутствием
RecipientIdсвойства, так как эти обновления предназначены для всего сообщения и не применимы к конкретному получателю в этом запросе сообщения.DeliveryStatusсвойство содержит состояние доставки на уровне сообщения. Возможные значения дляDeliveryStatusэтого типа события:DroppedиOutForDeliveryQueued. - Обновления состояния уровня получателя предоставляют состояние доставки электронной почты для каждого отдельного получателя, которому отправлено сообщение в одном сообщении. Они содержат свойство с адресом
RecipientIdэлектронной почты получателя. Состояние доставки на уровне получателя предоставляется в свойствеDeliveryStatus. Возможные значения дляDeliveryStatusэтого типа события:Delivered,Expanded,Failed,Quarantined,FilteredSpam,SuppressedиBounced. Отслеживая эти журналы, вы можете обеспечить полную видимость процесса доставки электронной почты, быстро идентифицируя все проблемы, которые могут возникнуть и принимать корректирующие меры по мере необходимости.
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени создания журнала (в формате UTC). |
Location |
Регион, в котором была обработана операция. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Версия API (api-version), связанного с операцией, если операция operationName выполнялась с помощью API. Если нет API, соответствующий этой операции, версия представляет версию этой операции в случае, если свойства, связанные с изменением операции в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в определенном ресурсе. Свойства, которые отображаются в свойствах BLOB-объекта события, одинаковы в пределах определенной категории журнала и типа ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Может использоваться для обнаружения коррелированных событий между несколькими таблицами. Для всех операционных журналов электронной почты Идентификатор Корреляции сопоставляется с MessageId, который возвращается из успешного запроса SendMail. |
RecipientId |
Адрес электронной почты целевого получателя. Он присутствует только для событий уровня получателя. Если это событие уровня сообщения, свойство будет пустым. |
DeliveryStatus |
Состояние терминала сообщения. Возможные valuse для события уровня сообщений: Dropped, OutForDelivery. Queued Возможные valuse для события уровня получателя: Delivered, Expanded, Failed, Quarantined, FilteredSpam, . SuppressedBounced |
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"
}