How do we use Metrics Transform Processor?

[tomkerkhove]

Being new to processors, I was wondering how I can use the "Metrics Transform Processor" in the OTLP collector?

[bertysentry]

In your config yaml file, you simply specify the transforms, like in the example below:

receivers:
  # [...]

processors:
  metricstransform/1:
    transforms:
      # Transform otelcol_some_metric to otel.some.metric
      - include: ^otelcol_([^_]+)_(.*)$$
        match_type: regexp
        action: update
        new_name: otel.$${1}.$${2}

      # Transform my_metric to my.metric
      - include: ^([^_\.]+)_(.*)$$
        match_type: regexp
        action: update
        new_name: $${1}.$${2}

exporters:
  # [...]

service:
  extensions: # your extensions
  pipelines:
    metrics:
      receivers: # your receivers
      processors: [memory_limiter,batch,metricstransform/1] # <-- metricstransform
      exporters: # your exporters

More details about possible metric transforms are documented here.

[tomkerkhove]

I wasn't able to get it working but will try again, thank you!

[jpkrohling]

I have a full example as part of this repo:

https://github.com/jpkrohling/opentelemetry-collector-deployment-patterns/blob/main/pattern-2-normalizer