telegraf/plugins/inputs/filestat
Samuel-BF f530ca6e7c Use godirwalk in globpath (#5145) 2018-12-18 14:23:25 -08:00
..
testdata
README.md Document units of filestat modification time 2018-10-22 12:41:37 -07:00
filestat.go Use godirwalk in globpath (#5145) 2018-12-18 14:23:25 -08:00
filestat_test.go Add modification_time field to filestat input plugin (#3305) 2017-11-07 14:32:48 -08:00

README.md

filestat Input Plugin

The filestat plugin gathers metrics about file existence, size, and other stats.

Configuration:

# Read stats about given file(s)
[[inputs.filestat]]
  ## Files to gather stats about.
  ## These accept standard unix glob matching rules, but with the addition of
  ## ** as a "super asterisk". See https://github.com/gobwas/glob.
  files = ["/etc/telegraf/telegraf.conf", "/var/log/**.log"]
  ## If true, read the entire file and calculate an md5 checksum.
  md5 = false

Measurements & Fields:

  • filestat
    • exists (int, 0 | 1)
    • size_bytes (int, bytes)
    • modification_time (int, unix time nanoseconds)
    • md5 (optional, string)

Tags:

  • All measurements have the following tags:
    • file (the path the to file, as specified in the config)

Example Output:

$ telegraf --config /etc/telegraf/telegraf.conf --input-filter filestat --test
* Plugin: filestat, Collection 1
> filestat,file=/tmp/foo/bar,host=tyrion exists=0i 1507218518192154351
> filestat,file=/Users/sparrc/ws/telegraf.conf,host=tyrion exists=1i,size=47894i,modification_time=1507152973123456789i  1507218518192154351