From owner-svn-doc-projects@FreeBSD.ORG Tue Oct 1 20:34:47 2013 Return-Path: Delivered-To: svn-doc-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id E8C6578; Tue, 1 Oct 2013 20:34:47 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id C6AD6285A; Tue, 1 Oct 2013 20:34:47 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r91KYlvm017137; Tue, 1 Oct 2013 20:34:47 GMT (envelope-from bcr@svn.freebsd.org) Received: (from bcr@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r91KYluV017135; Tue, 1 Oct 2013 20:34:47 GMT (envelope-from bcr@svn.freebsd.org) Message-Id: <201310012034.r91KYluV017135@svn.freebsd.org> From: Benedict Reuschling Date: Tue, 1 Oct 2013 20:34:47 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-projects@freebsd.org Subject: svn commit: r42795 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs X-SVN-Group: doc-projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-projects@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for doc projects trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Oct 2013 20:34:48 -0000 Author: bcr Date: Tue Oct 1 20:34:47 2013 New Revision: 42795 URL: http://svnweb.freebsd.org/changeset/doc/42795 Log: Add a section about zpool iostat with a few examples. Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Modified: projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml ============================================================================== --- projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 19:30:26 2013 (r42794) +++ projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs/chapter.xml Tue Oct 1 20:34:47 2013 (r42795) @@ -506,8 +506,51 @@ errors: No known data errors Performance Monitoring - - + ZFS has a built-in monitoring isystem that can display + statistics about I/O happening on the pool in real-time. + Additionally, it shows the free and used space on the pool and + how much I/O bandwidth are currently utilized for read and + write operations. By default, all pools in the system will be + monitored and displayed. A pool name can be provided to just + monitor one pool. A basic example is provided below: + +&prompt.root; zpool iostat + capacity operations bandwidth +pool alloc free read write read write +---------- ----- ----- ----- ----- ----- ----- +data 288G 1.53T 2 11 11.3K 57.1K + + To monitor I/O activity on the pool continuously, a + number indicating the seconds after which to refresh the + display can be specified. ZFS will then print the next + statistic line after each intervall has been reached. Press + CtrlC + to stop this continuous monitoring. Alternatively, a second + whole number can be provided on the command line after the + intervall to indicate how many of these statistics should be + displayed in total. + + An even more detailed pool I/O statistic can be + displayed using the -v parameter. For + each storage device that is part of the pool ZFS will + provide a separate statistic line. This is helpful to + determine reads and writes on devices that slow down I/O on + the whole pool. In the following example, we have a + mirrored pool consisting of two devices. For each of these, + a separate line is shown with the current I/O + activity. + +&prompt.root; zpool iostat -v + capacity operations bandwidth +pool alloc free read write read write +----------------------- ----- ----- ----- ----- ----- ----- +data 288G 1.53T 2 12 9.23K 61.5K + mirror 288G 1.53T 2 12 9.23K 61.5K + ada1 - - 0 4 5.61K 61.7K + ada2 - - 1 4 5.04K 61.7K +----------------------- ----- ----- ----- ----- ----- ----- + Splitting a Storage Pool @@ -533,12 +576,12 @@ errors: No known data errors A volume can be formatted with any filesystem on top of - it. This will appear to the user as if they are working with - that specific filesystem and not ZFS. This way, it can be - used to augment non-ZFS filesystems with ZFS features that - they do not have. For example, combining the ZFS compression - property together with a 250 MB volume allows to create a - compressed FAT filesystem. + it. This will appear to the user as if they are working with + that specific filesystem and not ZFS. This way, it can be + used to augment non-ZFS filesystems with ZFS features that + they do not have. For example, combining the ZFS compression + property together with a 250 MB volume allows to create a + compressed FAT filesystem. &prompt.root; zfs create -V 250m -o compression=on tank/fat32 &prompt.root; zfs list tank @@ -564,12 +607,12 @@ Filesystem Size Used Avail Cap - It is possible to set user-defined properties in ZFS. They - become part of the pool configuration and can be used to provide - additional information about the pool or it's contents. To - distnguish these custom properties from the ones supplied by - ZFS by default, the colon (:) is used in the - property name. + It is possible to set user-defined properties in ZFS. + They become part of the pool configuration and can be used to + provide additional information about the pool or it's + contents. To distnguish these custom properties from the ones + supplied by ZFS by default, the colon (:) + is used in the property name. &prompt.root; zfs set custom:costcenter=1234 &prompt.root; zfs get custom:costcenter