Azure Communication Services のメール機能でメール送信ログを確認する方法
質問
Azure Communication Services のメール機能でメールを送信しましたが、メールが正常に送信できたか等のログはどのように確認することができますか？
回答
診断設定を用いることでメール送信のログを確認することができます。具体的には Azure ポータルから Azure Communication Services を開き、[ログ] ブレードから各テーブルのログを確認する方法と、[分析情報（プレビュー）] ブレードからグラフ等で視覚的に確認する方法の 2 種類があります。
前提条件
どちらの方法でメール送信のログを確認する場合にも、Azure Communication Services の診断設定機能を有効化する必要があります。
診断設定より下記の 3 つのカテゴリ、”Log Analytics ワークスペースへの送信” を選択し、保存することで、Azure Communication Services のメールログを確認するための診断設定が有効化されます。
| カテゴリ | 概要 | 詳細 URL |
|---|---|---|
| Email Service Send Mail Logs | メール送信のリクエストのログ | ACSEmailSendMailOperational |
| Email Service Delivery Status Update Logs | メール送信のリクエストのステータス等の詳細なログ | ACSEmailStatusUpdateOperational |
| Email Service User Engagement Logs | ユーザーエンゲージメントに関するログ | ACSEmailUserEngagementOperational |
Log Analytics をご利用される場合、追加で費用が掛かる可能性もございますのでご注意ください。
[ログ] ブレードから確認する方法
Azure ポータルの [ログ] ブレードより、診断設定で有効化した各テーブルの詳細をご確認いただけます。
例えば、Azure Communication Services から送信したメールの情報を確認したい場合、”ACSEmailSendMailOperational” テーブルを確認することで、送信したメールのサイズや宛先の人数、添付の数等を確認することが可能です。
クエリ例
ACSEmailSendMailOperational
| where TimeGenerated > ago(1d)
| project TimeGenerated, Size, ToRecipientsCount, CcRecipientsCount, BccRecipientsCount, UniqueRecipientsCount, AttachmentsCount, CorrelationId
| take 10
また、Azure Communication Services からのメール送信が成功したか失敗したか、失敗した場合なぜ失敗したかについては、”ACSEmailStatusUpdateOperational” テーブルを確認することで、送信したメールのステータス（成功や失敗等）やエラーメッセージ等を確認することが可能です。
クエリ例
ACSEmailStatusUpdateOperational
| where TimeGenerated > ago(1d)
| where OperationName =~ "DeliveryStatusUpdate"
| where RecipientId != ""
| project TimeGenerated, RecipientId, DeliveryStatus, SmtpStatusCode, EnhancedSmtpStatusCode, FailureReason, FailureMessage, CorrelationId
| take 10
補足ではございますが、”DeliveryStatus” カラムに記載される Status につきましては、下記のドキュメントに記載されておりますのでご参照ください。
Azure Communication Services - Email イベント
[分析情報（プレビュー）] ブレードから確認する方法
Azure ポータルの [ログ] ブレードより、表やグラフで Azure Communication Services から送信したメールの状態等がご確認いただけます。
例えば、下記のようにメール送信の結果やメールサイズ、メール受信者数等を確認することが可能です。
なお、こちらはプレビュー機能であるため、予めご留意ください。
参考ドキュメント
2023 年 11 月 09 日時点の内容となります。
本記事の内容は予告なく変更される場合がございますので予めご了承ください。