Stackstate-btrfs Integration

Overview

Capture Btrfs metrics into Stackstate to:

  • Visualize your file system performance.
  • Correlate the performance of Btrfs file system with the rest of your applications.

Setup

Installation

The Btrfs check is packaged with the Agent, so simply install the agent.

Configuration

To capture Btrfs metrics you need to install the StackState Agent:

  1. Configure the Agent according to your needs, edit conf.d/btrfs.yaml

    init_config:
    
    instances:
        - excluded_devices: []
    

  2. Restart the Agent

Validation

Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:

Checks
======

  [...]

  btrfs
  -----
      - instance #0 [OK]
      - Collected 8 metrics & 0 events

Data Collected

Metrics

system.disk.btrfs.total
(gauge)
The total amount of space on a device
shown as byte
system.disk.btrfs.used
(gauge)
The used space on a device
shown as byte
system.disk.btrfs.free
(gauge)
The free space on a device
shown as byte
system.disk.btrfs.usage
(gauge)
The amount of space used on a device as a fraction of the total
shown as fraction