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

# Metrics Catalog

> Learn how to see all the metrics in Cortex XCOR

To view all metrics in your Palo Alto Networks Cortex XCOR tenant, find
specific metrics, and add or view details about them, use the Metrics Catalog.
The Metrics Catalog is part of Cortex XCOR
[System Library](https://docs-xcor.paloaltonetworks.com/investigate/system-library), a centralized reference for telemetry
data.

To access the Metrics Catalog, click **Go to admin view**. In the navigation menu,
select **Platform > System
Library > Metrics Catalog**.

To find metrics by describing what you want to measure rather than browsing or
filtering, ask [Operator](https://docs-xcor.paloaltonetworks.com/navigate/operator). It searches the metric names,
labels, and metadata in your tenant, and can query the metrics it finds. Click
** Ask Operator** in the page header or press <kbd>A</kbd>.

## Catalog information

Metrics in the catalog include the following information:

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

Click the  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  three dots menu on the graph to perform
  actions similar to [panel options](https://docs-xcor.paloaltonetworks.com/observe/dashboards/panels#common-panel-elements).
* **Open in Usage Analyzer**: Opens the [Telemetry Usage Analyzer](https://docs-xcor.paloaltonetworks.com/investigate/analyze/usage.md)
  with this metric.
* ** Open in Metrics Explorer**: Opens
  [Metrics Explorer](https://docs-xcor.paloaltonetworks.com/investigate/querying/metrics/explorer.md) with a query using this
  metric.
* ** Copy**: Copies the metric's name to the clipboard.

See [common panel elements](https://docs-xcor.paloaltonetworks.com/observe/dashboards/panels#common-panel-elements) for an
explanation of the
other available tools.

> [!NOTE]
>
> The Metrics Catalog doesn't include
> [derived attributes](https://docs-xcor.paloaltonetworks.com/investigate/system-library/attributes-catalog/derived-attributes.md).
> To view all derived attributes, see the **Derived** tab of the
> [Attributes Catalog](https://docs-xcor.paloaltonetworks.com/investigate/system-library/attributes-catalog.md).

### 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 Palo Alto Networks Cortex XCOR users and
> might not be visible in your app. For information about enabling this feature in your
> environment, contact [Cortex XCOR Support](https://docs-xcor.paloaltonetworks.com/support.md).

Cortex XCOR 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&#x20;
  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  three vertical dots icon
on the metric's row, and then click ** View details**.

A metric's details panel contains two tabs:

* **Overview**: The metric'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 metric, and the metric'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
** Open in Usage Analyzer**, which opens
the [Telemetry Usage Analyzer](https://docs-xcor.paloaltonetworks.com/investigate/analyze/usage.md) for the metric.

### View a preview visualization of the metric

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

Click the  three vertical dots menu in the chart
to access additional tools:

* ** 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**](https://docs-xcor.paloaltonetworks.com/observe/dashboards/customization/layouts.md#add-a-panel-group-to-a-dashboard)
  dialog.
* **Add to notebook**: See [Notebooks](https://docs-xcor.paloaltonetworks.com/navigate/notebooks.md#from-another-page).
* **Analyze anomaly (DDx)**: Opens the
  [Differential Diagnosis](https://docs-xcor.paloaltonetworks.com/investigate/analyze/differential-diagnosis/metrics.md)
  tool with a query using this metric.


## Related topics

- [Metrics dictionary](https://docs-xcor.paloaltonetworks.com/overview/concepts/dictionary.md)
- [Navigate the Integrations Hub](https://docs-xcor.paloaltonetworks.com/integrate/integrations-hub.md)
- [System Library](https://docs-xcor.paloaltonetworks.com/investigate/system-library.md)
- [Derived labels](https://docs-xcor.paloaltonetworks.com/investigate/querying/metrics/derived-telemetry/derived-labels.md)
- [Cloudflare](https://docs-xcor.paloaltonetworks.com/ingest/xcor/integrations/server/cloudflare.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.