Date: Sun, 13 Oct 2013 21:12:35 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Benedict Reuschling <bcr@freebsd.org> Cc: svn-doc-projects@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r42795 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs Message-ID: <alpine.GSO.1.10.1310132058260.16692@multics.mit.edu> In-Reply-To: <201310012034.r91KYluV017135@svn.freebsd.org> References: <201310012034.r91KYluV017135@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 1 Oct 2013, Benedict Reuschling wrote: > 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 > ============================================================================== > --- 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</screen> > <sect2 id="zfs-zpool-iostat"> > <title>Performance Monitoring</title> > > - <para></para> > - </sect2> > + <para>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 I think "bandwidth" is singular and would take "is" accordingly. > + 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:</para> > + > +<screen>&prompt.root; <userinput>zpool iostat</userinput> > + capacity operations bandwidth > +pool alloc free read write read write > +---------- ----- ----- ----- ----- ----- ----- > +data 288G 1.53T 2 11 11.3K 57.1K</screen> > + > + <para>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 'interval' takes only a single 'l'. > + <keycombo > + action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo> > + 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 (here, too) > + displayed in total.</para> > + > + <para>An even more detailed pool I/O statistic can be I think the plural form ("Even more detailed pool I//O statistics") would flow more naturally here. > + displayed using the <literal>-v</literal> 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.</para> > + > @@ -564,12 +607,12 @@ Filesystem Size Used Avail Cap > > <para></para> > > - <para>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 (<literal>:</literal>) is used in the > - property name.</para> > + <para>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 Just "its" (no apostrophe). Oh, but this is fied already. -Ben > + contents. To distnguish these custom properties from the ones > + supplied by ZFS by default, the colon (<literal>:</literal>) > + is used in the property name.</para> > > <screen>&prompt.root; <userinput>zfs set custom:costcenter=1234</userinput> > &prompt.root; <userinput>zfs get custom:costcenter</userinput> >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1310132058260.16692>