メトリック
メトリック テーブルには、リアルタイム インテリジェンスの一部である Eventhouse KQL データベースのインジェスト、具体化されたビュー、連続エクスポートの詳細が含まれています。 メトリックごとに、ログ イベント レコードが EventhouseMetrics テーブルに保存されます。
メトリック操作ログ
メトリックは次の目的で使用します。
- インジェストのパフォーマンスと傾向を分析する。
- バッチとストリーミングのインジェストを監視する
- インジェスト エラーのトラブルシューティング。
- インジェスト フローについて詳しく調べる。
- 具体化されたビューの監視と正常性。
- 連続エクスポートのモニタリング。
次の表では、EventhouseMetrics テーブルに保存される列について説明します。
| 列名 | 種類 | 説明 |
|---|---|---|
| CapacityId | string | Fabric の容量識別子。 |
| CustomerTenantId | string | 顧客テナント識別子。 |
| DurationMs | long | 該当なし。 |
| ItemId | string | Fabric Eventhouse アイテムの識別子 |
| ItemKind | string | Fabric アイテムの種類。 有効な値: Eventhouse。 |
| ItemName | string | Fabric Eventhouse アイテムの名前。 |
| Level | string | 該当なし。 |
| MetricCount | long | メトリック数の値。 |
| MetricMaxValue | long | メトリックの最大値。 |
| MetricMinValue | long | メトリックの最小値。 |
| MetricName | string | メトリック名。 |
| MetricSpecificDimensions | 動的 | 「メトリック固有のディメンション列」で説明されている、各メトリックの特定のディメンション。 関連する場合は、ディメンションの説明がメトリックの説明の一部として提供されます。 |
| MetricSumValue | long | メトリックの合計値。 |
| OperationName | string | 実行された操作の名前。 |
| リージョン | string | Fabric KQL データベースが配置されているリージョン。 |
| Timestamp | datetime | イベントが生成された時刻 (UTC)。 |
| WorkspaceId | string | ワークスペースの識別子。 |
| WorkspaceMonitoringTableName | string | ワークスペース監視テーブルの名前。 有効な値: EventhouseQueryLogs |
| WorkspaceName | string | ワークスペースの名前。 |
メトリック固有のディメンション列
次の表に、報告されるすべての Eventhouse メトリックと、各メトリックについて報告される特定のディメンションの一覧を示します。
| 指標の種類 | MetricName | 出荷単位 | 集計 | 説明 | メトリック固有のディメンション |
|---|---|---|---|---|---|
| インジェスト | BatchBlobCount | カウント | Avg、Max、Min | 完了したバッチで取り込まれたデータ ソースの数。 | Database、Table |
| インジェスト | BatchDurationSec | 秒 | Avg、Max、Min | インジェスト フロー内のバッチ処理フェーズの期間。 | Database、Table |
| インジェスト | BatchSizeBytes | バイト | Avg、Max、Min | 集計されたインジェスト バッチで、予想される非圧縮のデータ サイズ。 | Database、Table |
| インジェスト | BatchesProcessed | カウント | Sum、Max、Min | 完了したインジェスト バッチの数。 | Database、Table、Batching Type |
| インジェスト | BlobsDropped | カウント | Sum、Max、Min | コンポーネントによって完全に破棄された BLOB の数。各失敗理由は IngestionResult メトリックに記録されます。 |
Database、Table、ComponentType、ComponentName |
| インジェスト | BlobsProcessed | カウント | Sum、Max、Min | コンポーネントによって処理された BLOB の数。 | Database、Table、ComponentType、ComponentName |
| インジェスト | BlobsReceived | カウント | Sum、Max、Min | コンポーネントが入力ストリームから受信した BLOB の数。 | Database、ComponentType、ComponentName |
| Export | ContinuousExportRecordsCount | Count | 合計 | すべての連続エクスポート ジョブでエクスポートされたレコードの数。 | Database、ContinuousExportName |
| Export | ContinuousExportMaxLateness | カウント | Max | KQL データベース内の連続エクスポート ジョブによって報告された遅延 (分) | |
| Export | ContinousExportPendingCount | カウント | Max | 実行する準備はできているが、おそらく容量不足が原因でキューで待機している保留中の連続エクスポート ジョブの数。 | |
| Export | ContinuousExportResult | 各連続エクスポート実行の失敗および成功の結果。 | ContinuousExportName | 失敗または成功を示す各連続エクスポート実行の結果。 | ContinuousExportName |
| インジェスト | DiscoveryLatencyInSeconds | 秒 | Avg | データがエンキューされてからデータ接続によって検出されるまでの時間。 この時間は、"ステージの待機時間" または "インジェストの待機時間" メトリックには含まれません。 検出の待機時間は、次のような状況で増加する可能性があります。 |
ComponentType、ComponentName |
| インジェスト | EventsDropped | カウント | Sum、Max、Min | データ接続によって破棄されたイベントの数。 | ComponentType、ComponentName |
| インジェスト | EventsProcessed | カウント | Sum、Max、Min | データ接続によって処理されたイベントの数。 | ComponentType、ComponentName |
| インジェスト | EventsReceived | カウント | Sum、Max、Min | 入力ストリームからのデータ接続によって受信されたイベントの数。 | ComponentType、ComponentName |
| インジェスト | IngestionLatencyInSeconds | 秒 | Avg、Max、Min | データがクラスターで受信されてからクエリの準備ができるまでにかかる時間。 この時間は、ストリーミング インジェストやキューによるインジェストなど、インジェストの種類によって異なります。 | IngestionKind |
| インジェスト | IngestionResult | Count | 合計 | 正常に取り込まれたか、取り込みに失敗したソースの合計数。 詳細については、「ディメンションの説明」を参照してください | Database、Table、IngestionResultDetails、FailureKind、ViaUpdatePolicy |
| インジェスト | IngestionVolumeInBytes | カウント | Max、Sum | 圧縮前に KQL データベースに取り込まれたデータの合計サイズ (バイト)。 | Database、Table |
| 具体化されたビュー | MaterializedViewAgeSeconds | 秒 | Avg | ビューの経過期間 (分) は、現在の時刻から、ビューによって処理された最後のインジェスト時間を引いた値で定義されます。 値が低いほど、ビューの正常性が高いことを示します。 | Database、MaterializedViewName |
| 具体化されたビュー | MaterializedViewHealth | 1、0 | Avg | 値 1 は、ビューが正常と見なされていることを示します。それ以外の場合、値は 0 です。 | Database、MaterializedViewName |
| 具体化されたビュー | MaterializedViewResult | 1 | Avg | メトリック値は常に 1 です。 Result は、最後の具体化サイクルの結果を示します。 指定できる値については、「MaterializedViewResult」を参照してください。 |
Database、MaterializedViewName、Result |
| インジェスト | QueueLength | カウント | Avg | コンポーネントの入力キュー内の保留中のメッセージの数。 バッチ処理コンポーネントは BLOB ごとに 1 つのメッセージを処理し、インジェスト コンポーネントはバッチごとに 1 つのメッセージを処理します。 バッチは、1 つ以上の BLOB を含む単一のインジェスト コマンドで構成されます。 | ComponentType |
| インジェスト | QueueOldestMessage | 秒 | Avg | コンポーネントの入力キュー内に最も古いメッセージが挿入されてからの経過時間 (秒)。 | ComponentType |
| インジェスト | ReceivedDataSizeBytes | バイト | Avg、Sum | 入力ストリームからのデータ接続によって受信されたデータのサイズ。 | ComponentType、ComponentName |
| StreamingIngestion | StreamingIngestDataRate | バイト | Count、Avg、Max、Min、Sum | ストリーミング インジェストによって取り込まれたデータの合計量。 | Database、Table |
| StreamingIngestion | StreamingIngestDuration | Milliseconds | Avg、Max、Min | すべてのストリーミング インジェスト要求の合計期間。 | なし |
ディメンションの説明
次の一覧では、IngestionResult メトリックで報告されるディメンションについて説明します。
IngestionResultDetails: インジェストが成功した場合は成功、失敗した場合は失敗カテゴリ。 考えられる失敗カテゴリの完全な一覧については、「インジェスト エラー コード」を参照してください。FailureKind: 失敗が永続的か一時的か。 インジェストが成功した場合の値はNoneです。ViaUpdatePolicy: インジェストが更新ポリシーによってトリガーされた場合は True。
Note
- Event Hubs および IoT Hub のインジェスト イベントは、1 つの BLOB に事前集計された後、単一のインジェスト ソースとして扱われます。 これらは、事前集計後に単一のインジェスト結果として表示されます。
- 一時的な障害は、限られた回数だけ内部的に再試行されます。 一時的な失敗はそれぞれ一時的なインジェスト結果として報告されます。つまり、1 回のインジェストで複数のインジェスト結果が生成される場合があります。
サンプル クエリ
サンプル クエリは、GitHub リポジトリ fabric-samples にあります。