From f8bb2a7e0c889d6c5cf7655d698869b3a32c2bb0 Mon Sep 17 00:00:00 2001 From: kpande Date: Thu, 21 Feb 2019 14:00:48 -0800 Subject: [PATCH] Clarify zpool iostat statistics reporting Document expected behavior for zpool iostat statistics reporting. Reviewed by: Matt Ahrens Reviewed-by: Alek Pinchuk Reviewed-by: Brian Behlendorf Reviewed by: Allan Jude Signed-off-by: Kash Pande Closes #2888 Closes #8417 --- man/man8/zpool.8 | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/man/man8/zpool.8 b/man/man8/zpool.8 index 800ada566..6dbd6c556 100644 --- a/man/man8/zpool.8 +++ b/man/man8/zpool.8 @@ -1635,10 +1635,15 @@ with no flags on the relevant target devices. .Oo Oo Ar pool Ns ... Oc Ns | Ns Oo Ar pool vdev Ns ... Oc Ns | Ns Oo Ar vdev Ns ... Oc Oc .Op Ar interval Op Ar count .Xc -Displays I/O statistics for the given pools/vdevs. You can pass in a -list of pools, a pool and list of vdevs in that pool, or a list of any -vdevs from any pool. If no items are specified, statistics for every -pool in the system are shown. +Displays logical I/O statistics for the given pools/vdevs. Physical I/Os may +be observed via +.Xr iostat 1 . +If writes are located nearby, they may be merged into a single +larger operation. Additional I/O may be generated depending on the level of +vdev redundancy. +To filter output, you may pass in a list of pools, a pool and list of vdevs +in that pool, or a list of any vdevs from any pool. If no items are specified, +statistics for every pool in the system are shown. When given an .Ar interval , the statistics are printed every -- 2.39.2