> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics dictionary

This dictionary defines metrics created by and specific to Chronosphere Observability
Platform. These metrics are often included in default [dashboards](/overview), and
you can search for them anywhere you use metrics. These curated metrics can help
track basic important information about your Observability Platform instance.

The
[Chronosphere Health Check](/observe/dashboards/managed-dashboards#chronosphere-health-check)
dashboard includes links to the **Collectors**,
**Usage Dashboard**, and **Licensing Information** dashboards.

Use the [Metrics Catalog](/investigate/system-library/metrics-catalog) to learn
what metrics are in your tenant.

Query these metrics as their respective [Prometheus type](/control/shaping/shape-metrics/types#prometheus).

## Collectors

The **Collectors** dashboard includes the following metrics that Collectors generate.
Use this dashboard to monitor the health of your Collectors.

See the [Collectors tags](#collectors-tags) that these metrics create during
dashboard creation.

| Metric name                                        | [Metric type](/control/shaping/shape-metrics/types) | Description                                                                                                                                                                                                                  |
| -------------------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `chronocollector_build_information`                | Gauge                                               | Metrics relating to current build of Collectors.                                                                                                                                                                             |
| `chronocollector_gateway_push_errors`              | Counter                                             | Current total number of push errors from Collector.                                                                                                                                                                          |
| `chronocollector_gateway_push_latency`             | Summary                                             | Latency of pushed writes by Collector.                                                                                                                                                                                       |
| `chronocollector_gateway_push_success`             | Counter                                             | Total count of requests and RPC calls successfully pushed to the Chronosphere gateway.                                                                                                                                       |
| `chronocollector_gateway_write_success`            | Counter                                             | Total count of each time series that are successfully written to the Chronosphere gateway. <br /> <br /> Counts only the metrics that the Collector scrapes, and not metrics from push-based protocols such as tracing data. |
| `chronocollector_k8s_gatherer_sink_targets_active` | Gauge                                               | Current number of active targets Collector is scraping.                                                                                                                                                                      |
| `process_cpu_seconds_total`                        | Counter                                             | Current total number of seconds of CPU processing time.                                                                                                                                                                      |

### Collectors tags

The following metrics create these tags during
[dashboard creation](/observe/dashboards#create-a-new-dashboard):

| Metric name                                        | Tags                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `chronocollector_build_information`                | `branch`<br />`build_date`<br />`build_version`<br />`chronosphere_k8s_cluster`<br />`chronosphere_k8s_container_port`<br />`chronosphere_k8s_namespace`<br />`cluster`<br />`go_version`<br />`hostname`<br />`instance`<br />`job`<br />`k8s_cluster_id`<br />`pod_name`<br />`namespace`<br />`region`<br />`revision`<br />`service`<br /> |
| `chronocollector_gateway_push_errors`              | `chronosphere_k8s_cluster`<br />`chronosphere_k8s_container_port`<br />`chronosphere_k8s_namespace`<br />`component`<br />`environment`<br />`hostname`<br />`instance`<br />`job`<br />`k8s_cluster_id`<br />`namespace`<br />`region`<br />`service`<br />                                                                                   |
| `chronocollector_gateway_push_latency`             | `chronosphere_k8s_cluster`<br />`chronosphere_k8s_container_port`<br />`chronosphere_k8s_namespace`<br />`component`<br />`environment`<br />`instance`<br />`job`<br />`k8s_cluster_id`<br />`namespace`<br />`quantile`<br />`region`<br />`service`<br />                                                                                   |
| `chronocollector_gateway_push_success`             | `annotationsPrefix`<br />`cluster`<br />`component`<br />`env`<br />`environment`<br />`instance`<br />`job`<br />`node`<br />`region`<br />`service`<br />`service_account`<br />`team`<br />`version`                                                                                                                                        |
| `chronocollector_gateway_write_success`            | `annotationsPrefix`<br />`cluster`<br />`component`<br />`env`<br />`environment`<br />`instance`<br />`job`<br />`node`<br />`region`<br />`service`<br />`service_account`<br />`team`<br />`version`                                                                                                                                        |
| `chronocollector_k8s_gatherer_sink_targets_active` | `environment`<br />`instance`<br />`job`<br />`k8s_cluster_id`<br />`namespace`<br />`region`<br />`service`<br />                                                                                                                                                                                                                             |
| `process_cpu_seconds_total`                        | `environment`<br />`instance`<br />`job`<br />`k8s_cluster_id`<br />`namespace`<br />`node`<br />`region`<br />`service`<br />                                                                                                                                                                                                                 |

## Impact statistics

The following usage metric applies to impact statistics.

This metric creates the following tags during
[dashboard creation](/observe/dashboards#create-a-new-dashboard):

* `applied`
* `mode`

| Metric name                             | [Metric type](/control/shaping/shape-metrics/types) | Description                                                                              |
| --------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| `chrono_metrics_drop_rule_dpps_matched` | Counter                                             | Provides visibility into drop rule behavior across enabled, disabled, and preview rules. |

## Usage statistics

Observability Platform provides different usage metrics you can use to understand and
manage your overall metric data usage.

### Shaping usage statistics

The following usage metrics apply to shaping statistics.

| Metric name                 | [Metric type](/control/shaping/shape-metrics/types) | Description                                                                                                       | Tags provided during [dashboard creation](/observe/dashboards#create-a-new-dashboard) |
| --------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `chrono_poolstats_count`    | Counter                                             | Shaping statistics that include pool information.                                                                 | `drop_reason`<br />`dropped`<br />`type`                                              |
| `chrono_poolstats_total`    | Counter                                             | Total shaping statistics without any tag information.                                                             | `drop_reason`<br />`dropped`<br />`type`                                              |
| `chrono_poolstats_sampling` | Counter                                             | Emitted only when the number of unique usage statistics values<br /> exceeds the configured maximum allowed tags. | `node`<br />`type`                                                                    |

### Usage metrics

The **Usage Dashboard** includes the following usage statistics metrics. Use this
dashboard to identify who is contributing most to your Chronosphere usage and manage
your overall usage.

| Metric name                                              | [Metric type](/control/shaping/shape-metrics/types) | Description                                                                                                       | Tags provided during [dashboard creation](/observe/dashboards#create-a-new-dashboard) |
| -------------------------------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `chronosphere_uptime`                                    | Counter                                             | Represents the Service Level Agreement (SLA) results for SLA checks.                                              | *none*                                                                                |
| `chrono_usagestats_count`                                | Counter                                             | Usage statistics grouped by tags.                                                                                 | `drop_reason`<br />`dropped`<br />`type`                                              |
| `chrono_usagestats_total`                                | Counter                                             | Total usage statistics without any grouping.                                                                      | `drop_reason`<br />`dropped`<br />`type`                                              |
| `chrono_usagestats_count_sampling`                       | Counter                                             | Emitted only when the number of unique usage statistics values<br /> exceeds the configured maximum allowed tags. | `node`<br />`type`                                                                    |
| `chrono_metrics_persisted_cardinality_license_top_usage` | Gauge                                               | Approximate cardinality of persisted metrics, grouped by tag.                                                     | `top_label_name`<br />`top_label_value`                                               |

Other usage statistics count label and metric name usage.

| Metric name                              | Metric type | Description                                                                                                          |
| ---------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------- |
| `chrono_datapoints_by_metric_per_second` | Gauge       | Contains the `metric_name` label. Emits the average data points per second over the last two minutes by metric name. |
| `chrono_datapoints_by_label_per_second`  | Gauge       | Contains the `label_name` label. Emits the average data points per second over the last two minutes by label name.   |
| `chrono_unique_label_values_count`       | Gauge       | Contains the `label_name` label. Emits the unique values seen over the last two minutes, by label name.              |

### Service token usage

The following metric applies to
[service account tokens](/administer/accounts-teams/service-accounts):

| Metric name                       | Metric type | Description                                                                                                                         |
| --------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `chrono_api_token_requests_total` | Counter     | Monitors the number of requests made with a service account token. Can be inaccurate if more than 1000 service accounts are in use. |

The `email` label for this metric corresponds to the `email` field queryable in the
[service accounts API](/tooling/api-info/definition/operations/ListServiceAccounts).

## Alerts

To learn about alert metrics, see [Alert metrics](/investigate/querying/metrics/alert-metrics).

## Google Cloud integration

The following metrics apply to Observability Platform's
[Google Cloud](/ingest/metrics-traces/gcp) integration:

| Metric name                                  | Metric type | Description                                                            |
| -------------------------------------------- | ----------- | ---------------------------------------------------------------------- |
| `chrono_gcp_integration_shards_total`        | Gauge       | The number of Google Cloud metric shards successfully ingested.        |
| `chrono_gcp_integration_active_shards_total` | Gauge       | The number of active Google Cloud metric shards successfully ingested. |
| `chrono_gcp_integration_data_points_total`   | Counter     | The total number of data points ingested.                              |
| `chrono_gcp_integration_metric_descriptors`  | Gauge       | List of all metric descriptors ingested, indicated by value of `1`.    |

## Service level objective (SLO) metrics

The following metrics apply to [service level objectives](/observe/slo) (SLOs) defined
in Observability Platform.

### Derived metrics

These metrics are derived from [recording rules](#recording-rules) over various
time windows. `DURATION` values are passed in [time-unit syntax](/overview/concepts/time-units),
such as `5m` or `28d`.

Each metric includes `slo_id` and `slo_name` labels to identify their associated
SLO, and any signal or dimensional grouping labels defined in the SLO.

| Metric name                                   | Metric type    | Description                                                                                                                                          |
| --------------------------------------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lens:slo:burn_rate:ratio<DURATION>`          | Gauge          | Each SLO's burn rate over the `<DURATION>`, calculated as `sum_over_time(lens:slo:errors[<DURATION>]) / sum_over_time(lens:slo:total[<DURATION>])`.  |
| `lens:slo:error_ratio:rate<DURATION>`         | Gauge          | Each SLO's error rate over the `<DURATION>`, calculated as `sum_over_time(lens:slo:errors[<DURATION>]) / sum_over_time(lens:slo:total[<DURATION>])`. |
| `lens:slo:error_budget`                       | Gauge (static) | Each SLO's total error budget, as calculated by `lens:slo:info`. This static value doesn't change over time.                                         |
| `lens:slo:error_budget_minutes_<DURATION>`    | Gauge          | Each SLO's total error budget, calculated as minutes within the `DURATION`.                                                                          |
| `lens:slo:budget_remaining_ratio<DURATION>`   | Gauge          | Each SLO's remaining error budget, calculated as a ratio from 0 (exhausted) to 1 (unused). This is the inverse of the `reliability:ratio` metric.    |
| `lens:slo:budget_remaining_minutes<DURATION>` | Gauge          | Each SLO's remaining error budget, calculated as minutes.                                                                                            |
| `lens:slo:reliability:ratio<DURATION>`        | Gauge          | Each SLO's performance, calculated as a ratio from 0 (0% reliability) to 1 (100%). This is the inverse of the `budget_remaining_ratio` metric.       |

### Recording rules

Gauges apply `sum_over_time` over 5-minute intervals. Counters report the rate over
a five-minute period.

| Metric name       | Metric type    | Description                                                                                                                                                                        |
| ----------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `lens:slo:info`   | Gauge (static) | List of SLOs as time series with related facts, including type, team, and objective values, as a component of `lens:slo:error_budget`. This static value doesn't change over time. |
| `lens:slo:errors` | Gauge          | Each SLO's error count, used as the numerator in `lens:slo:error_ratio`.                                                                                                           |
| `lens:slo:total`  | Gauge          | Each SLO's total count of measurements, used as the denominator in `lens:slo:error_ratio`.                                                                                         |