---
name: "ocf_heartbeat_storage-mon"
section: "7"
platform: "linux"
package: "resource-agents"
version: "1:4.16.0-3+deb13u2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/ocf_heartbeat_storage-mon"
---

# ocf\_heartbeat\_storage-mon(7)

storage I/O health status

## NAME

ocf\_heartbeat\_storage-mon - storage I/O health status

## SYNOPSIS

**storage-mon** \[start \| stop \| monitor \| meta-data \| validate-all\]

## DESCRIPTION

System health agent that checks the storage I/O status of the given drives and updates the #health-storage attribute. Usage is highly recommended in combination with the HealthSMART monitoring agent. The agent currently support a maximum of 25 devices per instance.

## SUPPORTED PARAMETERS

**state\_file**

Location to store the resource state in.

(unique, optional, string, default "/run/resource-agents/storage-mon-RESOURCE\_ID.state")

**drives**

The drive(s) to check as a SPACE separated list. Enter the full path to the device, e.g. "/dev/sda".

(unique, required, string, no default)

**io\_timeout**

Specify disk I/O timeout in seconds. Minimum 1, recommended 10 (default).

(optional, integer, default 10)

**check\_interval**

Specify interval between I/O checks in seconds.(Only supported with the damonize option.)

(optional, integer, default 30)

**inject\_errors**

Used only for testing! Specify % of I/O errors to simulate drives failures.

(optional, integer, no default)

**daemonize**

Specifies to start storage-mon as a daemon and check for devices.

(optional, boolean, default false)

## SUPPORTED ACTIONS

This resource agent supports the following actions (operations):

**start**

Starts the resource. Suggested minimum timeout: 10s.

**stop**

Stops the resource. Suggested minimum timeout: 120s.

**monitor**

Performs a detailed status check. Suggested minimum timeout: 120s. Suggested interval: 30s.

**meta-data**

Retrieves resource agent metadata (internal use only). Suggested minimum timeout: 5s.

**validate-all**

Performs a validation of the resource configuration. Suggested minimum timeout: 10s.

## EXAMPLE CRM SHELL

The following is an example configuration for a storage-mon resource using the [**crm**(8)](/crm/8.md) shell:

```
primitive p_storage-mon ocf:heartbeat:storage-mon \
  params \
    drives=string \
  op monitor timeout="120s" interval="30s" start-delay="0s"
```

## EXAMPLE PCS

The following is an example configuration for a storage-mon resource using [**pcs**(8)](/pcs/8.md)

```
pcs resource create p_storage-mon ocf:heartbeat:storage-mon \
  drives=string \
  op monitor timeout="120s" interval="30s" start-delay="0s"
```

## SEE ALSO

**http://clusterlabs.org/**

## AUTHOR

**ClusterLabs contributors (see the resource agent source for information about individual authors)**