# Check Ceph diskfree

## Introduction

**check_cehp_diskfree** is a plugin to show the available and free diskspace.
It returns a single line for the status, data and performance data.

## Requirements

* `ceph` binary and sudo permission on it to get the information

```txt
icingaclient ALL=(ALL) NOPASSWD: /bin/ceph
```

## Syntax

```
$ check_ceph_diskfree -h
______________________________________________________________________

CHECK_CEPH_DISKFREE 
v1.3

(c) Institute for Medical Education - University of Bern
Licence: GNU GPL 3
______________________________________________________________________

Show available and free space on a ceph cluster.
This check sends performance data.

It uses 'ceph df' to parse data.

SYNTAX:
check_ceph_diskfree

OPTIONS:
    -h or --help   show this help.
```

### Parameters

(none)

## Examples

`$ check_ceph_diskfree` returns

```txt
check_ceph_diskfree 
OK: Disksize on Ceph cluster and its pools - warnings: 0 (70 %) .. critcal: 0 (90 %)

           --- RAW STORAGE ---
           CLASS    SIZE   AVAIL     USED  RAW USED  %RAW USED
OK         ssd    54 TiB  53 TiB  767 GiB   767 GiB       1.40
OK         TOTAL  54 TiB  53 TiB  767 GiB   767 GiB       1.40

           --- POOLS ---
           POOL  ID  PGS   STORED  OBJECTS     USED  %USED  MAX AVAIL
OK         .mgr   1    1   18 MiB        6   18 MiB      0     16 TiB
OK         one    2   32  255 GiB   66.65k  255 GiB   0.50     16 TiB
OK         two    3   32      0 B        0      0 B      0     25 TiB
 |global-total=59373627899904;;;0;59373627899904 global-avail=58274116272128;;;0;59373627899904 global-used=823559979008;;;0;59373627899904 
```