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