Filestats Receiver

Available in: contrib Maintainers: @atoulme Source: opentelemetry-collector-contrib

Supported Telemetry

include (required): The glob path for files to watch
collection_interval (default = 1m): The interval at which metrics are emitted by this receiver.
initial_delay (default = 1s): defines how long this receiver waits before starting.

receivers:
  filestats:
    include: /tmp/files/*
    collection_interval: 10s
    initial_delay: 1s

See documentation.md for a list of the metrics collected.

Metric Name	Description	Unit	Type	Attributes
❌ `file.atime`	Elapsed time since last access of the file or folder, in seconds since Epoch.	s	UpDownCounter
❌ `file.count`	The number of files matched	{file}	Gauge
❌ `file.ctime`	Elapsed time since the last change of the file or folder, in seconds since Epoch. In addition to `file.mtime`, this metric tracks metadata changes such as permissions or renaming the file.	s	UpDownCounter	file.permissions
✅ `file.mtime`	Elapsed time since the last modification of the file or folder, in seconds since Epoch.	s	UpDownCounter
✅ `file.size`	The size of the file or folder, in bytes.	b	Gauge

Attribute Name	Description	Type	Values
`file.permissions`	the permissions associated with the file, using an octal format.	string

Attribute Name	Description	Type	Enabled
`file.name`	The name of the file	string	✅
`file.path`	The absolute path of the file	string	❌

Last generated: 2026-04-13