Monedula
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

KeyTypeDefaultDescription
otlp.metric.reporter.endpoint String http://localhost:4317 (grpc), http://localhost:4318 (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.metric.reporter.transport Enum (grpc | http) grpc OTLP transport: grpc or http.
otlp.metric.reporter.interval.ms Long 30000 Export interval in milliseconds.
otlp.metric.reporter.timeout.ms Long 5000 Per-export call timeout in milliseconds. Must be less than otlp.metric.reporter.interval.ms.
otlp.metric.reporter.allowed.metrics 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.metric.reporter.resource.attributes String empty Extra OTLP resource attributes: key=value,key=value.
otlp.metric.reporter.headers 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.metric.reporter.compression Enum (none | gzip) none OTLP exporter compression: none or gzip.
otlp.metric.reporter.trusted.certificates.path String empty Optional path to a PEM CA bundle used to trust the collector TLS certificate.
otlp.metric.reporter.client.certificate.path String empty Optional path to a PEM client certificate for mTLS. Must be configured together with otlp.metric.reporter.client.key.path.
otlp.metric.reporter.client.key.path String empty Optional path to a PEM client private key for mTLS. Must be configured together with otlp.metric.reporter.client.certificate.path.
otlp.metric.reporter.jvm.metrics.enabled Boolean true Whether to also export JVM runtime metrics via OpenTelemetry's runtime instrumentation library. Disable if you scrape JVM metrics elsewhere.
otlp.metric.reporter.client.telemetry.enabled 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.metric.reporter.client.telemetry.enrich.broker 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.metric.reporter.client.telemetry.enrich.client.identity 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.metric.reporter.client.telemetry.enrich.client.id 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.metric.reporter.client.telemetry.enrich.client.instance.id 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.metric.reporter.client.telemetry.queue.capacity Int 1024 Bounded in-memory queue for inbound client pushes; overflow drops the payload (counted in monedula_reporter_clienttelemetry_dropped_total).