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

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

export const AddToDashboardIcon = props => {
  return <svg viewBox="0 0 20 20" className="inline-block h-5 w-5" style={{
    fill: "#28a561"
  }} {...props}>
      <path fillRule="evenodd" clipRule="evenodd" d="M3 3H9V9H3V3ZM11 3H17V9H11V3ZM3 11H9V17H3V11ZM13.25 11H14.75V13.25H17V14.75H14.75V17H13.25V14.75H11V13.25H13.25V11ZM12.5 4.5V7.5H15.5V4.5H12.5ZM4.5 4.5V7.5H7.5V4.5H4.5ZM4.5 12.5V15.5H7.5V12.5H4.5Z" />
    </svg>;
};

export const CollectionIcon = props => {
  const drawPath = "M21 6.5c-1.66 0-3 1.34-3 3 0 .07 0 .14.01.21l-2.03.68c-.64-1.21-1.82-2.09-3.22-2.32V5.91C14.04 5.57 15 4.4 15 3c0-1.66-1.34-3-3-3S9 1.34 9 3c0 1.4.96 2.57 2.25 2.91v2.16c-1.4.23-2.58 1.11-3.22 2.32l-2.04-.68C6 9.64 6 9.57 6 9.5c0-1.66-1.34-3-3-3s-3 1.34-3 3 1.34 3 3 3c1.06 0 1.98-.55 2.52-1.37l2.03.68c-.2 1.29.17 2.66 1.09 3.69l-1.41 1.77C6.85 17.09 6.44 17 6 17c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3c0-.68-.22-1.3-.6-1.8l1.41-1.77c1.36.76 3.02.75 4.37 0l1.41 1.77c-.37.5-.59 1.12-.59 1.8 0 1.66 1.34 3 3 3s3-1.34 3-3-1.34-3-3-3c-.44 0-.85.09-1.23.26l-1.41-1.77c.93-1.04 1.29-2.4 1.09-3.69l2.03-.68c.53.82 1.46 1.37 2.52 1.37 1.66 0 3-1.34 3-3S22.66 6.5 21 6.5zm-18 4c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1zM6 21c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1zm5-18c0-.55.45-1 1-1s1 .45 1 1-.45 1-1 1-1-.45-1-1zm1 12c-1.38 0-2.5-1.12-2.5-2.5S10.62 10 12 10s2.5 1.12 2.5 2.5S13.38 15 12 15zm6 4c.55 0 1 .45 1 1s-.45 1-1 1-1-.45-1-1 .45-1 1-1zm3-8.5c-.55 0-1-.45-1-1s.45-1 1-1 1 .45 1 1-.45 1-1 1z";
  return <svg viewBox="0 0 24 25" data-testid="CollectionIcon" aria-label="CollectionIcon" {...props} className="inline-block h-5 w-5" style={{
    fill: "#28a561"
  }}>
      <path d={drawPath} />
    </svg>;
};

export const CollectionNavIcon = props => {
  const drawPath = "M8.4 18.2C8.8 18.7 9 19.3 9 20C9 21.7 7.7 23 6 23S3 21.7 3 20 4.3 17 6 17C6.4 17 6.8 17.1 7.2 17.3L8.6 15.5C7.7 14.5 7.3 13.1 7.5 11.8L5.5 11.1C5 11.9 4.1 12.5 3 12.5C1.3 12.5 0 11.2 0 9.5S1.3 6.5 3 6.5 6 7.8 6 9.5V9.7L8 10.4C8.6 9.2 9.8 8.3 11.2 8.1V5.9C10 5.6 9 4.4 9 3C9 1.3 10.3 0 12 0S15 1.3 15 3C15 4.4 14 5.6 12.8 5.9V8.1C14.2 8.3 15.4 9.2 16 10.4L18 9.7V9.5C18 7.8 19.3 6.5 21 6.5S24 7.8 24 9.5 22.7 12.5 21 12.5C19.9 12.5 19 11.9 18.5 11.1L16.5 11.8C16.7 13.1 16.3 14.5 15.4 15.5L16.8 17.3C17.2 17.1 17.6 17 18 17C19.7 17 21 18.3 21 20S19.7 23 18 23 15 21.7 15 20C15 19.3 15.2 18.7 15.6 18.2L14.2 16.4C12.8 17.2 11.2 17.2 9.8 16.4L8.4 18.2Z";
  return <svg viewBox="0 0 24 24" data-testid="Collections" aria-label="Collections" {...props} className="inline-block h-5 w-5" style={{
    fill: "#28a561"
  }}>
      <path d={drawPath} />
    </svg>;
};

export const ServiceIcon = props => {
  return <svg viewBox="0 0 22 20" {...props} className="inline-block h-5 w-5" aria-label="ServiceIcon" style={{
    fill: "#28a561"
  }}>
      <path fillRule="evenodd" clipRule="evenodd" d="M10.7339 0.0766817C10.8966 -0.0255606 11.1034 -0.0255606 11.2661 0.0766817L16.2661 3.21954C16.4117 3.31104 16.5 3.47092 16.5 3.64286V8.35714C16.5 8.52908 16.4117 8.68896 16.2661 8.78046L11.2661 11.9233C11.1034 12.0256 10.8966 12.0256 10.7339 11.9233L5.73391 8.78046C5.58834 8.68896 5.5 8.52908 5.5 8.35714V3.64286C5.5 3.47092 5.58834 3.31104 5.73391 3.21954L10.7339 0.0766817ZM6.5 4.54772V8.08086L10.5 10.5951V7.062L6.5 4.54772ZM11.5 7.062V10.5951L15.5 8.08086V4.54772L11.5 7.062ZM15.0605 3.64286L11 6.19514L6.93955 3.64286L11 1.09057L15.0605 3.64286Z" />
      <path fillRule="evenodd" clipRule="evenodd" d="M5.73391 8.07668C5.89657 7.97444 6.10343 7.97444 6.26609 8.07668L11.2661 11.2195C11.4117 11.311 11.5 11.4709 11.5 11.6429V16.3571C11.5 16.5291 11.4117 16.689 11.2661 16.7805L6.26609 19.9233C6.10343 20.0256 5.89657 20.0256 5.73391 19.9233L0.733914 16.7805C0.588344 16.689 0.5 16.5291 0.5 16.3571V11.6429C0.5 11.4709 0.588344 11.311 0.733914 11.2195L5.73391 8.07668ZM1.5 12.5477V16.0809L5.5 18.5951V15.062L1.5 12.5477ZM6.5 15.062V18.5951L10.5 16.0809V12.5477L6.5 15.062ZM10.0605 11.6429L6 14.1951L1.93955 11.6429L6 9.09057L10.0605 11.6429Z" />
      <path fillRule="evenodd" clipRule="evenodd" d="M15.7339 8.07668C15.8966 7.97444 16.1034 7.97444 16.2661 8.07668L21.2661 11.2195C21.4117 11.311 21.5 11.4709 21.5 11.6429V16.3571C21.5 16.5291 21.4117 16.689 21.2661 16.7805L16.2661 19.9233C16.1034 20.0256 15.8966 20.0256 15.7339 19.9233L10.7339 16.7805C10.5883 16.689 10.5 16.5291 10.5 16.3571V11.6429C10.5 11.4709 10.5883 11.311 10.7339 11.2195L15.7339 8.07668ZM11.5 12.5477V16.0809L15.5 18.5951V15.062L11.5 12.5477ZM16.5 15.062V18.5951L20.5 16.0809V12.5477L16.5 15.062ZM20.0605 11.6429L16 14.1951L11.9395 11.6429L16 9.09057L20.0605 11.6429Z" />
    </svg>;
};

export const ServiceNavIcon = props => {
  return <svg viewBox="0 0 20 20" {...props} className="inline-block h-5 w-5" aria-label="Services" style={{
    fill: "#28a561"
  }}>
      <path d="M0 13.5463C0 13.3708 0.157997 13.2607 0.284979 13.3478L4.18974 16.0263C4.24909 16.067 4.28571 16.1427 4.28571 16.2248V19.7709C4.28571 19.9465 4.12772 20.0566 4.00074 19.9695L0.0959735 17.291C0.0366259 17.2503 0 17.1745 0 17.0925V13.5463Z" />
      <path d="M5.2381 16.2248C5.2381 16.1427 5.27472 16.067 5.33407 16.0263L9.23883 13.3478C9.36581 13.2607 9.52381 13.3708 9.52381 13.5463V17.0925C9.52381 17.1745 9.48718 17.2503 9.42784 17.291L5.52307 19.9695C5.39609 20.0566 5.2381 19.9465 5.2381 19.7709V16.2248Z" />
      <path d="M4.85641 15.0372L8.75079 12.3658C8.87876 12.2781 8.87876 12.0566 8.75079 11.9688L4.85641 9.29746C4.79785 9.25729 4.72596 9.25729 4.6674 9.29746L0.773017 11.9688C0.645052 12.0566 0.645052 12.2781 0.773016 12.3658L4.6674 15.0372C4.72596 15.0774 4.79785 15.0774 4.85641 15.0372Z" />
      <path d="M5.23804 4.279C5.23804 4.10344 5.39603 3.99337 5.52302 4.08048L9.42778 6.75893C9.48713 6.79964 9.52375 6.8754 9.52375 6.95746V10.5036C9.52375 10.6792 9.36575 10.7892 9.23877 10.7021L5.33401 8.02368C5.27466 7.98297 5.23804 7.90721 5.23804 7.82515V4.279Z" />
      <path d="M10.4761 6.95746C10.4761 6.8754 10.5128 6.79964 10.5721 6.75893L14.4769 4.08048C14.6039 3.99337 14.7618 4.10344 14.7618 4.279V7.82515C14.7618 7.9072 14.7252 7.98297 14.6659 8.02368L10.7611 10.7021C10.6341 10.7892 10.4761 10.6792 10.4761 10.5036V6.95746Z" />
      <path d="M10.0944 5.76985L13.9888 3.09851C14.1168 3.01073 14.1168 2.78924 13.9888 2.70147L10.0944 0.0301261C10.0359 -0.010042 9.964 -0.010042 9.90544 0.0301261L6.01105 2.70147C5.88309 2.78924 5.88309 3.01073 6.01105 3.09851L9.90544 5.76985C9.964 5.81002 10.0359 5.81002 10.0944 5.76985Z" />
      <path d="M10.4761 13.5463C10.4761 13.3708 10.6341 13.2607 10.7611 13.3478L14.6658 16.0263C14.7252 16.067 14.7618 16.1427 14.7618 16.2248V19.7709C14.7618 19.9465 14.6038 20.0566 14.4768 19.9695L10.572 17.291C10.5127 17.2503 10.4761 17.1745 10.4761 17.0925V13.5463Z" />
      <path d="M15.7142 16.2248C15.7142 16.1427 15.7508 16.067 15.8101 16.0263L19.7149 13.3478C19.8419 13.2607 19.9999 13.3708 19.9999 13.5463V17.0925C19.9999 17.1745 19.9633 17.2503 19.9039 17.291L15.9991 19.9695C15.8722 20.0566 15.7142 19.9465 15.7142 19.7709V16.2248Z" />
      <path d="M15.3325 15.0372L19.2269 12.3658C19.3548 12.2781 19.3548 12.0566 19.2269 11.9688L15.3325 9.29746C15.2739 9.25729 15.202 9.25729 15.1435 9.29746L11.2491 11.9688C11.1211 12.0566 11.1211 12.2781 11.2491 12.3658L15.1435 15.0372C15.202 15.0774 15.2739 15.0774 15.3325 15.0372Z" />
    </svg>;
};

export const CSharpIcon = props => <svg style={{
  display: "inline-block",
  width: "1.5rem",
  height: "1.5rem"
}} viewBox="0 0 24 24" {...props}>
    <path d="m11.5 15.97.41 2.44c-.26.14-.68.27-1.24.39-.57.13-1.24.2-2.01.2-2.21-.04-3.87-.7-4.98-1.96C2.56 15.77 2 14.16 2 12.21c.05-2.31.72-4.08 2-5.32C5.32 5.64 6.96 5 8.94 5c.75 0 1.4.07 1.94.19s.94.25 1.2.4l-.58 2.49-1.06-.34c-.4-.1-.86-.15-1.39-.15-1.16-.01-2.12.36-2.87 1.1-.76.73-1.15 1.85-1.18 3.34 0 1.36.37 2.42 1.08 3.2.71.77 1.71 1.17 2.99 1.18l1.33-.12c.43-.08.79-.19 1.1-.32M13.89 19l.61-4H13l.34-2h1.5l.32-2h-1.5L14 9h1.5l.61-4h2l-.61 4h1l.61-4h2l-.61 4H22l-.34 2h-1.5l-.32 2h1.5L21 15h-1.5l-.61 4h-2l.61-4h-1l-.61 4h-2m2.95-6h1l.32-2h-1l-.32 2Z" style={{
  fill: "#28a561"
}} />
  </svg>;

export const PipeIcon = props => <svg style={{
  display: "inline-block",
  width: "1.5rem",
  height: "1.5rem"
}} viewBox="0 0 24 24" {...props}>
    <path d="M22 14h-2v2h-6v-3h2v-2h-2V6a2 2 0 0 0-2-2H4V2H2v8h2V8h6v3H8v2h2v5a2 2 0 0 0 2 2h8v2h2" style={{
  fill: "#28a561"
}} />
  </svg>;

export const AiMessageIcon = props => <svg style={{
  display: "inline-block",
  width: "1.5rem",
  height: "1.5rem"
}} viewBox="0 0 24 24" {...props}>
    <path d="M2.5 3C2.08782 3.00012 1.73499 3.14696 1.44141 3.44043C1.14766 3.73418 1 4.0875 1 4.5V19L4 16H15.5C15.9124 16 16.2659 15.8532 16.5596 15.5596C16.8533 15.2658 17.001 14.9125 17.001 14.5V10H15.5V14.5H3.375L2.5 15.375V4.5H10V3H2.5Z" style={{
  fill: "#28a561"
}} />
    <path fillRule="evenodd" clipRule="evenodd" d="M14.1154 3.11538L11 4.5L14.1154 5.88461L15.5 9L16.8846 5.88461L20 4.5L16.8846 3.11538L15.5 0L14.1154 3.11538Z" style={{
  fill: "#28a561"
}} />
  </svg>;

export const MicroscopeIcon = props => <svg viewBox="0 0 24 24" {...props} className="inline-block h-5 w-5" aria-label="Microscope" style={{
  fill: "#28a561"
}}>
    <path d="M9.46,6.28L11.05,9C8.47,9.26 6.5,11.41 6.5,14A5,5 0 0,0 11.5,19C13.55,19 15.31,17.77 16.08,16H13.5V14H21.5V16H19.25C18.84,17.57 17.97,18.96 16.79,20H19.5V22H3.5V20H6.21C4.55,18.53 3.5,16.39 3.5,14C3.5,10.37 5.96,7.2 9.46,6.28M12.74,2.07L13.5,3.37L14.36,2.87L17.86,8.93L14.39,10.93L10.89,4.87L11.76,4.37L11,3.07L12.74,2.07Z" />
  </svg>;

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](/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**.

To find metrics by describing what you want to measure rather than browsing or
filtering, ask [Operator](/navigate/operator). It searches the metric names,
labels, and metadata in your tenant, and can query the metrics it finds. Click
**<AiMessageIcon /> 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](/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 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](/support).
</Note>

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 <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.


## Related topics

- [Navigate the Integrations Hub](/integrate/integrations-hub.md)
- [System Library](/investigate/system-library.md)
- [Metrics dictionary](/overview/concepts/dictionary.md)
- [Derived labels](/investigate/querying/metrics/derived-telemetry/derived-labels.md)
- [Respond to incidents](/overview/guides/incident-response.md)


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