Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[documentation] Update rollup rules documentation to provide an example of aggregating gauges #3852

Merged
merged 2 commits into from
Oct 18, 2021

Conversation

robskillington
Copy link
Collaborator

What this PR does / why we need it:

Adds examples of how to write rollup rules that aggregate gauges across a set of instances.

Special notes for your reviewer:

Does this PR introduce a user-facing and/or backwards incompatible change?:

NONE

Does this PR require updating code package or user-facing documentation?:

NONE

- name: "job queue length sum across pods pod"
filter: "__name__:job_queue_length k8s_pod:*"
transforms:
- aggregate:
Copy link
Collaborator

Choose a reason for hiding this comment

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

nit: this is not required. not sure if it's worth documenting anything about the "default aggregation" applied if one is not set.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Fair, I think it's worth keeping here just for a level of understanding of the reader of the explicit steps happening for each of the aggregations.

We should document the default aggregation somewhere else though to your point, perhaps in a followup change.

type: "Last"
- rollup:
metricName: "job_queue_length:sum"
excludeBy: ["k8s_pod"]
Copy link
Collaborator

Choose a reason for hiding this comment

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

nit: maybe show a groupBy in addition to an excludeBy

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Good point, I might do that in a followup.

@robskillington robskillington enabled auto-merge (squash) October 18, 2021 14:25
@robskillington robskillington merged commit e161dc8 into master Oct 18, 2021
@robskillington robskillington deleted the r/add-aggregating-gauges-example branch October 18, 2021 14:42
soundvibe pushed a commit that referenced this pull request Oct 26, 2021
* master:
  Remove unused message-read-error metric (#3869)
  Add p75/p25 as aggregation options (#3867)
  [aggregator] track dirty values to consume instead of scanning all within buffer past (#3847)
  [rules] Correctly match rollup tags for excludeBy operations (#3865)
  [dbnode] Create empty warm index fileset (#3859)
  [aggregator] Allow wait during tick to be interrupted on close (#3861)
  [aggregator] Add support for default configuration (#3856)
  [dbnode] Add WriteAttempt integration test index helper method (#3860)
  [tools] Allow reading all the shards in the directory in read_data_files (#3857)
  [tests] Add test for in-process aggregator writes
  [tools] Add annotation_checker tool (#3854)
  [tests] Convert docker-integration-tests/simple/test.sh to in-process test (#3850)
  [documentation] Update rollup rules documentation to provide an example of aggregating gauges (#3852)
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.

3 participants