> ## 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 Catalog

export const TUsageAnalyzer = () => <>
    Telemetry Usage Analyzer
  </>;

To view all metrics in your Chronosphere Observability Platform tenant, find
specific metrics, and add or view details about them, use the Metrics Catalog.
The Metrics Catalog is part of Observability Platform's
[System Library](/investigate/system-library), a centralized reference for telemetry
data.

To access the Metrics Catalog, in the navigation menu, click
**<Icon icon="library" /> System Library <span aria-label="and then">></span> Metrics Catalog**.

## Catalog information

Metrics in the catalog include the following information:

* **Metric name**: The metric's name.
* **Type**: The metric's [type](/control/shaping/shape-metrics/types).
* **Labels**: The metric's [labels](#view-a-metrics-labels).
* **Description**: A [description](#edit-the-metric-description) of the metric.

Click the <Icon icon="ellipsis-vertical" /> three vertical dots menu in the metric's
row, or hover over the metric's row, to perform one of the following tasks:

* **View details**: Opens a drawer with the metric's **Type**, **Description**, and
  a time series graph showing this metric's activity over the selected time period.
  Use the <Icon icon="ellipsis-vertical" /> three dots menu on the graph to perform
  actions similar to [panel options](/observe/dashboards/panels#common-panel-elements).
* **Open in Usage Analyzer**: Opens the [<TUsageAnalyzer />](/investigate/analyze/usage)
  with this metric.
* **<Icon icon="square-arrow-out-up-right" /> Open in Metrics Explorer**: Opens the Metrics Explorer
  with a query using this metric.
* **<Icon icon="copy" /> Copy**: Copies the metric's name to the clipboard.

See [common panel elements](/observe/dashboards/panels#common-panel-elements) for an explanation of the
other available tools.

<Note>
  The Metrics Catalog doesn't include
  [derived attributes](/investigate/system-library/attributes-catalog/derived-attributes).
  To view all derived attributes, see the **Derived** tab of the
  [Attributes Catalog](/investigate/system-library/attributes-catalog).
</Note>

### Filter the catalog

Use the **Search metrics** field to find a metric by name. The list updates as you
enter text into the search field.

You can filter the list by prefix:

1. Click **Metrics that start with (anything)**. This is the default filter, and
   it displays all metrics.
2. Type a prefix, or select one or more prefixes from the list. Each item in the
   list displays the number of metrics that have that prefix. For example, `activity (8)`
   means there are eight metrics which use that prefix.

   To select only one item in the list and clear any other selections, hover the
   cursor over one of the list items and click **Only**.
3. To confirm your selection, click outside the list.

The catalog updates to display the selected metrics.

### Edit the metric description

The **Description** field provides more information about a metric to help users
understand what the metric is for and how it's used.

To add or change a description:

1. Click the metric's row in the catalog to open the **Overview** tab in the metric's
   panel.
2. In the **Description** field, click **Edit**.
3. In the box, enter a new or edit the existing description.
4. Click **Save** when finished, or **Cancel** to keep the existing value.

#### AI-generated descriptions

<Note>
  This feature isn't available to all Chronosphere Observability Platform users and
  might not be visible in your app. For information about enabling this feature in your
  environment, contact [Chronosphere Support](/support).
</Note>

Observability Platform suggests AI-generated metric descriptions on metrics that lack
authored descriptions. These suggestions are designated as **Generated by AI**.

To accept an AI-generated description, click **Accept**. To edit the generated description,
click **Edit**.

### View a metric's labels

Click the **View labels** button to open the **Labels** tab of the metric's panel.
The table in this tab provides the following information about your metric's labels:

* **Label**: The label name associated with the metric. To copy the label name,
  hover the cursor over the label's row and click the <Icon icon="copy" />
  copy icon.
* **Cardinality**: The number of unique values associated with the label.
* **Values**: The values associated with the label.
  Click **Show all** to expand the list to display
  additional values, if any. Click a label value to filter the results to the label
  and value pair.

  The table truncates long lists of values, and the table row indicates this by
  displaying the number of hidden values. To view all values, click **Show all**.

### View a metric's details

Each metric in the Metrics Catalog has a **Metric details** panel. To view a metric's
details panel, click its name in the **Metric** column of the Metrics Catalog.
You can also click the <Icon icon="ellipsis-vertical" /> three vertical dots icon
on the attribute's row, and then click **<Icon icon="file-text" /> View details**.

A metric's details panel contains two tabs:

* **Overview**: The attribute's metadata and usage details.

  The **Overview** tab's **Metadata** section lists the metric's **type**, its
  **labels** count, its **utility score**, and its **description**.

  The **Preview** section displays a
  [preview visualization of the metric](#view-a-preview-visualization-of-the-metric).

  The **Top usage (last 30 days)** section lists the **Top 3 dashboard queries**
  and **Explorer queries** that use the derived attribute, and the attribute's
  **Top users**. Usage is sorted by execution counts.
* **Labels**: A table of all of the metric's associated labels, including each
  label's cardinality (number of unique values) and a list of its values.

The panel also includes a link to
**<Icon icon="square-arrow-out-up-right" /> Open in Usage Analyzer**, which opens
the [<TUsageAnalyzer />](/investigate/analyze/usage) for the metric.

### View a preview visualization of the metric

The panel for each metric in the catalog includes a
[time series chart](/observe/dashboards/panels/time-series-chart) that visualizes
the metric over a recent time span, and a [time range selector](/navigate/time-ranges)
to select or pin a time span.

Click the <Icon icon="ellipsis-vertical" /> three vertical dots menu in the chart
to access additional tools:

* **<Icon icon="square-arrow-out-up-right" /> Open in Metrics Explorer**: Opens the Metrics Explorer
  with a query using this metric.
* **Copy as image**: Copies an image of the chart's current view to your clipboard.
* **Export as PNG**: Downloads the chart's current view as a PNG image.
* **Add to dashboard**: Opens the [**Add panel to dashboard**](/observe/dashboards/customization/layouts#add-a-panel-group-to-a-dashboard)
  dialog.
* **Add to notebook**: See [Notebooks](/navigate/notebooks#from-another-page).
* **Analyze anomaly (DDx)**: Opens the
  [Differential Diagnosis](/investigate/analyze/differential-diagnosis/metrics)
  tool with a query using this metric.