From 2f7e6ac849f97c2ab7fe503ef0dab971114af180 Mon Sep 17 00:00:00 2001 From: brian Date: Fri, 21 Aug 2026 11:15:02 -0700 Subject: [PATCH 1/2] docs: add missing metrics --- docs/operations/metrics.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/operations/metrics.md b/docs/operations/metrics.md index c05f6cc91f9e..c7df87353681 100644 --- a/docs/operations/metrics.md +++ b/docs/operations/metrics.md @@ -440,6 +440,9 @@ These metrics are emitted by the Druid Coordinator in every run of the correspon |Metric|Description|Dimensions|Normal value| |------|-----------|----------|------------| +|`config/brokerSync/time`| Time taken for a Broker to sync with the Coordinator||| +|`config/brokerSync/total/time`|Time taken for all Brokers to sync with the Coordinator +|`config/brokerSync/error`|Number of errors that occurred during Broker synchronization|||0 |`segment/assigned/count`|Number of segments assigned to be loaded in the cluster.|`dataSource`, `tier`|Varies| |`segment/moved/count`|Number of segments moved in the cluster.|`dataSource`, `tier`|Varies| |`segment/dropped/count`|Number of segments chosen to be dropped from the cluster due to being over-replicated.|`dataSource`, `tier`|Varies| @@ -463,6 +466,9 @@ These metrics are emitted by the Druid Coordinator in every run of the correspon |`segment/unavailable/count`|Number of unique segments left to load until all used segments are available for queries.|`dataSource`|0| |`segment/underReplicated/count`|Number of segments, including replicas, left to load until all used segments are available for queries.|`tier`, `dataSource`|0| |`segment/availableDeepStorageOnly/count`|Number of unique segments that are only available for querying directly from deep storage.|`dataSource`|Varies| +|`segment/poll/time`|Time taken to poll for available segments. ||| +|`segment/pollWithSchema/time`|Time taken to poll for segments including schema information.||| +|`segment/buildSnapshot/time`|Time taken to build a snapshot of the current segment state. This tracks the performance of creating a consistent snapshot of all segments.||| |`tier/historical/count`|Number of available historical nodes in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration), and can be used to aggregate metrics across the tiers in an alias.|`tier`, `tierAlias`|Varies| |`tier/replication/factor`|Configured maximum replication factor in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration).|`tier`, `tierAlias`|Varies| |`tier/required/capacity`|Total capacity in bytes required in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration).|`tier`, `tierAlias`|Varies| From 9c1f7d7fbb6cc28be1655e217fff0df0ab60df1c Mon Sep 17 00:00:00 2001 From: brian Date: Fri, 21 Aug 2026 12:20:52 -0700 Subject: [PATCH 2/2] docs: add docs for metrics --- docs/operations/metrics.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/operations/metrics.md b/docs/operations/metrics.md index c7df87353681..34519e364c19 100644 --- a/docs/operations/metrics.md +++ b/docs/operations/metrics.md @@ -440,9 +440,9 @@ These metrics are emitted by the Druid Coordinator in every run of the correspon |Metric|Description|Dimensions|Normal value| |------|-----------|----------|------------| -|`config/brokerSync/time`| Time taken for a Broker to sync with the Coordinator||| -|`config/brokerSync/total/time`|Time taken for all Brokers to sync with the Coordinator -|`config/brokerSync/error`|Number of errors that occurred during Broker synchronization|||0 +|`config/brokerSync/time`| Time in milliseconds for a Broker to sync with the Coordinator||| +|`config/brokerSync/total/time`|Total time in milliseconds taken for all Brokers to sync with the Coordinator +|`config/brokerSync/error`|Emitted when syncing a Broker fails. ||0| |`segment/assigned/count`|Number of segments assigned to be loaded in the cluster.|`dataSource`, `tier`|Varies| |`segment/moved/count`|Number of segments moved in the cluster.|`dataSource`, `tier`|Varies| |`segment/dropped/count`|Number of segments chosen to be dropped from the cluster due to being over-replicated.|`dataSource`, `tier`|Varies| @@ -466,9 +466,9 @@ These metrics are emitted by the Druid Coordinator in every run of the correspon |`segment/unavailable/count`|Number of unique segments left to load until all used segments are available for queries.|`dataSource`|0| |`segment/underReplicated/count`|Number of segments, including replicas, left to load until all used segments are available for queries.|`tier`, `dataSource`|0| |`segment/availableDeepStorageOnly/count`|Number of unique segments that are only available for querying directly from deep storage.|`dataSource`|Varies| -|`segment/poll/time`|Time taken to poll for available segments. ||| -|`segment/pollWithSchema/time`|Time taken to poll for segments including schema information.||| -|`segment/buildSnapshot/time`|Time taken to build a snapshot of the current segment state. This tracks the performance of creating a consistent snapshot of all segments.||| +|`segment/poll/time`|Time in milliseconds to poll for all used segments. |None|| +|`segment/pollWithSchema/time`|Time in milliseconds to poll for all used segments including schema information.|None|| +|`segment/buildSnapshot/time`|Time taken to build a snapshot of the current segment state.|None|| |`tier/historical/count`|Number of available historical nodes in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration), and can be used to aggregate metrics across the tiers in an alias.|`tier`, `tierAlias`|Varies| |`tier/replication/factor`|Configured maximum replication factor in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration).|`tier`, `tierAlias`|Varies| |`tier/required/capacity`|Total capacity in bytes required in each tier. The `tierAlias` dimension is emitted only when the tier belongs to an alias configured via [`historicalTierAliases`](../configuration/index.md#dynamic-configuration).|`tier`, `tierAlias`|Varies|