GraphQL 作業
GraphQL 作業記錄是工作區監視記錄的一部分，而且會註冊在 Eventhouse KQL 資料庫中，這是即時智慧解決方案的一部分。 您可以使用這些記錄來監視工作區的使用方式和效能。
GraphQL 作業記錄
網狀架構 API 在其連接的數據源上執行之每個查詢的記錄事件會儲存在兩個數據表中： GraphQLMetrics 和 GraphQLLog。
使用查詢記錄來：
- 識別行為變更和潛在的 API 降低。
- 偵測異常或大量資源的查詢。
- 識別具有最高查詢數目的用戶和應用程式
- 分析查詢效能和趨勢。
- 針對慢速查詢進行疑難解答。
- 診斷特定 GraphQL 查詢的問題。
下表列出 GraphQL 記錄。
| 資料行名稱 | 類型 | 描述 |
|---|---|---|
| 時間戳記 | Datetime | 當數據源建立記錄時產生記錄項目的時間戳 （UTC）。 |
| ItemId | 字串 | 記錄數據之資源的唯一標識碼。 |
| ItemKind | 字串 | 記錄作業的成品類型。 |
| ItemName | 字串 | 此作業記錄網狀架構成品的名稱。 |
| WorkspaceId | 字串 | 包含所操作成品之 Fabric 工作區的唯一標識碼 |
| WorkspaceName | 字串 | 包含成品的 Fabric 工作區名稱。 |
| CapacityId | 字串 | 裝載所操作成品之容量的唯一標識碼。 |
| CustomerTenantId | 字串 | 執行作業的客戶租用戶標識碼。 |
| PlatformMonitoringTableName | 字串 | 記錄的數據表名稱屬於 （或記錄的認證事件類型）。 格式為 <WorkloadName> + [OperationType>]+ <TelemetryType> |
| 區域 | 字串 | 發出事件之資源的區域;例如，美國東部或法國南部。 |
| MetricTimeGrain | 字串 | 計量的時間粒紋（ISO 8601 持續時間）。 |
| MetricUnitName | 字串 | 計量的單位。 |
| MetricSumValue | long | 在單一分鐘內，計量的匯總總和值。 |
| DatasourceTypes | dynamic | 模型所使用的 DataSource 型別數位列。 |
| ResultCode | 字串 | 錯誤碼失敗的活動，用來將使用量擴充至可靠性。 |
| 狀態 | 字串 | 作業的狀態。 查詢已成功/成功執行，並出現錯誤/失敗。 |
GraphQL 記錄屬性
下表描述 GraphQLLogs 屬性。 如需事件和向下切入 ExecutionMetrics 事件的詳細資訊，請參閱 事件和架構。
| 資料行名稱 | 類型 | 描述 |
|---|---|---|
| 時間戳記 | Datetime | 當數據源建立記錄時產生記錄項目的時間戳 （UTC）。 |
| OperationName | 字串 | 作業的名稱。 |
| ItemId | 字串 | 記錄數據之資源的唯一標識碼。 |
| ItemKind | 字串 | 記錄作業的成品類型。 |
| ItemName | 字串 | 此作業記錄網狀架構成品的名稱。 |
| WorkspaceId | 字串 | 包含所操作成品之 Fabric 工作區的唯一標識碼。 |
| WorkspaceName | 字串 | 包含成品的 Fabric 工作區名稱。 |
| CapacityId | 字串 | 裝載所操作成品之容量的唯一標識碼。 |
| CorrelationId | 字串 | 根活動標識碼。 |
| OperationId | 字串 | 要記錄之作業的唯一標識碼。 |
| 身分識別 | dynamic | 使用者和宣告詳細數據。 與所報告之作業相關聯的使用者。 |
| CustomerTenantId | 字串 | 執行作業的客戶租用戶標識碼。 |
| DurationMs | long | 經過所有必要作業時經過的CPU時間。 單位以毫秒為單位。 |
| 狀態 | 字串 | 作業的狀態。 查詢已成功/成功執行，並出現錯誤/失敗。 |
| 層級 | 字串 | 平臺監視小組所需的元數據。 |
| 區域 | 字串 | 發出事件之資源的區域;例如，美國東部或法國南部。 |
| PlatformMonitoringTableName | 字串 | 記錄的數據表名稱屬於 （或記錄的認證事件類型）。 格式為 <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | 字串 | 查詢的文字。 |
| GraphQLOverheadDurationMs | long | 數據平面要求的 ms 中的 GraphQL 額外負荷。 |
| ProcessedBytes | long | 已以位元組為單位處理的數據量。 |
| TransportProtocol | 字串 | 要求的傳輸通訊協定。 |
| QueryResultMessage | 字串 | 這個維度可用來為查詢作業的結果提供其他內容。 |
範例查詢
您可以在網狀架構範例 GitHub 存放庫中尋找範例查詢。