Azure 通訊服務電子郵件記錄
Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。 這些功能可透過 Azure 入口網站來設定。
必要條件
Azure 通訊服務透過 Azure 監視器記錄概觀和 Azure 監視器計量提供監視和分析功能。 每個 Azure 資源都需要自己的診斷設定，其會定義下列準則：
- 傳送至設定中所定義目的地的記錄和計量資料類別。 可用的類別會因不同的資源類型而有所不同。
- 一個或多個要傳送記錄的目的地。 目前的目的地包括 Log Analytics 工作區、事件中樞和 Azure 儲存體。
- 單一診斷設定可以定義每個目的地不超過一個。 如果您想要將資料傳送至超過一個的特定目的地類型 (例如，兩個不同的 Log Analytics 工作區)，則請建立多個設定。 每個資源最多可以有五個診斷設定。
重要
您必須在 Azure 監視器中啟用診斷設定，才能將問卷的記錄資料傳送至 Log Analytics 工作區、事件中樞或 Azure 儲存體帳戶，以接收和分析問卷資料。 如果您未將通話自動化資料傳送至下列其中一個選項，您的問卷資料將不會儲存且會遺失。以下是設定 Azure 監視器資源的指示，以便開始建立通訊服務的記錄和計量。 如需在所有 Azure 資源中使用診斷設定的詳細文件，請參閱在診斷設定中啟用記錄
注意
在診斷設定名稱底下，選取 [電子郵件服務傳遞狀態更新記錄]、[電子郵件服務傳送郵件記錄]、[電子郵件服務業務開發記錄] 以啟用電子郵件的記錄
資源記錄類別
通訊服務提供下列類型的記錄供您啟用：
- 使用量記錄 - 提供與每個計費服務供應項目相關聯的使用量資料
- 電子郵件傳送郵件作業記錄 - 提供與電子郵件服務的傳送郵件要求相關的詳細資訊。
- 電子郵件狀態更新作業記錄 - 提供與電子郵件服務的傳送郵件要求相關的訊息和收件者層級傳遞狀態更新。
- 電子郵件業務開發作業記錄 - 提供從電子郵件服務傳送之訊息的「開啟」和「點按」業務開發計量的相關資訊。
使用量記錄結構描述
| 屬性 | 說明 |
|---|---|
Timestamp |
產生記錄時的時間戳記 (UTC)。 |
Operation Name |
與記錄相關聯的作業。 |
Operation Version |
與作業相關聯的 api-version (如果使用 API 執行 operationName 的話)。 如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業建立關聯的屬性在未來變更。 |
Category |
事件的記錄類別。 類別是您可在特定資源上啟用或停用記錄的資料粒度。 事件之屬性 Blob 內顯示的屬性，會與特定記錄類別和資源類型內的屬性相同。 |
Correlation ID |
相互關聯事件的識別碼。 可用來識別多個資料表之間的相互關聯事件。 |
Properties |
適用於各種通訊服務模式的其他資料。 |
Record ID |
給定使用量記錄的唯一識別碼。 |
Usage Type |
使用量模式。 (例如，聊天、PSTN、NAT 等等) |
Unit Type |
在給定的使用量模式中，作為使用量依據的單位類型。 (例如，分鐘、MB、訊息數等)。 |
Quantity |
此記錄所使用或取用的單位數。 |
電子郵件傳送郵件作業記錄
電子郵件傳送郵件作業記錄可提供一段時間內 API 要求趨勢的寶貴見解。 此資料可協助您探索重要的電子郵件分析，例如傳送的電子郵件總數、電子郵件大小，以及包含附件的電子郵件數目。 這項資訊可以用近即時的方式快速分析，並以使用者易於使用的方式視覺化，以協助推動更好的決策。
| 屬性 | 說明 |
|---|---|
TimeGenerated |
產生記錄時的時間戳記 (UTC)。 |
Location |
處理作業的區域。 |
OperationName |
與記錄錄製相關聯的作業。 |
OperationVersion |
與作業相關聯的 api-version (如果使用 API 執行 operationName 的話)。 如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業建立關聯的屬性在未來變更。 |
Category |
事件的記錄類別。 類別是您可在特定資源上啟用或停用記錄的資料粒度。 事件之屬性 Blob 內顯示的屬性，會與特定記錄類別和資源類型內的屬性相同。 |
CorrelationID |
相互關聯事件的識別碼。 可用來識別多個資料表之間的相互關聯事件。 對於所有電子郵件作業記錄，CorrelationId 會對應至從成功的 SendMail 要求傳回的 MessageId。 |
Size |
代表電子郵件內文、主旨、標頭和附件的大小總計 (以 MB 為單位)。 |
ToRecipientsCount |
[收件者] 行上唯一電子郵件地址的總數。 |
CcRecipientsCount |
[副本] 行上唯一電子郵件地址的總數。 |
BccRecipientsCount |
[密件副本] 行上唯一電子郵件地址的總數。 |
UniqueRecipientsCount |
這是 [收件者地址]、[副本地址] 和 [密件副本地址] 欄位已刪除重複資料的收件者總數。 |
AttachmentsCount |
附件總數。 |
TrafficSource |
電子郵件要求的來源用戶端名稱。 |
範例
{
"OperationType":"SendMail",
"OperationCategory":"EmailSendMailOperational",
"Size":0.026019,
"ToRecipientsCount":2,
"CcRecipientsCount":3,
"BccRecipientsCount":1,
"UniqueRecipientsCount":6,
"AttachmentsCount":0,
"TrafficSource":"Email .NET SDK"
}
電子郵件狀態更新作業記錄
電子郵件狀態更新作業記錄可提供對您的 SendMail API 要求的電子郵件層級和收件者層級傳遞狀態更新的深入解析。
- 電子郵件層級狀態更新會提供長時間執行的電子郵件傳送作業的狀態 (類似於您透過呼叫 GET API 接收的狀態更新)。 這些會標示為缺少
RecipientId屬性，因為這些更新適用於整個郵件，不適用於該郵件要求中的特定收件者。DeliveryStatus屬性包含電子郵件層級傳遞狀態。 此事件類型的DeliveryStatus的可能值為Dropped、OutForDelivery和Queued。 - 收件者層級狀態更新會針對以單一郵件傳送電子郵件的每個個別收件者提供電子郵件傳遞狀態。 這些包含收件者電子郵件地址具有的
RecipientId屬性。 收件者層級的傳遞狀態會在DeliveryStatus屬性中提供。 此事件類型的DeliveryStatus的可能值為Delivered、Expanded、Failed、Quarantined、FilteredSpam、Suppressed、Bounced。 藉由追蹤這些記錄，您可以確保電子郵件傳遞程序的完整可見度，並快速找出可能發生的任何問題，並視需要採取矯正措施。
| 屬性 | 說明 |
|---|---|
TimeGenerated |
產生記錄時的時間戳記 (UTC)。 |
Location |
處理作業的區域。 |
OperationName |
與記錄錄製相關聯的作業。 |
OperationVersion |
與作業相關聯的 api-version (如果使用 API 執行 operationName 的話)。 如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業建立關聯的屬性在未來變更。 |
Category |
事件的記錄類別。 類別是您可在特定資源上啟用或停用記錄的資料粒度。 事件之屬性 Blob 內顯示的屬性，會與特定記錄類別和資源類型內的屬性相同。 |
CorrelationID |
相互關聯事件的識別碼。 可用來識別多個資料表之間的相互關聯事件。 對於所有電子郵件作業記錄，CorrelationId 會對應至從成功的 SendMail 要求傳回的 MessageId。 |
RecipientId |
目標收件者的電子郵件地址。 它僅存在於收件者層級事件。 如果這是訊息層級事件，則屬性將是空的。 |
DeliveryStatus |
訊息的終端狀態。 電子郵件層級事件的可能值為：Dropped、OutForDelivery、Queued。 收件者層級事件的可能值為：Delivered、Expanded、Failed、Quarantined、FilteredSpam、Suppressed、Bounced。 |
SmtpStatusCode |
從收件者電子郵件伺服器傳回的 SMTP 狀態碼，以回應傳送郵件要求。 |
EnhancedSmtpStatusCode |
從收件者電子郵件伺服器傳回的增強 SMTP 狀態碼。 |
SenderDomain |
SenderAddress 的網域部分，用於傳送電子郵件。 |
SenderUsername |
傳送電子郵件時所使用 SenderAddress 的使用者名稱部分。 |
IsHardBounce |
表示傳遞失敗是因為永久或臨時性問題所導致。 IsHardBounce == true 表示永久信箱問題，使電子郵件無法傳遞。 |
範例
{
"OperationType":"DeliveryStatusUpdate",
"OperationCategory":"EmailStatusUpdateOperational",
"RecipientId":"user@email.com",
"DeliveryStatus":"Delivered",
"SenderDomain":"contoso.com",
"SenderUsername":"donotreply",
"IsHardBounce":false
}
電子郵件業務開發作業記錄
電子郵件業務開發作業記錄可讓您深入了解電子郵件系統的電子郵件參與趨勢。 此資料可協助您追蹤和分析重要的電子郵件計量，例如開啟率、點擊率和取消訂閱率。 您可以儲存和分析這些記錄，讓您深入了解電子郵件系統的效能，並據以調整您的策略。 整體而言，電子郵件業務開發作業記錄提供強大的工具，可改善電子郵件系統的效能、主動測量及最佳化電子郵件行銷活動，以及改善一段時間的業務開發度。
| 屬性 | 說明 |
|---|---|
TimeGenerated |
產生記錄時的時間戳記 (UTC)。 |
Location |
處理作業的區域。 |
OperationName |
與記錄錄製相關聯的作業。 |
OperationVersion |
與作業相關聯的 api-version (如果使用 API 執行 operationName 的話)。 如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業建立關聯的屬性在未來變更。 |
Category |
事件的記錄類別。 類別是您可在特定資源上啟用或停用記錄的資料粒度。 事件之屬性 Blob 內顯示的屬性，會與特定記錄類別和資源類型內的屬性相同。 |
CorrelationID |
相互關聯事件的識別碼。 可用來識別多個資料表之間的相互關聯事件。 對於所有電子郵件作業記錄，CorrelationId 會對應至從成功的 SendMail 要求傳回的 MessageId。 |
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"
}