Skip to content

events/export: Document metric_export_sample_by#1539

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

events/export: Document metric_export_sample_by#1539
cmouse wants to merge 2 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

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.
@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 3 times, most recently from 310fa98 to 4ceb910 Compare May 15, 2026 16:52
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.
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