---
title: Btrfs
description: Monitor usage on Btrfs volumes so you can respond before they fill up.
breadcrumbs: Docs > Integrations > Btrfs
---

# Btrfs
Supported OS Integration version4.3.0


## Overview{% #overview %}

Get metrics from Btrfs in real time to:

- Visualize and monitor Btrfs states.

**Minimum Agent version:** 6.0.0

## Setup{% #setup %}

### Installation{% #installation %}

The Btrfs check is included in the [Datadog Agent](https://app.datadoghq.com/account/settings/agent/latest) package, so you don't need to install anything else on your servers that use at least one Btrfs filesystem.

### Configuration{% #configuration %}

1. Edit the `btrfs.d/conf.yaml` file in the `conf.d/` folder at the root of your [Agent's configuration directory](https://docs.datadoghq.com/agent/guide/agent-configuration-files.md#agent-configuration-directory). See the [sample btrfs.d/conf.yaml](https://github.com/DataDog/integrations-core/blob/master/btrfs/datadog_checks/btrfs/data/conf.yaml.example) for all available configuration options.

1. [Restart the Agent](https://docs.datadoghq.com/agent/guide/agent-commands.md#start-stop-and-restart-the-agent).

### Validation{% #validation %}

[Run the Agent's status subcommand](https://docs.datadoghq.com/agent/guide/agent-commands.md#agent-status-and-information) and look for `btrfs` under the Checks section.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **system.disk.btrfs.free**(gauge)        | The free space on a device*Shown as byte*                                          |
| **system.disk.btrfs.total**(gauge)       | The total amount of space on a device*Shown as byte*                               |
| **system.disk.btrfs.unallocated**(gauge) | The amount of unallocated 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* |
| **system.disk.btrfs.used**(gauge)        | The used space on a device*Shown as byte*                                          |

### Events{% #events %}

The Btrfs check does not include any events.

### Service Checks{% #service-checks %}

The Btrfs check does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).