monedula-metrics-reporter docs menu
Configuration keys
Every otlp.metric.reporter.* key of monedula-metrics-reporter 0.10.0: type, default, and whether it can change at runtime.
Reference 2 of 2
Reference for monedula-metrics-reporter v0.10.0
Updated 2 October 2026
On this page
All keys start with otlp.metric.reporter..
Keys
| Key | Type | Default | Description |
|---|---|---|---|
otlp. | String | http:// | OTLP collector endpoint. The default follows transport: gRPC uses :4317, HTTP uses :4318. For grpc, use the collector gRPC endpoint such as http://collector:4317. For http, a bare collector root such as http://collector:4318 is normalized to http://collector:4318/v1/metrics; custom paths are used as provided. |
otlp. | Enum (grpc | http) | grpc | OTLP transport: grpc or http. |
otlp. | Long | 30000 | Export interval in milliseconds. |
otlp. | Long | 5000 | Per-export call timeout in milliseconds. Must be less than otlp.metric.reporter.interval.ms. |
otlp. | List | empty | Comma-separated regex patterns used for allow-listing metrics. SPI metrics are matched against {group}.{name}; Yammer metrics are matched against {group}.{type}.{name}. Empty = allow all; an invalid pattern is logged at ERROR and the reporter runs as no-op so Kafka stays up. Changeable at runtime in builds from main (not yet released). |
otlp. | String | empty | Extra OTLP resource attributes: key=value,key=value. |
otlp. | String | empty | Static OTLP request headers as Header-Name=value,Other=value. Use this for collector auth such as bearer tokens or API keys. Header values may contain =, but commas are treated as separators. |
otlp. | Enum (none | gzip) | none | OTLP exporter compression: none or gzip. |
otlp. | String | empty | Optional path to a PEM CA bundle used to trust the collector TLS certificate. |
otlp. | String | empty | Optional path to a PEM client certificate for mTLS. Must be configured together with otlp.metric.reporter.client.key.path. |
otlp. | String | empty | Optional path to a PEM client private key for mTLS. Must be configured together with otlp.metric.reporter.client.certificate.path. |
otlp. | Boolean | true | Whether to also export JVM runtime metrics via OpenTelemetry's runtime instrumentation library. Disable if you scrape JVM metrics elsewhere. |
otlp. | Boolean | true | Enable the KIP-714 client-telemetry receiver. Auto-active on brokers but inert until a client-metrics subscription exists; false makes the broker not advertise the capability at all. |
otlp. | Boolean | true | Attach broker identity (kafka_cluster_id / kafka_node_id) to forwarded client metrics so they join broker series in PromQL. Changeable at runtime in builds from main (not yet released). |
otlp. | Boolean | false | Also attach the authenticated principal (kafka_client_principal) and client address (kafka_client_address). High-cardinality / PII - opt in deliberately. Changeable at runtime in builds from main (not yet released); there, turning it on at runtime adds the labels only if the broker started with it set to true. |
otlp. | Boolean | true | Attach the client's client_id (from the request context) as a label, so client metrics can be grouped per application. Moderate cardinality; on by default. Changeable at runtime in builds from main (not yet released). |
otlp. | Boolean | false | Attach the KIP-714 client_instance_id (a per-client-instance UUID) as a label. High cardinality - opt in deliberately. Changeable at runtime in builds from main (not yet released). |
otlp. | Int | 1024 | Bounded in-memory queue for inbound client pushes; overflow drops the payload (counted in monedula_reporter_clienttelemetry_dropped_total). |