documentation.md

file_stats

Default Metrics

The following metrics are emitted by default. Each of them can be disabled by applying the following configuration:

metrics:
  <metric_name>:
    enabled: false

file.mtime

Elapsed time since the last modification of the file or folder, in seconds since Epoch.

Unit	Metric Type	Value Type	Aggregation Temporality	Monotonic	Stability
s	Sum	Int	Cumulative	false	Development

file.size

The size of the file or folder, in bytes.

Unit	Metric Type	Value Type	Stability
b	Gauge	Int	Development

Optional Metrics

The following metrics are not emitted by default. Each of them can be enabled by applying the following configuration:

metrics:
  <metric_name>:
    enabled: true

file.atime

Elapsed time since last access of the file or folder, in seconds since Epoch.

Unit	Metric Type	Value Type	Aggregation Temporality	Monotonic	Stability
s	Sum	Int	Cumulative	false	Development

file.count

The number of files matched

Unit	Metric Type	Value Type	Stability
{file}	Gauge	Int	Development

Attributes

Name	Description	Values	Requirement Level	Semantic Convention
file.include	The glob pattern configured via the include option that produced this count.	Any Str	Opt-In	-

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.

Unit	Metric Type	Value Type	Aggregation Temporality	Monotonic	Stability
s	Sum	Int	Cumulative	false	Development

Attributes

Name	Description	Values	Requirement Level	Semantic Convention
file.permissions	the permissions associated with the file, using an octal format.	Any Str	Recommended	-

Resource Attributes

Name	Description	Values	Enabled	Semantic Convention	Stability
file.name	The name of the file	Any Str	true	-	-
file.path	The absolute path of the file	Any Str	false	-	-