GraphQL の操作
GraphQL 操作ログは、ワークスペース監視ログの一部であり、リアルタイム インテリジェンス ソリューションの一部である Eventhouse KQL データベースに登録されます。 これらのログを使用して、ワークスペースの使用状況とパフォーマンスを監視できます。
GraphQL 操作ログ
GraphQL 用 Fabric API によって実行される接続されたデータ ソースに対する各クエリのログ イベントは、GraphQLMetrics と GraphQLLog の 2 つのテーブルに保存されます。
クエリ ログは次の目的で使用します。
- 動作の変更や潜在的な API のパフォーマンス低下を特定する。
- 通常とは異なるクエリまたはリソース使用量が多いクエリを検出する。
- 最も多くのクエリを実行しているユーザーやアプリケーションを特定する。
- クエリのパフォーマンスと傾向を分析する。
- 遅いクエリのトラブルシューティングを行う。
- 特定の GraphQL クエリに関する問題を診断する。
この表に GraphQL ログの一覧を示します。
| 列名 | 種類 | 説明 |
|---|---|---|
| Timestamp | datetime | データ ソースによってレコードが作成されたときに生成されたログ エントリのタイムスタンプ (UTC)。 |
| ItemId | string | データをログに記録しているリソースの一意の ID。 |
| ItemKind | string | 操作をログに記録しているアーティファクトの種類。 |
| ItemName | string | この操作をログに記録している Fabric アーティファクトの名前。 |
| WorkspaceId | string | 操作されているアーティファクトが含まれる Fabric ワークスペースの一意識別子。 |
| WorkspaceName | string | アーティファクトが含まれる Fabric ワークスペースの名前。 |
| CapacityId | string | 操作されているアーティファクトをホストしている容量の一意識別子。 |
| CustomerTenantId | string | 操作が実行された顧客テナント ID。 |
| PlatformMonitoringTableName | string | レコードが属するテーブルの名前 (またはレコードの認定イベントの種類)。 形式は <WorkloadName> + [OperationType>] + <TelemetryType> です |
| リージョン | string | イベントを出力するリソースのリージョン (例: 米国東部またはフランス南部)。 |
| MetricTimeGrain | string | メトリックの期間粒度 (ISO 8601 期間)。 |
| MetricUnitName | string | メトリックの単位。 |
| MetricSumValue | long | 1 分間のメトリックの合計値の集計。 |
| DatasourceTypes | 動的 | モデルで使用されるデータソースの種類の配列。 |
| ResultCode | string | 失敗したアクティビティのエラー コード。使用状況を信頼性に拡張するために使用されます。 |
| 状態 | string | 操作の状態。 クエリは正常に実行されました/成功しましたがエラーが発生しました/失敗しました。 |
GraphQL ログ属性
次の表では、GraphQLLogs 属性について説明します。 イベントの詳細と ExecutionMetrics イベントへのドリルダウンについては、「イベントとスキーマ」を参照してください。
| 列名 | 種類 | 説明 |
|---|---|---|
| Timestamp | datetime | データ ソースによってレコードが作成されたときに生成されたログ エントリのタイムスタンプ (UTC)。 |
| OperationName | string | 操作の名前。 |
| ItemId | string | データをログに記録しているリソースの一意の ID。 |
| ItemKind | string | 操作をログに記録しているアーティファクトの種類。 |
| ItemName | string | この操作をログに記録している Fabric アーティファクトの名前。 |
| WorkspaceId | string | 操作されているアーティファクトが含まれる Fabric ワークスペースの一意識別子。 |
| WorkspaceName | string | アーティファクトが含まれる Fabric ワークスペースの名前。 |
| CapacityId | string | 操作されているアーティファクトをホストしている容量の一意識別子。 |
| CorrelationId | string | ルート アクティビティ ID。 |
| OperationId | string | ログに記録されている操作の一意識別子。 |
| ID | 動的 | ユーザーとクレームの詳細。 報告されている操作に関連付けられているユーザー。 |
| CustomerTenantId | string | 操作が実行された顧客テナント ID。 |
| DurationMs | long | 必要なすべての操作が処理されている間に経過した CPU 時間。 単位はミリ秒単位です。 |
| 状態 | string | 操作の状態。 クエリは正常に実行されました/成功しましたがエラーが発生しました/失敗しました。 |
| Level | string | プラットフォーム監視チームに必要なメタデータ。 |
| リージョン | string | イベントを出力するリソースのリージョン (例: 米国東部またはフランス南部)。 |
| PlatformMonitoringTableName | string | レコードが属するテーブルの名前 (またはレコードの認定イベントの種類)。 形式は <WorkloadName> + [OperationType>] + <TelemetryType> です |
| QueryText | string | クエリのテキスト。 |
| GraphQLOverheadDurationMs | long | データプレーン要求の GraphQL オーバーヘッド (ミリ秒)。 |
| ProcessedBytes | long | 処理されたデータ ボリューム (バイト単位)。 |
| TransportProtocol | string | 要求のトランスポート プロトコル。 |
| QueryResultMessage | string | このディメンションは、クエリ操作の結果にコンテキストを追加するために使用されます。 |
サンプル クエリ
サンプル クエリは、GitHub リポジトリ fabric-samples にあります。