Skip to content

Document metrics temporality for time series data streams#7174

Open
JonasKunz wants to merge 11 commits into
elastic:mainfrom
JonasKunz:temporality-documentation
Open

Document metrics temporality for time series data streams#7174
JonasKunz wants to merge 11 commits into
elastic:mainfrom
JonasKunz:temporality-documentation

Conversation

@JonasKunz

@JonasKunz JonasKunz commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds documentation for the metrics temporality feature (GA in 9.5) in time series data streams (TSDS):

  • New page: Metrics temporality — Explains the difference between cumulative and delta temporality for counter and histogram metrics, how to configure temporality via the index.time_series.temporality_field index setting, and how temporality affects ES|QL time series queries (rate, increase, irate) and downsampling.
  • Updated TSDS overview — Revised counter and histogram metric type descriptions to reference temporality and link to the new page. Added a "Learn more" link for metrics temporality.
  • Updated downsampling concepts — Documents temporality-aware downsampling behavior for counters (delta counters store the sum) and histograms (cumulative histograms use the same algorithm as cumulative counters).
  • Updated OTLP endpoint docs — New section explaining that the OTLP endpoint automatically preserves metric temporality in a temporality dimension, with a note on histogram field type requirements.
  • Navigation — Added the new page to the TSDS advanced topics TOC.

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

@github-actions

github-actions Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs Style Checker (Vale)

Summary: 6 warnings found

⚠️ Warnings (6): Fix when the suggestion improves clarity or correctness.
File Line Rule Message
manage-data/data-store/data-streams/downsampling-concepts.md 78 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
manage-data/data-store/data-streams/downsampling-concepts.md 79 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
manage-data/data-store/data-streams/downsampling-concepts.md 86 Elastic.Latinisms Latin terms and abbreviations are a common source of confusion. Use 'versus' instead of 'vs'.
manage-data/data-store/data-streams/metric-temporality.md 46 Elastic.DontUse Don't use 'just'.
manage-data/data-store/data-streams/metric-temporality.md 72 Elastic.Spelling 'temporalities' is a possible misspelling.
manage-data/data-store/data-streams/metric-temporality.md 101 Elastic.EndPuntuaction Don't end headings with punctuation.

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.

@JonasKunz JonasKunz marked this pull request as ready for review July 2, 2026 08:53
@JonasKunz JonasKunz requested review from a team as code owners July 2, 2026 08:53
@JonasKunz JonasKunz requested a review from kkrik-es July 2, 2026 08:58
Comment thread manage-data/data-store/data-streams/downsampling-concepts.md Outdated
Comment thread manage-data/data-store/data-streams/metric-temporality.md Outdated
Comment thread manage-data/data-store/data-streams/metric-temporality.md Outdated
Comment thread manage-data/data-store/data-streams/time-series-data-stream-tsds.md Outdated
Comment thread manage-data/ingest/otlp-endpoint.md Outdated
@kkrik-es kkrik-es requested a review from leemthompo July 2, 2026 09:49
@kkrik-es

kkrik-es commented Jul 2, 2026

Copy link
Copy Markdown
Member

Liam may want to take a quick look too.

JonasKunz and others added 2 commits July 2, 2026 12:00
Co-authored-by: Kostas Krikellas <131142368+kkrik-es@users.noreply.github.com>
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.

2 participants