Skip to content

Conversation

jihyunjeongme
Copy link
Contributor

👋 howdy, team!

This PR adds a note explaining that time series indices require:

  • index.mode set to "time_series"
  • at least one dimension field with time_series_dimension: true
  • a routing_path array listing those dimension fields

Without these settings, the time_series aggregation may return empty buckets or behave unexpectedly. By emphasizing the dimension field requirement, we help users configure their time series indices correctly and see meaningful aggregation results.

👋 howdy, team!

This PR adds a note explaining that time series indices require:
- index.mode set to "time_series"
- at least one dimension field with time_series_dimension: true
- a routing_path array listing those dimension fields

Without these settings, the time_series aggregation may return empty buckets or behave unexpectedly. By emphasizing the dimension field requirement, we help users configure their time series indices correctly and see meaningful aggregation results.
@jihyunjeongme jihyunjeongme added >enhancement >docs General docs changes Team:Docs Meta label for docs team Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. labels Jan 2, 2025
@jihyunjeongme jihyunjeongme requested a review from a team January 2, 2025 00:13
Copy link
Contributor

github-actions bot commented Jan 2, 2025

Documentation preview:

@elasticsearchmachine
Copy link
Collaborator

@jihyunjeongme please enable the option "Allow edits and access to secrets by maintainers" on your PR. For more information, see the documentation.

@elasticsearchmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

@elasticsearchmachine elasticsearchmachine added the external-contributor Pull request authored by a developer outside the Elasticsearch team label Jan 2, 2025
@leemthompo leemthompo added auto-backport Automatically create backport pull requests when merged v8.17.0 v8.18.0 labels Jan 29, 2025
@leemthompo
Copy link
Contributor

run docs-build

@leemthompo leemthompo merged commit e120739 into main Jan 29, 2025
6 checks passed
@leemthompo leemthompo deleted the jihyunjeongme-patch-1 branch January 29, 2025 12:03
@leemthompo
Copy link
Contributor

💚 All backports created successfully

Status Branch Result
8.x
8.17

Questions ?

Please refer to the Backport tool documentation

leemthompo added a commit to leemthompo/elasticsearch that referenced this pull request Jan 29, 2025
…on (elastic#119442)

* (Doc+) Clarify dimension field requirements for time_series aggregation

👋 howdy, team!

This PR adds a note explaining that time series indices require:
- index.mode set to "time_series"
- at least one dimension field with time_series_dimension: true
- a routing_path array listing those dimension fields

Without these settings, the time_series aggregation may return empty buckets or behave unexpectedly. By emphasizing the dimension field requirement, we help users configure their time series indices correctly and see meaningful aggregation results.

* Apply suggestions from code review

Co-authored-by: shainaraskas <[email protected]>

---------

Co-authored-by: Liam Thompson <[email protected]>
Co-authored-by: shainaraskas <[email protected]>
(cherry picked from commit e120739)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

auto-backport Automatically create backport pull requests when merged >docs General docs changes >enhancement external-contributor Pull request authored by a developer outside the Elasticsearch team Supportability Improve our (devs, SREs, support eng, users) ability to troubleshoot/self-service product better. Team:Docs Meta label for docs team v8.17.0 v8.18.0 v9.0.0

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants