Azure 通訊服務簡訊 (功能) 記錄

發行項
04/26/2024

Azure 通訊服務會提供記錄功能，以供您監視通訊服務解決方案並對其進行偵錯。這些功能可透過 Azure 入口網站來設定。

重要

以下是指透過 Azure 監視器啟用的記錄 (另請參閱常見問題) 。若要為您的通訊服務啟用這些記錄，請參閱：在診斷設定中啟用記錄

必要條件

Azure 通訊服務透過 Azure 監視器記錄概觀和 Azure 監視器計量提供監視和分析功能。每個 Azure 資源都需要自己的診斷設定，其會定義下列準則：

傳送至設定中所定義目的地的記錄和計量資料類別。可用的類別會因不同的資源類型而有所不同。
一個或多個要傳送記錄的目的地。目前的目的地包括 Log Analytics 工作區、事件中樞和 Azure 儲存體。
單一診斷設定可以定義每個目的地不超過一個。如果您想要將資料傳送至超過一個的特定目的地類型 (例如，兩個不同的 Log Analytics 工作區)，則請建立多個設定。每個資源最多可以有五個診斷設定。

下列指示能幫助您設定 Azure 監視器資源，讓您開始為 Azure 通訊服務建立記錄和計量。如需在所有 Azure 資源中使用診斷設定的詳細文件，請參閱在診斷設定中啟用記錄

注意

在 [診斷設定名稱] 底下，請選取 [簡訊作業] 以啟用簡訊的記錄。

概觀

簡訊作業記錄是事件和活動的記錄，可提供簡訊 API 要求的深入解析。這會擷取有關簡訊基本類型的效能和功能詳細資料，包括訊息狀態的詳細資料，不論訊息是否已成功傳遞、封鎖或無法傳送。簡訊作業記錄包含有助於識別趨勢和模式的資訊、解決可能會影響效能的問題，例如訊息傳遞失敗或服務問題。記錄包含下列詳細資料:

已傳送的訊息。
已接收的訊息。
已傳遞的訊息。
選擇加入和退出的訊息。

資源記錄類別

通訊服務提供下列類型的記錄供您啟用：

使用量記錄 - 提供與每個計費服務供應項目相關聯的使用量資料
簡訊作業記錄 - 提供與簡訊服務相關的基本資訊

使用量記錄結構描述

屬性	說明
`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`	此記錄所使用或取用的單位數。

簡訊作業記錄

屬性	說明
`TimeGenerated`	產生記錄時的時間戳記 (UTC)。
`OperationName`	與記錄相關聯的作業。
`CorrelationID`	相互關聯事件的識別碼。可用來識別多個資料表之間的相互關聯事件。
`OperationVersion`	與作業相關聯的 api-version (如果使用 API 執行 operationName 的話)。如果沒有對應至此作業的 API，則版本代表該作業的版本，以防與作業建立關聯的屬性在未來變更。
`Category`	事件的記錄類別。類別是您可在特定資源上啟用或停用記錄的資料粒度。事件之屬性 Blob 內顯示的屬性，會與特定記錄類別和資源類型內的屬性相同。
`ResultType`	作業的狀態。
`ResultSignature`	作業的子狀態。如果此作業對應至 REST API 呼叫，則此欄位是對應 REST 呼叫的 HTTP 狀態碼。
`ResultDescription`	此作業的靜態文字描述。
`DurationMs`	作業的持續時間 (以毫秒為單位)。
`CallerIpAddress`	呼叫端 IP 位址，如果作業對應至來自具有公開可用 IP 位址之實體的 API 呼叫。
`Level`	事件的嚴重性層級。
`URI`	要求的 URI。
`OutgoingMessageLength`	外寄訊息中的字元數。
`IncomingMessageLength`	內送訊息中的字元數。
`DeliveryAttempts`	為了傳遞此訊息所嘗試的次數。
`PhoneNumber`	送出手機簡訊的電話號碼。
`SdkType`	在要求中使用的 SDK 類型。
`PlatformType`	在要求中使用的平台類型。
`Method`	在要求中使用的方法。
`NumberType`	送出手機簡訊的號碼類型。其可以是 LongCodeNumber 或 ShortCodeNumber 或 DynamicAlphaSenderID
`MessageID`	代表針對每個傳出和傳入訊息所產生的唯一 messageId。這可以在簡訊 API 回應物件中找到
`Country`	代表傳送或接收簡訊訊息的國家/地區

簡訊傳送記錄的範例


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.100Z",
        "OperationName": "SMSMessagesSent",
        "CorrelationId": "dDRmubfpNZZZZZnxBtw3Q.0",
        "OperationVersion": "2020-07-20-preview1",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 202,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://sms-e2e-prod.communication.azure.com/sms?api-version=2020-07-20-preview1",
        "OutgoingMessageLength": 151,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "azsdk-net-Communication.Sms",
        "PlatformType": "Microsoft Windows 10.0.17763",
        "Method": "POST",
        "MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

簡訊傳遞報告記錄的範例


    [
      {
        "TimeGenerated": "2022-09-26T15:58:30.200Z",
        "OperationName": "SMSDeliveryReportsReceived",
        "CorrelationId": "tl8WpUTESTSTSTccYadXJm.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/DeliveryReport",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 0,
        "DeliveryAttempts": 1,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "Outgoing_20230118181300ff00e5c9-876d-4958-86e3-4637484fe5bd_noam",
        "Country": "US"
      }
    ]

簡訊接收記錄的範例


    [
      {
        "TimeGenerated": "2022-09-27T15:58:30.200Z",
        "OperationName": "SMSMessagesReceived",
        "CorrelationId": "e2KFTSTSTI/5PTx4ZZB.0",
        "Category":"SMSOperational",
        "ResultType": "Succeeded",
        "ResultSignature": 200,
        "DurationMs": 130,
        "CallerIpAddress": "127.0.0.1",
        "Level": "Informational",
        "URI": "https://global.smsgw.prod.communication.microsoft.com/rtc/telephony/sms/inbound",
        "OutgoingMessageLength": 0,
        "IncomingMessageLength": 110,
        "DeliveryAttempts": 0,
        "PhoneNumber": "+18445791704",
        "NumberType": "LongCodeNumber",
        "SdkType": "",
        "PlatformType": "",
        "Method": "POST",
        "MessageId": "Incoming_2023011818121211c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

(另請參閱常見問題)。

共用方式為