次の方法で共有

SMS ログ

Azure Communication Services には、Communication Services ソリューションの監視とデバッグに使用できるログ機能が用意されています。 これらの機能は、Azure portal を使用して構成できます。

重要

この記事では、 Azure Monitor で有効になっているログについて説明します。FAQ も参照 してください。 Communications Services でこれらのログを有効にするには、「 診断設定でのログ記録を有効にする」を参照してください。

[前提条件]

Azure Communication Services では、Azure Monitor ログと Azure Monitor メトリックを介して、監視と分析の機能を提供しています。

各 Azure リソースには、次の条件を定義する独自の診断設定が必要です。

  • 設定で定義されている送信先に送信されるログとメトリック データのカテゴリ。 使用できるカテゴリは、リソースの種類によって異なります。
  • ログを送信する 1 つ以上の送信先。 現在の送信先には、Log Analytics ワークスペース、Event Hubs、Azure Storage が含まれます。
  • 1 つの診断設定では、各宛先を 1 つだけ定義することができます。 特定の種類の複数の宛先 (たとえば、2 つの異なる Log Analytics ワークスペース) にデータを送信する場合は、複数の設定を作成する必要があります。 各リソースには、最大 5 つの診断設定を作成できます。

Communications Services のログとメトリックの作成を開始するように Azure Monitor リソースを構成するには、次の手順を実行します。 すべての Azure リソースで診断設定を使用する方法の詳細については、「 診断設定でログ記録を有効にする」を参照してください。

メモ

SMS のログを有効にするには、診断設定名で [ SMS 操作] を選択します。

概要

SMS 操作ログは、SMS API 要求に関する分析情報を提供するイベントとアクティビティの記録です。 SMS のパフォーマンスと機能に関する詳細がログに記録されます。 詳細には、メッセージの状態、メッセージが正常に配信されたか、ブロックされたか、または送信に失敗したかが含まれます。

SMS 操作ログには、傾向とパターンの特定、失敗したメッセージ配信などのパフォーマンスに影響を与える可能性のある問題の解決、または問題の処理に役立つ情報が含まれています。 ログには、次の詳細が含まれます。

  • 送信されたメッセージ。
  • 受信したメッセージ。
  • 配信されたメッセージ。
  • メッセージのオプトインとオプトアウト。

リソース ログのカテゴリ

Communication Services には、次の種類のログが用意されています。

  • 利用状況ログ - 課金の対象となる各サービス内容に関連付けられた利用状況データを提供します。
  • SMS 操作ログ - SMS サービスに関連した基本的な情報を提供します。

利用状況ログのスキーマ

プロパティ 説明
Timestamp ログが生成された時刻のタイムスタンプ (UTC)。
Operation Name ログ レコードに関連付けられている操作。
Operation Version API を使用して operationName が実行された場合は、操作に関連付けられている api-version。 この操作に対応する API がない場合、後で操作に関連付けられているプロパティが変更された場合に備えて、バージョンはその操作のバージョンを表します。
Category イベントのログ カテゴリ。 カテゴリは細分化されており、これを使用して、特定のリソースのログを有効または無効にすることができます。 イベントのプロパティ BLOB 内に表示されるプロパティは、特定のログ カテゴリとリソースの種類内のものと同じです。
Correlation ID 相関性があるイベントの ID。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます。
Properties Communication Services の各種モードに該当するその他のデータ。
Record ID 特定の利用状況レコードの一意の ID。
Usage Type 使用モード チャット、PSTN、NAT など。
Unit Type 特定の使用モードに関する使用量の基準となる単位の種類 分、メガバイト、メッセージなど。
Quantity そのレコードに関して使用または消費された単位の数。

SMS 操作ログ

プロパティ 説明
TimeGenerated ログが生成された時刻のタイムスタンプ (UTC)。
OperationName ログ レコードに関連付けられている操作。
CorrelationID 相関性があるイベントの ID。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます。
OperationVersion operationName が API を使用して実行された場合は、操作に関連付けられている api-version。 この操作に対応する API がない場合、後で操作に関連付けられているプロパティが変更された場合に備えて、バージョンはその操作のバージョンを表します。
Category イベントのログ カテゴリ。 カテゴリは細分化されており、これを使用して、特定のリソースのログを有効または無効にすることができます。 イベントのプロパティ BLOB のプロパティは、特定のログ カテゴリとリソースの種類内で同じです。
ResultType 操作の状態。
ResultSignature 操作のサブ状態。 この操作が REST API 呼び出しに対応している場合、このフィールドは、対応する REST 呼び出しの HTTP 状態コードです。
ResultDescription この操作を説明する静的テキスト。
DurationMs 操作時間 (ミリ秒)。
CallerIpAddress 操作が、一般的に利用できる IP アドレスを持つエンティティからの API 呼び出しに対応している場合は、呼び出し元 IP アドレス。
Level イベントの重大度レベル。
URI 要求の URI。
OutgoingMessageLength 送信メッセージに含まれる文字数。
IncomingMessageLength 受信メッセージに含まれる文字数。
DeliveryAttempts このメッセージの配信試行回数。
PhoneNumber 携帯ショートメール (SMS) メッセージの送信元である電話番号。
SdkType 要求で使用された SDK の種類。
PlatformType 要求で使用されたプラットフォームの種類。
Method 要求で使用されたメソッド。
NumberType 携帯ショートメール (SMS) メッセージの送信元である電話番号の型。 LongCodeNumber、ShortCodeNumber、DynamicAlphaSenderID のいずれかを指定できます。
MessageID すべての送信メッセージと受信メッセージに対して生成される一意のメッセージ ID を表します。 SMS API 応答オブジェクトで MessageId を見つけます。 この API によって返されるメッセージ ID の形式は、内部実装の詳細と見なされ、予告なしに変更される可能性があります。 クライアントはメッセージ ID を不透明な識別子として扱う必要があり、形式や内容に基づいて構造を解析、推論、またはロジックを構築してはなりません。
Country SMS メッセージの送受信先の国/地域を表します。

SMS 送信ログの例


    [
      {
        "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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

SMS 配信レポート ログの例


    [
      {
        "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": "ff00e5c9-876d-4958-86e3-4637484fe5bd",
        "Country": "US"
      }
    ]

SMS 受信ログの例


    [
      {
        "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": "11c6ee31-63fe-477c-8d51-f800543c6694",
        "Country": "US"
      }
    ]

SMS に関するよくあるご質問