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

# Rename Metric

<Badge className="hny-badge-enterprise-addon" stroke>Ent+</Badge>

<Note>
  This feature is available as an add-on for the [Honeycomb Enterprise plan](https://www.honeycomb.io/pricing/).
  Please contact your Honeycomb account team for details.
</Note>

## Description

The Rename Metric processor can be used to rename metrics.

## Use

The Rename Metric processor is utilized for renaming metrics. It supports renaming either the entire name of a single metric or the prefix of multiple metrics.

## Supported Types

| Metrics | Logs | Traces |
| :------ | :--- | :----- |
| ✓       |      |        |

## Configuration

| Field      | Description                                                                                                                        |
| :--------- | :--------------------------------------------------------------------------------------------------------------------------------- |
| Operation  | The operation to perform when renaming a metric. `Name`: Rename an entire metric. `Prefix`: Rename the prefix of multiple metrics. |
| Old Name   | The name of an incoming metric to rename. Required when `Operation` is set to `Name`.                                              |
| New Name   | The new name of an incoming metric. Required when `Operation` is set to `Name`.                                                    |
| Old Prefix | The prefix of incoming metrics to rename. Required when `Operation` is set to `Prefix`.                                            |
| New Prefix | The new prefix of incoming metrics. Required when `Operation` is set to `Prefix`.                                                  |

## Example Configuration(s)

### Renaming A Single Metric

In this configuration, the `system.network.packets` metric is renamed to just `network.traffic`.

#### Web Interface

<img src="https://mintcdn.com/honeycomb/d02pt8WsFnHLTWcz/_assets/images/htp/xnapper-rename-metric-1.png?fit=max&auto=format&n=d02pt8WsFnHLTWcz&q=85&s=75b7713b530333dc206a75f5099590db" alt="Honeycomb Docs - Rename Metric - image 1" width="1950" height="1912" data-path="_assets/images/htp/xnapper-rename-metric-1.png" />

### Renaming A Metric Prefix

In this configuration, the `system` prefix for host metrics is replaced with `macos`.

#### Web Interface

<img src="https://mintcdn.com/honeycomb/d02pt8WsFnHLTWcz/_assets/images/htp/xnapper-rename-metric-2.png?fit=max&auto=format&n=d02pt8WsFnHLTWcz&q=85&s=94e2269a7636d4c1cb5911bacd2ada3a" alt="Honeycomb Docs - Rename Metric - image 2" width="1946" height="1912" data-path="_assets/images/htp/xnapper-rename-metric-2.png" />