---
name: "crm_mon"
section: "8"
platform: "linux"
package: "pacemaker-cli-utils"
version: "3.0.0-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/crm_mon"
---

# crm\_mon(8)

Part of the Pacemaker cluster resource manager

## NAME

Pacemaker - Part of the Pacemaker cluster resource manager

## SYNOPSIS

crm\_mon \[options\]

## DESCRIPTION

Provides a summary of cluster's current state.

Outputs varying levels of detail in a number of different formats.

## OPTIONS

### Help Options:

- **-h**, **--help**

  Show help options

- **--help-all**

  Show all help options

- **--help-output**

  Show output help

- **--help-display**

  Show display options

- **--help-additional**

  Show additional options

- **--help-deprecated**

  Show deprecated options

### Output Options:

- **--output-as**=*FORMAT*

  Specify output format as one of: console (default), html, text, xml, none

- **--output-to**=*DEST*

  Specify file name for output (or "-" for stdout)

- **--html-cgi**

  Add CGI headers (requires **--output-as**=*html*)

- **--html-stylesheet**=*URI*

  Link to an external stylesheet (requires **--output-as**=*html*)

- **--html-title**=*TITLE*

  Specify a page title (requires **--output-as**=*html*)

### Display Options:

- **-I**, **--include**=*SECTION*(s)

  A list of sections to include in the output. See \`Output Control\` help for more information.

- **-U**, **--exclude**=*SECTION*(s)

  A list of sections to exclude from the output. See \`Output Control\` help for more information.

- **--node**=*NODE*

  When displaying information about nodes, show only what's related to the given node, or to all nodes tagged with the given tag

- **--resource**=*RSC*

  When displaying information about resources, show only what's related to the given resource, or to all resources tagged with the given tag

- **-n**, **--group-by-node**

  Group resources by node

- **-r**, **--inactive**

  Display inactive resources

- **-f**, **--failcounts**

  Display resource fail counts

- **-o**, **--operations**

  Display resource operation history

- **-t**, **--timing-details**

  Display resource operation history with timing details

- **-c**, **--tickets**

  Display cluster tickets

- **-m**, **--fence-history**=*LEVEL*

  Show fence history: 0=off, 1=failures and pending (default without option), 2=add successes (default without value for option), 3=show full history without reduction to most recent of each flavor

- **-L**, **--neg-locations**

  Display negative location constraints \[optionally filtered by id prefix\]

- **-A**, **--show-node-attributes**

  Display node attributes

- **-D**, **--hide-headers**

  Hide all headers

- **-R**, **--show-detail**

  Show more details (node IDs, individual clone instances)

- **--show-description**

  Show resource descriptions

- **-b**, **--brief**

  Brief output

### Additional Options:

- **-i**, **--interval**=*TIMESPEC*

  Update frequency (default is 5 seconds)

- **-1**, **--one-shot**

  Display the cluster status once and exit

- **-d**, **--daemonize**

  Run in the background as a daemon. Requires at least one of **--output-to** and **--external-agent**.

- **-p**, **--pid-file**=*FILE*

  (Advanced) Daemon pid file location

- **-E**, **--external-agent**=*FILE*

  A program to run when resource operations take place

- **-e**, **--external-recipient**=*RCPT*

  A recipient for your program (assuming you want the program to send something to someone).

- **-W**, **--watch-fencing**

  Listen for fencing events. For use with **--external-agent**.

### Deprecated Options:

- **-X**, **--as-xml**

  Write cluster status as XML to stdout. This will enable one-shot mode. Use **--output-as**=*xml* instead.

### Application Options:

- \-$, **--version**

  Display software version and exit

- **-V**, **--verbose**

  Increase debug output (may be specified multiple times)

- **-Q**, **--quiet**

  Be less descriptive in output.

## NOTES

Time Specification:

The TIMESPEC in any command line option can be specified in many different formats. It can be an integer number of seconds, a number plus units (us/usec/ms/msec/s/sec/m/min/h/hr), or an ISO 8601 period specification.

## OUTPUT CONTROL

By default, a particular set of sections are written to the output destination. The default varies based on the output format: XML includes all sections by default, while other output formats include less. This set can be modified with the **--include** and **--exclude** command line options. Each option may be passed multiple times, and each can specify a comma-separated list of sections. The options are applied to the default set, in order from left to right as they are passed on the command line. For a list of valid sections, pass **--include**=*list* or **--exclude**=*list*.

## INTERACTIVE USE

When run interactively, crm\_mon can be told to hide and show various sections of output. To see a help screen explaining the options, press '?'. Any key stroke aside from those listed will cause the screen to refresh.

## EXAMPLES

Display the cluster status on the console with updates as they occur:

-

  crm\_mon

Display the cluster status once and exit:

-

  crm\_mon -1

Display the cluster status, group resources by node, and include inactive resources in the list:

-

  crm\_mon --group-by-node --inactive

Start crm\_mon as a background daemon and have it write the cluster status to an HTML file:

-

  crm\_mon --daemonize --output-as html --output-to /path/to/docroot/filename.html

Display the cluster status as XML:

-

  crm\_mon --output-as xml

## AUTHOR

Written by Andrew Beekhof and the Pacemaker project contributors