指标
指标表包含 Eventhouse KQL 数据库的引入、具体化视图和连续导出的详细信息,该数据库是实时智能的一部分。 对于每个指标,都有一份日志事件记录存储在 EventhouseMetrics 表中。
指标操作日志
使用指标可以:
- 分析引入性能和趋势。
- 监视批处理与流式引入。
- 排查引入失败。
- 深入了解引入流。
- 具体化视图监视和健康状况。
- 连续导出监视。
下表描述了存储在 EventhouseMetrics 表中的列:
列名称 | 类型 | 描述 |
---|---|---|
CapacityId | string | Fabric 容量标识符。 |
CustomerTenantId | string | 客户租户标识符。 |
DurationMs | long | 不适用。 |
ItemId | string | Fabric Eventhouse 项的标识符 |
ItemKind | string | Fabric 项的类型。 有效值:Eventhouse。 |
ItemName | string | Fabric Eventhouse 项的名称。 |
级别 | string | 不适用。 |
MetricCount | long | 指标计数值。 |
MetricMaxValue | long | 指标最大值。 |
MetricMinValue | long | 指标最小值。 |
MetricName | string | 指标名称。 |
MetricSpecificDimensions | 动态 | 每个指标的特定维度,如指标特定维度列中所述。 在相关的情况下,维度说明作为指标说明的一部分提供。 |
MetricSumValue | long | 指标总和值。 |
OperationName | string | 所执行的操作的名称。 |
区域 | string | Fabric KQL 数据库所在的区域。 |
时间戳 | datetime | 事件生成的时间 (UTC)。 |
WorkspaceId | string | 工作区的标识符。 |
WorkspaceMonitoringTableName | string | 工作区监视表的名称。 有效值:EventhouseQueryLogs |
WorkspaceName | string | 工作区的名称。 |
指标特定维度列
下表包含所有报告的 Eventhouse 指标的列表,以及为每个指标报告的特定维度。
指标类型 | MetricName | 单位 | 聚合 | 说明 | 指标特定维度 |
---|---|---|---|---|---|
引流 | BatchBlobCount | 计数 | Avg、Max、Min | 在已完成的批处理中引入的数据源数。 | 数据库,表 |
引流 | BatchDurationSec | 秒 | Avg、Max、Min | 引入流中批处理阶段的持续时间。 | 数据库,表 |
引流 | BatchSizeBytes | 字节 | Avg、Max、Min | 聚合引入批处理中预期的未压缩数据大小。 | 数据库,表 |
引流 | BatchesProcessed | 计数 | Sum、Max、Min | 已完成的引入批处理数。 | 数据库、表、批处理类型 |
引流 | 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 |
导出 | ContinuousExportRecordsCount | 计数 | Sum | 所有连续导出作业中导出的记录数。 | Database、ContinuousExportName |
导出 | ContinuousExportMaxLateness | 计数 | 最大值 | KQL 数据库中连续导出作业报告的延迟(分钟)。 | |
导出 | ContinousExportPendingCount | 计数 | 最大值 | 已准备好运行但在队列中等待的挂起的连续导出作业数,可能是由于容量不足。 | |
导出 | ContinuousExportResult | 每个连续导出运行的失败/成功结果。 | ContinuousExportName | 每个连续导出运行的结果,指示失败或成功。 | ContinuousExportName |
引流 | DiscoveryLatencyInSeconds | 秒 | 平均值 | 从数据排队到被数据连接发现的时间。 此时间未包括在“阶段延迟”或“引入延迟”指标中。 在以下情况下,发现延迟可能会增加: |
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 | 计数 | 总和 | 成功引入或未能引入的源总数。 有关详细信息,请参阅维度说明 | Database、Table、IngestionResultDetails、FailureKind、ViaUpdatePolicy |
引流 | IngestionVolumeInBytes | 计数 | Max、Sum | 压缩前引入到 KQL 数据库中的数据总大小(字节)。 | 数据库,表 |
具体化视图 | MaterializedViewAgeSeconds | 秒 | 平均值 | 视图的年限(分钟)定义为当前时间减去由视图处理的上次引入时间。 较低的值表示更健康的视图。 | Database、MaterializedViewName |
具体化视图 | MaterializedViewHealth | 1、0 | 平均值 | 值为 1 表示视图被视为正常;否则,该值为 0。 | Database、MaterializedViewName |
具体化视图 | MaterializedViewResult | 1 | 平均值 | 指标值始终为 1。 Result 指示最后一个具体化周期的结果。 有关可能的值,请参阅 MaterializedViewResult 。 |
Database、MaterializedViewName、Result |
引流 | QueueLength | 计数 | Avg | 组件输入队列中挂起的消息数。 批处理组件对每个 Blob 处理一条消息,而引入组件对每个批处理一条消息。 一个批由包含一个或多个 Blob 的单个引入命令组成。 | ComponentType |
引流 | QueueOldestMessage | 秒 | 平均值 | 从在组件的输入队列中插入最早消息开始算起的时间(秒)。 | ComponentType |
引流 | ReceivedDataSizeBytes | 字节 | Avg、Sum | 数据连接从输入流接收的数据的大小。 | ComponentType、ComponentName |
StreamingIngestion | StreamingIngestDataRate | 字节 | Count、Avg、Max、Min、Sum | 流式引入的数据总量。 | 数据库,表 |
StreamingIngestion | StreamingIngestDuration | 毫秒 | Avg、Max、Min | 所有流引入请求的总持续时间。 | 无 |
维度说明
以下列表描述了 IngestionResult
指标中报告的维度:
IngestionResultDetails
:“成功”表示引入成功,失败类别表示失败。 有关可能的失败类别的完整列表,请参阅引入错误代码。FailureKind
:指示失败是永久性的还是暂时性的。 该值对于成功引入为None
。ViaUpdatePolicy
:如果引入是由更新策略触发的,则为 True。
注意
- 事件中心和 IoT 中心引入事件会预先聚合到一个 Blob 中,然后被视为单一引入源。 预聚合后,它们会显示为单个引入结果。
- 暂时性故障会自动重试有限次数。 每个暂时性故障都会报告为暂时性引入结果,这意味着单个引入可能会生成多个引入结果。
示例查询
可以在 fabric-samples GitHub 存储库中找到示例查询。