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	要求で使用されたプラットフォームの種類。