2020-07-30 16:34:24 +00:00
|
|
|
---
|
|
|
|
|
title: Value input data format
|
2020-08-24 20:59:38 +00:00
|
|
|
description: Use the `value` input data format to parse single values into Telegraf metrics.
|
2020-07-30 16:34:24 +00:00
|
|
|
menu:
|
|
|
|
|
telegraf_1_15:
|
|
|
|
|
name: Value
|
|
|
|
|
weight: 100
|
|
|
|
|
parent: Input data formats
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The "value" input 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 data type options are:
|
|
|
|
|
|
|
|
|
|
1. integer
|
|
|
|
|
2. float or long
|
|
|
|
|
3. string
|
|
|
|
|
4. 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.
|
|
|
|
|
|
|
|
|
|
```toml
|
|
|
|
|
[[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
|
|
|
|
|
```
|
