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

# Filter Metric Name

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

## Metric Name Filter Processor

The Metric Name Filter processor can be used to include or exclude metrics based on their name.

## Supported Types

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

## Configuration Table

| Parameter | Type | Default | Description |
| :- | :- | :- | :- |
| action | `enum` | `exclude` | `exclude` or `include` metrics that match. |
| match\_type | `enum` | `strict` | Method for matching values. Strict matching requires that 'value' be an exact match. Regexp matching uses [re2](https://github.com/google/re2/wiki/Syntax) to match a value. |
| metric\_names | `strings` | required | One or more metric names to match on. |

## Example Configuration

### Web Interface

<img src="https://mintcdn.com/honeycomb/ibXJI2unoLZRp0G4/_assets/images/htp/xnapper-filter-metric-name.png?fit=max&auto=format&n=ibXJI2unoLZRp0G4&q=85&s=54d7254455e6b92606092c502b7d8065" alt="Honeycomb Docs - Filter Metric Name - image 1" width="1950" height="1912" data-path="_assets/images/htp/xnapper-filter-metric-name.png" />

### Exclude Regexp

Filter out (exclude) metrics that match the expression `k8s.node.*`.

```yaml theme={}
apiVersion: bindplane.observiq.com/v1
kind: Processor
metadata:
  id: filter-name-regexp
  name: filter-name-regexp
spec:
  type: filter_metric_name
  parameters:
    - name: action
      value: exclude
    - name: match_type
      value: regexp
    - name: metric_names
      value:
        - k8s.node.*
```

### Include Strict

Include metrics that match, drop all other metrics.

```yaml theme={}
apiVersion: bindplane.observiq.com/v1
kind: Processor
metadata:
  id: include-name-strict
  name: include-name-strict
spec:
  type: filter_metric_name
  parameters:
    - name: action
      value: include
    - name: match_type
      value: strict
    - name: metric_names
      value:
        - k8s.container.cpu
        - k8s.pod.memory
```