docs(downsampler): add performance considerations for trigger design #37
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
2 tasks
sanderson
approved these changes
Jan 2, 2026
Add guidance on consolidating calculations in fewer triggers for better cluster performance. Internal testing showed that 134 individual triggers caused high CPU/memory usage, while consolidated triggers (all calculations per measurement) reduced CPU to ~4% with stable memory. Includes: - Recommended pattern with single trigger per measurement - Not recommended pattern showing anti-pattern to avoid - specific_fields guidance to limit processing - Additional performance tips closes influxdata/DAR#558
jstirnaman
force-pushed
the
dar-558-downsampler-performance
branch
from
9656083 to
cfe38a3
Compare
jstirnaman
commented
Jan 4, 2026
| - **Many triggers** (one calculation each): When 134 triggers were created, each handling a single calculation for a measurement, the cluster showed degraded performance with high CPU and memory usage. | ||
| - **Consolidated triggers** (all calculations per measurement): When triggers were restructured so each one performed all necessary field calculations for a measurement, CPU usage dropped to approximately 4% and memory remained stable. | ||
|
|
||
| #### Recommended <!-- {.green} --> |
Collaborator
Author
There was a problem hiding this comment.
@jstirnaman Rename style to .recommended after support is added in influxdata/docs-v2
jstirnaman
commented
Jan 4, 2026
| temperature_hourly_downsample | ||
| ``` | ||
|
|
||
| #### Not recommended <!-- {.orange} --> |
Collaborator
Author
There was a problem hiding this comment.
@jstirnaman Rename style to .not-recommended after support is added in influxdata/docs-v2
caterryan
approved these changes
Jan 5, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Add performance considerations section to the Downsampler plugin documentation, addressing DAR#558.
Changes
specific_fieldsbest practice documentationKey Finding
Internal testing showed:
Test Plan
Deploy Plan
The workflow is: