ZFS-EVENTS(5)

NAME
zfs-events - Events created by the ZFS filesystem.

DESCRIPTION

Description of the different events generated by the ZFS stack.

Most of these don't have any description. The events generated by ZFS have never been publicly documented. What is here is intended as a starting point to provide documentation for all possible events.

To view all events created since the loading of the ZFS infrastructure (i.e, "the module"), run

zpool events

to get a short list, and

zpool events -v

to get a full detail of the events and what information is available about it.

This man page lists the different subclasses that are issued in the case of an event. The full event name would be ereport.fs.zfs.SUBCLASS, but we only list the last part here.

  EVENTS (SUBCLASS)

checksum

io
    Issued when there is an I/O error in a vdev in the pool.

data
    Issued when there have been data errors in the pool.

delay

config.sync
    Issued every time a vdev change have been done to the pool.

zpool

zpool.destroy
    Issued when a pool is destroyed.

zpool.export
    Issued when a pool is exported.

zpool.import
    Issued when a pool is imported.

zpool.reguid

vdev.unknown
    Issued when the vdev is unknown. Such as trying to clear device errors on a vdev that have failed/been kicked from the system/pool and is no longer available.

vdev.open_failed

vdev.corrupt_data

vdev.no_replicas
    Issued when there are no more replicas to sustain the pool. This would lead to the pool being DEGRADED.

vdev.bad_guid_sum

vdev.too_small
    Issued when the system (kernel) have removed a device, and ZFS notices that the device isn't there any more. This is usually followed by a probe_failure event.

vdev.bad_label

vdev.bad_ashift

vdev.remove
    Issued when a vdev is detached from a mirror (or a spare detached from a vdev where it have been used to replace a failed drive - only works if the original drive have been readded).

vdev.clear
    Issued when clearing device errors in a pool. Such as running zpool clear on a device in the pool.

vdev.check

vdev.spare
    Issued when a spare have kicked in to replace a failed device.

vdev.autoexpand

io_failure
    Issued when there is an I/O failure in a vdev in the pool.

probe_failure
    Issued when a probe fails on a vdev. This would occur if a vdeev have been kicked from the system outside of ZFS (such as the kernel have removed the device).

log_replay

resilver.start
    Issued when a resilver is started.

resilver.finish
    Issued when the running resilver have finished.

scrub.start
    Issued when a scrub is started on a pool.

scrub.finish
    Issued when a pool have finished scrubbing.

bootfs.vdev.attach

  PAYLOAD

This is the payload (data, information) that accompanies an event.

For zed(8), these are set to uppercase and prefixed with ZEVENT_.

pool
    Pool name.

pool_failmode
    Failmode - wait, continue or panic. See pool(8) (failmode property) for more information.

pool_guid
    The GUID of the pool.

pool_context

vdev_guid
    The GUID of the vdev in question (the vdev failing or operated upon with zpool clear etc).

vdev_type
    Type of vdev - disk, file, mirror etc. See zpool(8) under Virtual Devices for more information on possible values.

vdev_path
    Full path of the vdev, including any -partX.

vdev_devid

vdev_fru

vdev_state

vdev_ashift
    The ashift value of the vdev.

vdev_complete_ts

vdev_delta_ts

vdev_spare_paths
    List of spares, including full path and any -partX.

vdev_spare_guids
    GUID(s) of spares.

vdev_read_errors
    How many read errors that have been detected on the vdev.

vdev_write_errors
    How many write errors that have been detected on the vdev.

vdev_cksum_errors
    How many checkum errors that have been detected on the vdev.

parent_guid
    GUID of the vdev parent.

parent_type
    Type of parent. See vdev_type.

parent_path

parent_devid

zio_objset

zio_object

zio_level

zio_blkid

zio_err

zio_offset

zio_size

zio_flags

zio_stage

zio_pipeline

zio_delay

zio_timestamp

zio_deadline

zio_delta

prev_state

cksum_expected

cksum_actual

cksum_algorithm

cksum_byteswap

bad_ranges

bad_ranges_min_gap

bad_range_sets

bad_range_clears

bad_set_bits

bad_cleared_bits

bad_set_histogram

bad_cleared_histogram