指标

指标表包含 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 存储库中找到示例查询。