zpool-events

Show pool events

$ zpool events

$ zpool events -v

$ zpool events [poolname]

$ zpool events -f

$ zpool events -c

$ zpool events -vf

zpool events [options] [pool]

zpool events displays the internal event log maintained by ZFS since the kernel module was loaded. Events include errors, pool state changes, scrub operations, and device status updates.
The event log is stored in RAM with a configurable maximum size. Events are invaluable for diagnosing hardware problems, tracking pool operations, and understanding ZFS behavior.
The ZFS Event Daemon (zed) monitors these events in real-time and can trigger scripts for notifications or automated responses to events.

-v

Verbose output with full event payloads.

Follow mode; wait for new events.

Clear event log after displaying.

Scripted mode; no headers, tab-separated.

ereport.fs.zfs.checksum: Checksum error detected.
ereport.fs.zfs.io: I/O error on vdev.
ereport.fs.zfs.delay: Slow I/O completion.
sysevent.fs.zfs.pool_import: Pool imported.
sysevent.fs.zfs.pool_export: Pool exported.
sysevent.fs.zfs.scrub_start: Scrub started.
sysevent.fs.zfs.resilver_finish: Resilver completed.

Events stored in RAM; lost on reboot or module unload. Log size limited by zfseventlen_max parameter. Use zed for persistent event handling and alerting.

The ZFS event system provides visibility into pool operations and errors that traditional filesystems lack. It enables proactive monitoring and automated responses through the zed daemon, making ZFS self-healing capabilities more accessible.

zpool-status(8), zpool(8), zed(8), zfs(8)