次の方法で共有


Azure Communication Services チャットのログ

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

重要

以下では、Azure Monitor を使用して有効化するログについて言及しています (「FAQ」も参照)。 Communications Services 用にこれらのログを有効化する方法については、診断設定でのログの有効化に関するページを参照してください。

リソース ログのカテゴリ

Communication Services には、有効にできる次のログが用意されています。

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

利用状況ログのスキーマ

プロパティ 説明
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 そのレコードに関して使用または消費された単位の数。

認証操作ログ

プロパティ 説明
TimeGenerated ログが生成された時刻のタイムスタンプ (UTC)。
OperationName ログ レコードに関連付けられている操作。
CorrelationID 相関性があるイベントの ID。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます。
OperationVersion API を使用して operationName が実行された場合は、その操作に関連付けられている api-version。 この操作に対応する API がない場合、その操作に関連付けられているプロパティが将来変更された場合に備えて、バージョンはその操作のバージョンを表します。
Category イベントのログ カテゴリ。 カテゴリは細分化されており、これを使用して、特定のリソースのログを有効または無効にすることができます。 イベントのプロパティ BLOB 内に表示されるプロパティは、特定のログ カテゴリとリソースの種類内のものと同じです。
ResultType 操作の状態。
ResultSignature 操作のサブステータス。 この操作が REST API 呼び出しに対応している場合、このフィールドは、対応する REST 呼び出しの HTTP 状態コードです。
DurationMs 操作時間 (ミリ秒)。
CallerIpAddress 操作が、一般的に利用できる IP アドレスを持つエンティティからの API 呼び出しに対応している場合は、呼び出し元 IP アドレス。
Level イベントの重大度レベル。
URI 要求の URI。
SdkType 要求で使用された SDK の種類。
PlatformType 要求で使用されたプラットフォームの種類。
Identity 操作に関連するAzure Communication Services または Teams ユーザーの ID。
Scopes アクセス トークンに含まれる Communication Services のスコープ。

チャット操作ログ

プロパティ 説明
TimeGenerated ログが生成された時刻のタイムスタンプ (UTC)。
OperationName ログ レコードに関連付けられている操作。
CorrelationID 相関性があるイベントの ID。 複数のテーブル間で相関性のあるイベントを特定する際に使用できます。
OperationVersion operationName が API を使用して実行された場合は、操作に関連付けられている api-version。 この操作に対応する API がない場合、その操作に関連付けられているプロパティが将来変更された場合に備えて、バージョンはその操作のバージョンを表します。
カテゴリ イベントのログ カテゴリ。 カテゴリは細分化されており、これを使用して、特定のリソースのログを有効または無効にすることができます。 イベントのプロパティ BLOB 内に表示されるプロパティは、特定のログ カテゴリとリソースの種類内のものと同じです。
ResultType 操作の状態。
ResultSignature 操作の副状態。 この操作が REST API 呼び出しに対応している場合、このフィールドは、対応する REST 呼び出しの HTTP 状態コードです。
ResultDescription この操作を説明する静的テキスト。
DurationMs 操作時間 (ミリ秒)。
CallerIpAddress 操作が、一般的に利用できる IP アドレスを持つエンティティからの API 呼び出しに対応している場合は、呼び出し元 IP アドレス。
Level イベントの重大度レベル。
URI 要求の URI。
UserId 要求の送信者のユーザー ID。
ChatThreadId 要求に関連付けられているチャット スレッド ID。
ChatMessageId 要求に関連付けられているチャット メッセージ ID。
SdkType 要求で使用された SDK の種類。
PlatformType 要求で使用されたプラットフォームの種類。