Skip to content

feat(om2): classic histogram and summary as complex types#2679

Merged
krajorama merged 3 commits intomainfrom
krajo/om2.0-complex-hist-summ
Feb 5, 2026
Merged

feat(om2): classic histogram and summary as complex types#2679
krajorama merged 3 commits intomainfrom
krajo/om2.0-complex-hist-summ

Conversation

@krajorama
Copy link
Member

@krajorama krajorama commented Jun 16, 2025

@krajorama krajorama changed the title Classic histogram and summary as complex types feat(om2): classic histogram and summary as complex types Jun 16, 2025
@krajorama krajorama force-pushed the krajo/om2.0-complex-hist-summ branch from aca6583 to 4c7a987 Compare June 16, 2025 11:13
dashpole
dashpole previously approved these changes Jun 17, 2025
@bwplotka bwplotka moved this to In Progress in Open Metrics 2.0 Sep 3, 2025
bwplotka
bwplotka previously approved these changes Sep 4, 2025
Copy link
Member

@bwplotka bwplotka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would love that, but as we discussed on our sync - we need a bigger decision if we want to follow this path.

If we do, we likely need some rough uncomplex inlined format explained that is not meant to be used for scraping and can be surfaced with promtool etc.

@krajorama krajorama dismissed stale reviews from bwplotka and dashpole October 3, 2025 09:36

this is a draft, changes incoming, also I made a mistake with the quantile values

dashpole
dashpole previously approved these changes Oct 3, 2025
bwplotka added a commit to prometheus/prometheus that referenced this pull request Oct 7, 2025
This change is for demo purposes, exploring the benefits (and downsides)
for the complex type format for OM2 captured in
prometheus/docs#2679.

This assumes Prometheus stores NS and NHCB (and NH) going forward (for
best case efficiency), but is expected to work for classic mode too with
little overhead (benchmarks will tell us).

Part of the PromCon talk we do with @krajorama

Signed-off-by: bwplotka <bwplotka@gmail.com>
bwplotka added a commit to prometheus/prometheus that referenced this pull request Oct 7, 2025
This change is for demo purposes, exploring the benefits (and downsides)
for the complex type format for OM2 captured in
prometheus/docs#2679.

This assumes Prometheus stores NS and NHCB (and NH) going forward (for
best case efficiency), but is expected to work for classic mode too with
little overhead (benchmarks will tell us).

Part of the PromCon talk we do with @krajorama

Signed-off-by: bwplotka <bwplotka@gmail.com>
bwplotka added a commit to prometheus/prometheus that referenced this pull request Oct 7, 2025
This change is for demo purposes, exploring the benefits (and downsides)
for the complex type format for OM2 captured in
prometheus/docs#2679.

This assumes Prometheus stores NS and NHCB (and NH) going forward (for
best case efficiency), but is expected to work for classic mode too with
little overhead (benchmarks will tell us).

Part of the PromCon talk we do with @krajorama

Signed-off-by: bwplotka <bwplotka@gmail.com>
@bwplotka
Copy link
Member

bwplotka commented Oct 7, 2025

Results are (expectedly) impressive: prometheus/prometheus#17293

One observation is that buckets are a bit dense (readability). However we don't have spaces in any other place (e.g. labels)

bwplotka added a commit to prometheus/prometheus that referenced this pull request Oct 7, 2025
This change is for demo purposes, exploring the benefits (and downsides)
for the complex type format for OM2 captured in
prometheus/docs#2679.

This assumes Prometheus stores NS and NHCB (and NH) going forward (for
best case efficiency), but is expected to work for classic mode too with
little overhead (benchmarks will tell us).

Part of the PromCon talk we do with @krajorama

Signed-off-by: bwplotka <bwplotka@gmail.com>
@jan--f jan--f added the kind/feature New documentation content label Dec 5, 2025
@krajorama krajorama force-pushed the krajo/om2.0-complex-hist-summ branch from 8696022 to 8c8eeae Compare December 10, 2025 15:41
@krajorama krajorama force-pushed the krajo/om2.0-complex-hist-summ branch 7 times, most recently from 10e9bef to 181db08 Compare December 10, 2025 16:13
@dashpole
Copy link
Contributor

dashpole commented Jan 6, 2026

This looks good to me overall. I think we can save float histograms for a follow-up.

Ref: prometheus/OpenMetrics#283

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
@krajorama krajorama force-pushed the krajo/om2.0-complex-hist-summ branch from 181db08 to 578ba94 Compare January 28, 2026 13:37
@krajorama krajorama marked this pull request as ready for review January 28, 2026 13:38
Copy link
Member

@bwplotka bwplotka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok for me, thanks!

Co-authored-by: Bartlomiej Plotka <bwplotka@gmail.com>
Signed-off-by: George Krajcsovits <krajorama@users.noreply.github.com>
Copy link
Contributor

@dashpole dashpole left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm after comment addressed

Say exemplars, not exemplar.

Signed-off-by: György Krajcsovits <gyorgy.krajcsovits@grafana.com>
@krajorama krajorama force-pushed the krajo/om2.0-complex-hist-summ branch from b3a8ea8 to f143b5f Compare February 3, 2026 06:59
@bwplotka
Copy link
Member

bwplotka commented Feb 3, 2026

The failure relates to AM release... 🤔

7:00:32 AM: Checking out release-0.31 of prometheus/alertmanager from ./generated/repos/prometheus/alertmanager.git into /opt/build/repo/generated/repo-docs/prometheus/alertmanager/0.31...
7:00:32 AM: Creating new worktree...
7:00:32 AM: fatal: invalid reference: release-0.31
7:00:32 AM: node:internal/errors:983
7:00:32 AM: const err = new Error(message);

Copy link
Member

@bwplotka bwplotka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's Go!

@krajorama krajorama merged commit 808ed38 into main Feb 5, 2026
6 checks passed
@krajorama krajorama deleted the krajo/om2.0-complex-hist-summ branch February 5, 2026 11:50
@github-project-automation github-project-automation bot moved this from In Progress to Done in Open Metrics 2.0 Feb 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/feature New documentation content

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants