WARNING: Version 6.2 of Metricbeat has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
System filesystem metricset
editSystem filesystem metricset
editThe System filesystem
metricset provides file system statistics. For each file
system, one document is provided.
This metricset is available on:
- FreeBSD
- Linux
- macOS
- OpenBSD
- Windows
Configuration
editfilesystem.ignore_types
- A list of filesystem types to ignore. Metrics will
not be collected from filesystems matching these types. This setting also
affects the fsstats
metricset.
Filtering
editOften there are mounted filesystems that you do not want Metricbeat to report
metrics on. One option is to configure Metricbeat to ignore specific filesystem
types. This can be accomplished by configuring filesystem.ignore_types
with
a list of filesystem types to ignore. In this example we are ignoring three
types of filesystems.
metricbeat.modules: - module: system period: 30s metricsets: ["filesystem"] filesystem.ignore_types: [nfs, smbfs, autofs]
Another strategy to deal with these filesystems is to configure a drop_event
processor that matches the mount_point
using a regular expression. This type
of filtering occurs after the data has been collected so it can be less
efficient than the previous method.
metricbeat.modules: - module: system period: 30s metricsets: ["filesystem"] processors: - drop_event.when.regexp: system.filesystem.mount_point: '^/(sys|cgroup|proc|dev|etc|host)($|/)'
Fields
editFor a description of each field in the metricset, see the exported fields section.
Here is an example document generated by this metricset:
{ "@timestamp": "2017-10-12T08:05:34.853Z", "beat": { "hostname": "host.example.com", "name": "host.example.com" }, "metricset": { "module": "system", "name": "filesystem", "rtt": 115 }, "system": { "filesystem": { "available": 50085941248, "device_name": "overlay", "files": 4194304, "free": 53538639872, "free_files": 3862303, "mount_point": "/", "total": 67371577344, "type": "overlay", "used": { "bytes": 13832937472, "pct": 0.2053 } } } }