dom
/
telegraf
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Add sample for exec plugin. Fixes #245 

Closes #258
This commit is contained in:
Eugene Dementiev 2015-10-13 20:50:42 +03:00 committed by Cameron Sparr
parent 0bc76f094a
commit 2a9f31bfea
1 changed files with 24 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
plugins/exec/README.md
View File

@ -1,7 +1,7 @@
# Exec Plugin # Exec Plugin
The exec plugin can execute arbitrary commands which return flattened The exec plugin can execute arbitrary commands which output JSON. Then it flattens JSON and finds
JSON. all numeric values, treating them as floats.
For example, if you have a json-returning command called mycollector, you could For example, if you have a json-returning command called mycollector, you could
setup the exec plugin with: setup the exec plugin with:
@ -18,3 +18,25 @@ The name is used as a prefix for the measurements.
The interval is used to determine how often a particular command should be run. Each The interval is used to determine how often a particular command should be run. Each
time the exec plugin runs, it will only run a particular command if it has been at least time the exec plugin runs, it will only run a particular command if it has been at least
`interval` seconds since the exec plugin last ran the command. `interval` seconds since the exec plugin last ran the command.
# Sample
Let's say that we have a command named "mycollector", which gives the following output:
```json
{
"a": 0.5,
"b": {
"c": "some text",
"d": 0.1,
"e": 5
}
}
```
The collected metrics will be:
```
exec_mycollector_a value=0.5
exec_mycollector_b_d value=0.1
exec_mycollector_b_e value=5
```