# ndctl−monitor(1)

[NAME](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[SYNOPSIS](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[DESCRIPTION](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[EXAMPLES](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[OPTIONS](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[COPYRIGHT](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)\
[SEE ALSO](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/broken-reference)

## NAME

ndctl−monitor − Monitor the smart events of nvdimm objects

## SYNOPSIS

*ndctl monitor* \[\<options>]

## DESCRIPTION

`ndctl monitor` is used for monitoring the smart events of nvdimm objects and dumping the json format notifications to syslog, standard output or a logfile.

The objects to monitor and smart events to notify can be selected by setting options and/or the configuration file at `/etc/ndctl/monitor.conf`.

Both, the values in configuration file and in options will work. If there is a conflict, the values in options will override the values in the configuration file. Any updated values in the configuration file will take effect only after the monitor process is restarted.

## EXAMPLES

Run a monitor as a daemon to monitor DIMMs on bus "nfit\_test.1"

```
ndctl monitor −−bus=nfit_test.1 −−daemon
```

Run a monitor as a one−shot command and output the notifications to `/var/log/ndctl.log`

```
ndctl monitor −−log=/var/log/ndctl.log
```

Run a monitor daemon as a system service

```
systemctl start ndctl−monitor.service
```

## OPTIONS

−b, −−bus=

Enforce that the operation only be carried on devices that are attached to the given bus. Where *bus* can be a provider name or a bus id number.

−d, −−dimm=

A *nmemX* device name, or dimm id number. Select the devices to monitor reference the given dimm.

−r, −−region=

A *regionX* device name, or a region id number. The keyword `all` can be specified to carry out the operation on every region in the system, optionally filtered by bus id (see `−−bus=` option).

−n, −−namespace=

A *namespaceX.Y* device name, or namespace region plus id tuple *X.Y*.

−l, −−log=

Send log messages to the specified destination.

* "\<file>": Send log messages to specified . When fopen() is not able to open , log messages will be forwarded to syslog.
* "syslog": Send messages to syslog.
* "standard": Send messages to standard output.

The default log destination is syslog if "−−daemon" is specified, otherwise *standard*. Note that standard and relative path for  will not work if "−−daemon" is specified.

−c, −−config−file=

Provide the config file to use. This overrides the default config typically found in /etc/ndctl

−−daemon

Run a monitor as a daemon.

−D, −−dimm−event=

Name of an smart health event from the following:

* "dimm−spares−remaining": Spare Blocks Remaining value has gone below the pre−programmed threshold.
* "dimm−media−temperature": NVDIMM Media temperature value has gone above the pre−programmed threshold.
* "dimm−controller−temperature": NVDIMM Controller temperature value has gone above the pre−programmed threshold.
* "dimm−health−state": NVDIMM Normal Health Status has changed
* "dimm−unclean−shutdown": NVDIMM Last Shutdown Status was a unclean shutdown.

The monitor will attempt to enable the alarm control bits for all specified events.

−u, −−human

Output monitor notification as human friendly json format instead of the default machine friendly json format.

−v, −−verbose

Emit extra debug messages to log.

## COPYRIGHT

Copyright (c) 2018, FUJITSU LIMITED. License GPLv2: GNU GPL version 2\
<http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

## SEE ALSO

[ndctl−list(1)](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/ndctl-list), [ndctl−inject−smart(1)](https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/ndctl-inject-smart)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pmem.io/ndctl-user-guide/v71/ndctl-man-pages/ndctl-monitor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.