Skip to content

Conversation

@gmarouli
Copy link
Contributor

@gmarouli gmarouli commented Jan 8, 2026

Summary

This PR is documenting the a new time series metric type that is added in 9.3 the histogram. A time series metric histogram supports two types, histogram and exponential histogram. Furthermore, we document that it can be downsampled and what happens when it's downsampled with the aggregate method.

The last value downsampling method will be documented in a follow up PR.

Part of #136294

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

@github-actions
Copy link
Contributor

github-actions bot commented Jan 8, 2026

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 8, 2026

@gmarouli gmarouli requested a review from marciw January 12, 2026 18:45
Co-authored-by: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com>

`counter`
: A cumulative metric that only monotonically increases or resets to `0` (zero). For example, a count of errors or completed tasks that resets when a serving process restarts.
: A cumulative metric that only monotonically increases or resets to `0` (zero). For example, a count of errors or completed tasks that resets when a serving process restarts. A counter is supported by all [numeric field types](elasticsearch://reference/elasticsearch/mapping-reference/number.md)
Copy link
Contributor

Choose a reason for hiding this comment

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

Is this int, long and double?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The mapping accepts all numeric fields, I have tried scaled_float, float, byte, short. I haven't tested it end to end though, I mean index data, downsample, run ESQL queries. Do you think this is something we need to explore further?

Copy link
Contributor

@kkrik-es kkrik-es left a comment

Choose a reason for hiding this comment

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

Just a few nits. It'd be nice to have Marci take a look too.

Copy link
Contributor

@marciw marciw left a comment

Choose a reason for hiding this comment

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

LGTM with small suggestions.

Co-authored-by: Marci W <333176+marciw@users.noreply.github.com>
@gmarouli gmarouli enabled auto-merge (squash) January 14, 2026 07:08
@gmarouli gmarouli merged commit f3bb8dc into main Jan 14, 2026
7 of 8 checks passed
@gmarouli gmarouli deleted the add-time-series-histogram branch January 14, 2026 07:11
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.

4 participants