crm_mon - Man Page

Part of the Pacemaker cluster resource manager


crm_mon [options]


Provides a summary of cluster's current state.

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


Help Options

-?,  --help

Show help options


Show all help options


Show output help


Show display options


Show additional options


Show deprecated options

Output Options


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


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


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


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


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


Use more highly formatted output (requires --output-as=text)

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.


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


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 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

-h,  --as-html=FILE

Write cluster status to the named HTML file. Use --output-as=html --output-to=FILE instead.

-X,  --as-xml

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

-s,  --simple-status

Display the cluster status once as a simple one line output (suitable for nagios)

-N,  --disable-ncurses

Disable the use of ncurses. Use --output-as=text instead.

-w,  --web-cgi

Web mode with output suitable for CGI (preselected when run as *.cgi). Use --output-as=html --html-cgi 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.


If this program is called as crm_mon.cgi, --output-as=html and --html-cgi are automatically added to the command line arguments.

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.


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


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


Written by Andrew Beekhof and the Pacemaker project contributors

Referenced By


January 2024 Pacemaker 2.1.7-4.fc40.2 System Administration Utilities