Skip to content

Check fs-xfs-stats

Overview

This plugin provides some internal XFS statistics to user's view, which can be helpful on debugging/understanding IO characteristics and optimizing performance. It does not check anything.

For further information, have a look at https://xfs.org/index.php/Runtime_Stats.

Fact Sheet

Fact Value
Check Plugin Download https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/fs-xfs-stats
Check Interval Recommendation Once a minute
Can be called without parameters Yes
Compiled for Windows No
Perfdata compatible with Prometheus Yes

Help

usage: fs-xfs-stats [-h] [-V]

This check provides some internal XFS statistics to user's view, which can be
helpful on debugging/understanding IO characteristics and optimizing
performance.

options:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit

Usage Examples

./fs-xfs-stats

Output:

Everything is ok. Extent allocation, btree, block mapping, btree, directory operation, inode operation, vnode and read write stats collected.

States

  • WARN if returned statistic is malformed.
  • Otherwise always OK.

Perfdata / Metrics

Name Type Description
allocation_btree_compares_total Continous Counter Number of allocation B-tree compares for a filesystem.
allocation_btree_lookups_total Continous Counter Number of allocation B-tree lookups for a filesystem.
allocation_btree_records_deleted_total Continous Counter Number of allocation B-tree records deleted for a filesystem.
allocation_btree_records_inserted_total Continous Counter Number of allocation B-tree records inserted for a filesystem.
block_map_btree_compares_total Continous Counter Number of block map B-tree compares for a filesystem.
block_map_btree_lookups_total Continous Counter Number of block map B-tree lookups for a filesystem.
block_map_btree_records_deleted_total Continous Counter Number of block map B-tree records deleted for a filesystem.
block_map_btree_records_inserted_total Continous Counter Number of block map B-tree records inserted for a filesystem.
block_mapping_extent_list_compares_total Continous Counter Number of extent list compares for a filesystem.
block_mapping_extent_list_deletions_total Continous Counter Number of extent list deletions for a filesystem.
block_mapping_extent_list_insertions_total Continous Counter Number of extent list insertions for a filesystem.
block_mapping_extent_list_lookups_total Continous Counter Number of extent list lookups for a filesystem.
block_mapping_reads_total Continous Counter Number of block map for read operations for a filesystem.
block_mapping_unmaps_total Continous Counter Number of block unmaps (deletes) for a filesystem.
block_mapping_writes_total Continous Counter Number of block map for write operations for a filesystem.
directory_operation_create_total Continous Counter Number of times a new directory entry was created for a filesystem.
directory_operation_getdents_total Continous Counter Number of times the directory getdents operation was performed for a filesystem.
directory_operation_lookup_total Continous Counter Number of file name directory lookups which miss the operating systems directory name lookup cache.
directory_operation_remove_total Continous Counter Number of times an existing directory entry was created for a filesystem.
extent_allocation_blocks_allocated_total Continous Counter Number of blocks allocated for a filesystem.
extent_allocation_blocks_freed_total Continous Counter Number of blocks freed for a filesystem.
extent_allocation_extents_allocated_total Continous Counter Number of extents allocated for a filesystem.
extent_allocation_extents_freed_total Continous Counter Number of extents freed for a filesystem.
inode_operation_attempts_total Continous Counter Number of times the OS looked for an XFS inode in the inode cache.
inode_operation_attribute_changes_total Continous Counter Number of times the OS explicitly changed the attributes of an XFS inode.
inode_operation_duplicates_total Continous Counter Number of times the OS tried to add a missing XFS inode to the inode cache, but found it had already been added by another process.
inode_operation_found_total Continous Counter Number of times the OS looked for and found an XFS inode in the inode cache.
inode_operation_missed_total Continous Counter Number of times the OS looked for an XFS inode in the cache, but did not find it.
inode_operation_reclaims_total Continous Counter Number of times the OS reclaimed an XFS inode from the inode cache to free memory for another purpose.
inode_operation_recycled_total Continous Counter Number of times the OS found an XFS inode in the cache, but could not use it as it was being recycled.
read_calls_total Continous Counter Number of read(2) system calls made to files in a filesystem.
vnode_active_total Continous Counter Number of vnodes not on free lists for a filesystem.
vnode_allocate_total Continous Counter Number of times vn_alloc called for a filesystem.
vnode_get_total Continous Counter Number of times vn_get called for a filesystem.
vnode_hold_total Continous Counter Number of times vn_hold called for a filesystem.
vnode_reclaim_total Continous Counter Number of times vn_reclaim called for a filesystem.
vnode_release_total Continous Counter Number of times vn_rele called for a filesystem.
vnode_remove_total Continous Counter Number of times vn_remove called for a filesystem.
write_calls_total Continous Counter Number of write(2) system calls made to files in a filesystem.

Troubleshooting

I/O error "No such file or directory" while opening or reading /proc/fs/xfs/stat
VM does not use a XFS-based filesystem, instead Ext4 or other. Disable the check for this machine.

Credits, License