CL-Softwares
/
telegraf
8
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: Improve behavior documentation of metricpass (#13883)

This commit is contained in:
knollet 2023-09-07 21:55:08 +02:00 committed by GitHub
parent 3607519a40
commit 7fe6bb3fe0
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/CONFIGURATION.md
View File

@ -661,6 +661,12 @@ for time-based filtering. An introduction to the CEL language can be found
are provided in the [language definition][CEL lang] as well as in the are provided in the [language definition][CEL lang] as well as in the
[extension documentation][CEL ext]. [extension documentation][CEL ext].
**NOTE:** Expressions that may be valid and compile, but fail at runtime will
result in the expression reporting as `true`. The metrics will pass through
as a result. An example is when reading a non-existing field. If this happens,
the evaluation is aborted, an error is logged, and the expression is reported as
`true`, so the metric passes.
> NOTE: As CEL is an *interpreted* languguage, this type of filtering is much > NOTE: As CEL is an *interpreted* languguage, this type of filtering is much
> slower compared to `namepass`/`namedrop` and friends. So consider to use the > slower compared to `namepass`/`namedrop` and friends. So consider to use the
> more restricted filter options where possible in case of high-throughput > more restricted filter options where possible in case of high-throughput