filecount

README

filecount Input Plugin

Counts files in directories that match certain criteria.

Configuration:

# Count files in a directory
[[inputs.filecount]]
  ## Directory to gather stats about.
  ##   deprecated in 1.9; use the directories option
  directory = "/var/cache/apt/archives"

  ## Directories to gather stats about.
  ## This accept standard unit glob matching rules, but with the addition of
  ## ** as a "super asterisk". ie:
  ##   /var/log/**    -> recursively find all directories in /var/log and count files in each directories
  ##   /var/log/*/*   -> find all directories with a parent dir in /var/log and count files in each directories
  ##   /var/log       -> count all files in /var/log and all of its subdirectories
  directories = ["/var/cache/apt/archives"]

  ## Only count files that match the name pattern. Defaults to "*".
  name = "*.deb"

  ## Count files in subdirectories. Defaults to true.
  recursive = false

  ## Only count regular files. Defaults to true.
  regular_only = true

  ## Only count files that are at least this size. If size is
  ## a negative number, only count files that are smaller than the
  ## absolute value of size. Acceptable units are B, KiB, MiB, KB, ...
  ## Without quotes and units, interpreted as size in bytes.
  size = "0B"

  ## Only count files that have not been touched for at least this
  ## duration. If mtime is negative, only count files that have been
  ## touched in this duration. Defaults to "0s".
  mtime = "0s"

Measurements & Fields:

• filecount
  • count (int)
  • size_bytes (int)

Tags:

• All measurements have the following tags:
  • directory (the directory path)

Example Output:

$ telegraf --config /etc/telegraf/telegraf.conf --input-filter filecount --test
> filecount,directory=/var/cache/apt,host=czernobog count=7i,size=7438336i 1530034445000000000
> filecount,directory=/tmp,host=czernobog count=17i,size=28934786i 1530034445000000000

Documentation

Index

• type FileCount
  • func NewFileCount() *FileCount
  • func (_ *FileCount) Description() string
  • func (fc *FileCount) Gather(acc telegraf.Accumulator) error
  • func (_ *FileCount) SampleConfig() string

Types

type FileCount

type FileCount struct {
	Directory   string // deprecated in 1.9
	Directories []string
	Name        string
	Recursive   bool
	RegularOnly bool
	Size        internal.Size
	MTime       internal.Duration `toml:"mtime"`
	// contains filtered or unexported fields
}

func NewFileCount

func NewFileCount() *FileCount

func (*FileCount) Description

func (_ *FileCount) Description() string

func (*FileCount) Gather

func (fc *FileCount) Gather(acc telegraf.Accumulator) error

func (*FileCount) SampleConfig

func (_ *FileCount) SampleConfig() string