GraphQL 操作日志是工作区监视日志的一部分，是在 Eventhouse KQL 数据库中注册的，该数据库是实时智能解决方案的一部分。 可以使用这些日志来监视工作区的使用情况和性能。
GraphQL 操作日志
Fabric API for GraphQL 在其连接的数据源上运行的每个查询的日志事件存储在两个表中：GraphQLMetrics，GraphQLLog。
使用查询日志可以：
- 确定行为更改和潜在的 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 | 单个分钟内指标的聚合总和值。 |
| DatasourceTypes | 动态 | 模型使用的 DataSource 类型的数组。 |
| ResultCode | string | 失败活动的错误代码，用于将使用情况扩展到可靠性。 |
| Status | 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 | 要记录的操作的唯一标识符。 |
| 标识 | 动态 | 用户和声明详细信息。 与所报告操作关联的用户。 |
| CustomerTenantId | string | 执行操作的客户租户 ID。 |
| DurationMs | long | 处理所有必需操作时经过的已用 CPU 时间。 单位为毫秒。 |
| Status | string | 操作的状态。 查询成功/成功执行，并出现错误/失败。 |
| 级别 | string | 平台监视团队所需的元数据。 |
| 区域 | string | 发出事件的资源区域；例如美国东部或法国南部。 |
| PlatformMonitoringTableName | string | 记录的表的名称属于记录（或记录的认证事件类型）。 格式为 <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | string | 查询的文本。 |
| GraphQLOverheadDurationMs | long | 数据平面请求的 GraphQL 开销（以 ms 为单位）。 |
| ProcessedBytes | long | 已处理的数据量（以字节为单位）。 |
| TransportProtocol | string | 请求的传输协议。 |
| QueryResultMessage | string | 此维度用于为查询操作的结果提供其他上下文。 |
示例查询
可以在 fabric-samples GitHub 存储库中找到示例查询。