README
¶
Directory Monitor Input Plugin
This plugin monitors a single directory (without looking at sub-directories), and takes in each file placed in the directory.
The plugin will gather all files in the directory at a configurable interval (monitor_interval
), and parse the ones that haven't been picked up yet.
This plugin is intended to read files that are moved or copied to the monitored directory, and thus files should also not be used by another process or else they may fail to be gathered. Please be advised that this plugin pulls files directly after they've been in the directory for the length of the configurable directory_duration_threshold
, and thus files should not be written 'live' to the monitored directory. If you absolutely must write files directly, they must be guaranteed to finish writing before the directory_duration_threshold
.
Configuration:
[[inputs.directory_monitor]]
## The directory to monitor and read files from.
directory = ""
#
## The directory to move finished files to.
finished_directory = ""
#
## The directory to move files to upon file error.
## If not provided, erroring files will stay in the monitored directory.
# error_directory = ""
#
## The amount of time a file is allowed to sit in the directory before it is picked up.
## This time can generally be low but if you choose to have a very large file written to the directory and it's potentially slow,
## set this higher so that the plugin will wait until the file is fully copied to the directory.
# directory_duration_threshold = "50ms"
#
## A list of the only file names to monitor, if necessary. Supports regex. If left blank, all files are ingested.
# files_to_monitor = ["^.*\.csv"]
#
## A list of files to ignore, if necessary. Supports regex.
# files_to_ignore = [".DS_Store"]
#
## Maximum lines of the file to process that have not yet be written by the
## output. For best throughput set to the size of the output's metric_buffer_limit.
## Warning: setting this number higher than the output's metric_buffer_limit can cause dropped metrics.
# max_buffered_metrics = 10000
#
## The maximum amount of file paths to queue up for processing at once, before waiting until files are processed to find more files.
## Lowering this value will result in *slightly* less memory use, with a potential sacrifice in speed efficiency, if absolutely necessary.
# file_queue_size = 100000
#
## The dataformat to be read from the files.
## 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
## NOTE: We currently only support parsing newline-delimited JSON. See the format here: https://github.com/ndjson/ndjson-spec
data_format = "influx"
Documentation
¶
Index ¶
- type DirectoryMonitor
- func (monitor *DirectoryMonitor) Description() string
- func (monitor *DirectoryMonitor) Gather(_ telegraf.Accumulator) error
- func (monitor *DirectoryMonitor) Init() error
- func (monitor *DirectoryMonitor) Monitor()
- func (monitor *DirectoryMonitor) SampleConfig() string
- func (monitor *DirectoryMonitor) SetParserFunc(fn parsers.ParserFunc)
- func (monitor *DirectoryMonitor) Start(acc telegraf.Accumulator) error
- func (monitor *DirectoryMonitor) Stop()
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DirectoryMonitor ¶
type DirectoryMonitor struct { Directory string `toml:"directory"` FinishedDirectory string `toml:"finished_directory"` ErrorDirectory string `toml:"error_directory"` FilesToMonitor []string `toml:"files_to_monitor"` FilesToIgnore []string `toml:"files_to_ignore"` MaxBufferedMetrics int `toml:"max_buffered_metrics"` DirectoryDurationThreshold config.Duration `toml:"directory_duration_threshold"` Log telegraf.Logger `toml:"-"` FileQueueSize int `toml:"file_queue_size"` // contains filtered or unexported fields }
func (*DirectoryMonitor) Description ¶
func (monitor *DirectoryMonitor) Description() string
func (*DirectoryMonitor) Gather ¶
func (monitor *DirectoryMonitor) Gather(_ telegraf.Accumulator) error
func (*DirectoryMonitor) Init ¶
func (monitor *DirectoryMonitor) Init() error
func (*DirectoryMonitor) Monitor ¶
func (monitor *DirectoryMonitor) Monitor()
func (*DirectoryMonitor) SampleConfig ¶
func (monitor *DirectoryMonitor) SampleConfig() string
func (*DirectoryMonitor) SetParserFunc ¶
func (monitor *DirectoryMonitor) SetParserFunc(fn parsers.ParserFunc)
func (*DirectoryMonitor) Start ¶
func (monitor *DirectoryMonitor) Start(acc telegraf.Accumulator) error
func (*DirectoryMonitor) Stop ¶
func (monitor *DirectoryMonitor) Stop()