Skip to content

events/export: Document metric_export_sample_by#1539

Open
cmouse wants to merge 3 commits into
dovecot:mainfrom
cmouse:optl
Open

events/export: Document metric_export_sample_by#1539
cmouse wants to merge 3 commits into
dovecot:mainfrom
cmouse:optl

Conversation

@cmouse
Copy link
Copy Markdown
Contributor

@cmouse cmouse commented May 15, 2026

Adds a Sampling section to the Event Export page, settings entries for metric_export_sample_by / _field / _permille, and a stats_sample_by anchor for cross-linking.

Sampling hashes a configured event field (typically session) and forwards only the fraction set by permille (parts per thousand) to the exporter, while in-process statistics counters keep counting every event. Multiple sample_by blocks combine with AND semantics.

JIRA: DOV-8702

@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@github-actions

This comment has been minimized.

@cmouse cmouse force-pushed the optl branch 4 times, most recently from 4ceb910 to d6613e7 Compare May 16, 2026 12:03
cmouse added 3 commits May 21, 2026 07:13
Adds a Sampling section to the Event Export page, settings entries for
metric_export_sample_by / _field / _permille, and a stats_sample_by
anchor for cross-linking.

Sampling hashes a configured event field (typically session) and
forwards only the fraction set by permille (parts per thousand) to the
exporter, while in-process statistics counters keep counting every
event. Multiple sample_by blocks combine with AND semantics.
Adds settings entries for event_exporter_opentelemetry_endpoint_url /
event_exporter_opentelemetry_trace_id_field /
event_exporter_opentelemetry_timeout, a new OpenTelemetry section
explaining trace correlation, sub-session linking via Span.Link, span
timing, both protobuf and JSON wire formats selected via
event_exporter_format, and the link to the sampling section.

Whitelist the new spell-check terms in .github/actions/spelling/allow.txt.
Add event_exporter_opentelemetry_emit_spans and
event_exporter_opentelemetry_emit_logs settings, and describe the OTLP
LogRecord output shape, severity mapping, and trace/span correlation.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant