File

Due to the nature of container storage with layered and overlay filesystems, segmenting fs.* metrics by container may return unexpected results and should be used with care. Typically they will report statistics of host filesystems mounted to the container, which can report duplication of metrics. They are not designed to report storage usage by container.
  • sysdig_fs_* metrics are based on mounted filesystems for both hosts and containers, and are generated for each filesystem.
  • sysdig_host_fs_* and sysdig_container_fs_* are nothing but sum aggregates of mounted filesystems on host and container respectively.
  • File systems in containers are filtered out based on !(“tmpfs".equals(device) || mountDir.startsWith("/sys/fs/cgroup") || mountDir.startsWith("/proc/") || mountDir.contains("/secrets") || mountDir.startsWith("/etc") || device.startsWith("overlay”)). However, they seem to be included in the aggregated sysdig_container_fs_* metrics.
  • sysdig_fs_* metrics have the same name for both host and container file systems and therefore use a filter to view individual types.
    • To view only host filesystems, apply the {container_id = ‘’} filter.
    • To view only the file systems mounted to containers, apply the {container_id !=‘’ condition.

sysdig_filestats_host_file_error_total_count

Prometheus IDsysdig_filestats_host_file_error_total_count
Legacy IDfile.error.total.count
Metric Typecounter
Unitnumber
DescriptionNumber of error caused by file access.
Additional NotesBy default, this metric shows the total value for the selected scope. For instance, if you apply it to a group of machines, you will see the total value for the whole group. However, you can easily segment the metric to see it by host, process, container, and so on. Just use ‘Segment by’ in the UI.

sysdig_filestats_host_file_in_bytes

Prometheus IDsysdig_filestats_host_file_in_bytes
Legacy IDfile.bytes.in
Metric Typecounter
Unitdata
DescriptionAmount of bytes read from file.
Additional NotesBy default, this metric shows the total value for the selected scope. For instance, if you apply it to a group of machines, you will see the total value for the whole group. However, you can easily segment the metric to see it by host, process, container, and so on. Just use ‘Segment by’ in the UI.

sysdig_filestats_host_file_open_count

Prometheus IDsysdig_filestats_host_file_open_count
Legacy IDfile.open.count
Metric Typecounter
Unitnumber
DescriptionWhen segmenting by file name, the metric represents the rate of open events for a particular file With other segmentations, it represents the number of all files currently open in a particular context (host, container, process, etc.).
Additional Notes

sysdig_filestats_host_file_out_bytes

Prometheus IDsysdig_filestats_host_file_out_bytes
Legacy IDfile.bytes.out
Metric Typecounter
Unitdata
DescriptionAmount of bytes written to file.
Additional NotesBy default, this metric shows the total value for the selected scope. For instance, if you apply it to a group of machines, you will see the total value for the whole group. However, you can easily segment the metric to see it by host, process, container, and so on. Just use ‘Segment by’ in the UI.

sysdig_filestats_host_file_total_bytes

Prometheus IDsysdig_filestats_host_file_total_bytes
Legacy IDfile.bytes.total
Metric Typecounter
Unitdata
DescriptionAmount of bytes read from and written to file.
Additional NotesBy default, this metric shows the total value for the selected scope. For instance, if you apply it to a group of machines, you will see the total value for the whole group. However, you can easily segment the metric to see it by host, process, container, and so on. Just use ‘Segment by’ in the UI.

sysdig_filestats_host_file_total_time

Prometheus IDsysdig_filestats_host_file_total_time
Legacy IDfile.time.total
Metric Typecounter
Unittime
DescriptionTime spent in file I/O.
Additional NotesBy default, this metric shows the total value for the selected scope. For instance, if you apply it to a group of machines, you will see the total value for the whole group. However, you can easily segment the metric to see it by host, process, container, and so on. Just use ‘Segment by’ in the UI.

sysdig_fs_free_bytes

Prometheus IDsysdig_fs_free_bytes
Legacy IDfs.bytes.free
Metric Typegauge
Unitdata
DescriptionFilesystem available space.
Additional Notes

sysdig_fs_free_percent

Prometheus IDsysdig_fs_free_percent
Legacy IDfs.free.percent
Metric Typegauge
Unitpercent
DescriptionPercentage of filesystem free space.
Additional Notes

sysdig_fs_inodes_total_count

Prometheus IDsysdig_fs_inodes_total_count
Legacy IDfs.inodes.total.count
Metric Typegauge
Unitnumber
Description
Additional Notes

sysdig_fs_inodes_used_count

Prometheus IDsysdig_fs_inodes_used_count
Legacy IDfs.inodes.used.count
Metric Typegauge
Unitnumber
Description
Additional Notes

sysdig_fs_inodes_used_percent

Prometheus IDsysdig_fs_inodes_used_percent
Legacy IDfs.inodes.used.percent
Metric Typegauge
Unitpercent
Description
Additional Notes

sysdig_fs_total_bytes

Prometheus IDsysdig_fs_total_bytes
Legacy IDfs.bytes.total
Metric Typegauge
Unitdata
DescriptionFilesystem size.
Additional Notes

sysdig_fs_used_bytes

Prometheus IDsysdig_fs_used_bytes
Legacy IDfs.bytes.used
Metric Typegauge
Unitdata
DescriptionFilesystem used space.
Additional Notes

sysdig_fs_used_percent

Prometheus IDsysdig_fs_used_percent
Legacy IDfs.used.percent
Metric Typegauge
Unitpercent
DescriptionPercentage of the sum of all filesystems in use.
Additional Notes