telegraf/plugins/inputs/file/README.md

30 lines
900 B
Markdown
Raw Normal View History

# File Input Plugin
The file plugin parses the **complete** contents of a file **every interval** using
the selected [input data format][].
**Note:** If you wish to parse only newly appended lines use the [tail][] input
plugin instead.
### Configuration:
```toml
[[inputs.file]]
## Files to parse each interval. Accept standard unix glob matching rules,
## as well as ** to match recursive files and directories.
files = ["/tmp/metrics.out"]
## 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 = "influx"
## Name a tag containing the name of the file the data was parsed from. Leave empty
## to disable.
# file_tag = ""
```
[input data format]: /docs/DATA_FORMATS_INPUT.md
[tail]: /plugins/inputs/tail