History

David Bennett 842a788022 Remove error return type from metric.New method (#9116 ) * Remove error return type from metric.New method. * Formatting changes for linter + gofmt * Additional linter fixes. * More linter fixes. * Linter fix. * address comments		2021-04-13 14:40:03 -04:00
..
README.md	Split parser/serializer docs (#4690 )	2018-09-17 11:45:08 -07:00
parser.go	Remove error return type from metric.New method (#9116 )	2021-04-13 14:40:03 -04:00
parser_test.go	Add 'field name' config option to customize field name when using Value parser. (#8979 )	2021-03-11 21:53:32 -05:00

README.md

Value

The "value" data format translates single values into Telegraf metrics. This is done by assigning a measurement name and setting a single field ("value") as the parsed metric.

Configuration

You must tell Telegraf what type of metric to collect by using the data_type configuration option. Available options are:

integer
float or long
string
boolean

Note: It is also recommended that you set name_override to a measurement name that makes sense for your metric, otherwise it will just be set to the name of the plugin.

[[inputs.exec]]
  ## Commands array
  commands = ["cat /proc/sys/kernel/random/entropy_avail"]

  ## override the default metric name of "exec"
  name_override = "entropy_available"

  ## Data format to consume.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ##   https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_INPUT.md
  data_format = "value"
  data_type = "integer" # required