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

# Telemetrypolicy

> OpenTelemetry processor for Telemetrypolicy

# Telemetrypolicy Processor

![Status](https://img.shields.io/badge/status-development-orange)

**Maintainers:** [@dashpole](https://github.com/dashpole), [@jaronoff97](https://github.com/jaronoff97), [@mx-psi](https://github.com/mx-psi)

**Source:** [opentelemetry-collector-contrib](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/processor/telemetrypolicyprocessor)

## Supported Telemetry

![Logs](https://img.shields.io/badge/logs-development-blue) ![Metrics](https://img.shields.io/badge/metrics-development-green) ![Traces](https://img.shields.io/badge/traces-development-orange)

## Overview

> \[!NOTE]
> This component is a work-in-progress. See [#50965](https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/50965).

## Getting Started

The `telemetry_policy` processor natively interprets and enforces standardized,
declarative Telemetry Policies across traces, metrics, and logs for sampling,
filtering, and scoped transformations, with built-in hit/miss observability.

Policies are atomic, fail-open, portable across runtimes (SDKs, Collector, agents),
and dynamically sourced from policy provider extensions (such as `file_telemetry_policy`).

## Configuration

The following settings are available:

* `providers` (required): The list of policy provider extension IDs to consume policies from.

### Example Configuration

```yaml theme={null}
extensions:
  file_telemetry_policy:
    path: /etc/otel/policies.yaml

processors:
  telemetry_policy:
    providers: [file_telemetry_policy]

service:
  extensions: [file_telemetry_policy]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [telemetry_policy, batch]
      exporters: [otlp]
    metrics:
      receivers: [otlp]
      processors: [telemetry_policy, batch]
      exporters: [otlp]
    logs:
      receivers: [otlp]
      processors: [telemetry_policy, batch]
      exporters: [otlp]
```

## Configuration

### Example Configuration

```yaml theme={null}
telemetry_policy:
  providers:
    - file_telemetry_policy

telemetry_policy/custom:
  providers:
    - file_telemetry_policy
    - custom_policy_provider/prod
```

***

*Last generated: 2026-10-05*