fluent-plugin-numeric-monitor
Fluentd plugin to calculate min/max/avg/sum and specified percentile values (and 'num' of matched messages), which used in notifications (such as fluent-plugin-notifier)
Requirements
| fluent-plugin-numeric-monitor | fluentd | ruby |
|---|---|---|
| >= 1.0.0 | >= v0.14.0 | >= 2.1 |
| < 1.0.0 | < v0.14.0 | >= 1.9 |
Configuration
NumericMonitorOutput
To calculate about HTTP requests duration (microseconds) in 'duraion', with 90 and 95 percentile values:
<match apache.log.**>
@type numeric_monitor
@label @monitor_result
tag monitor.duration
unit minute
aggregate all
monitor_key duration
percentiles 90,95
input_tag_remove_prefix apache.log
</match>
<label @monitor_result>
<match monitor.duration>
# output result data into visualization tools or ...
</match>
</label>
Output messages like:
{"min":3012,"max":913243,"avg":100123.51,"sum":5007376982,"percentile_90":154390,"percentile_95":223110,"num":50012}
Parameters
-
monitor_key (required)
The key to monitor in the event record.
-
percentiles
Activate the percentile monitoring. Must be specified between
1and99by integer separeted by , (comma). -
tag
The output tag. Default is
monitor. -
tag_prefix
The prefix string which will be added to the input tag.
output_per_tag yesmust be specified together (deprecated: use@labelfor event routing instead). -
input_tag_remove_prefix
The prefix string which will be removed from the input tag.
-
count_interval
The interval time to monitor in seconds. Default is
60. -
unit
The interval time to monitor specified an unit (either of
minute,hour, orday). Use either ofcount_intervalorunit. -
aggregate
Calculate in each input
tagseparetely, orallrecords in a mass. Default istag -
output_per_tag
Emit for each input tag.
tag_prefixmust be specified together. Default isno. -
output_key_prefix
The prefix string which will be added to the output key.
-
samples_limit
The limit number of sampling. Default is
1000000.
TODO
- more tests
- more documents
Copyright
- Copyright
- Copyright (c) 2012- TAGOMORI Satoshi (tagomoris)
- License
- Apache License, Version 2.0