svn commit: r42795 - projects/zfsupdate-201307/en_US.ISO8859-1/books/handbook/zfs

[Benjamin Kaduk]

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>
>