NAME

       dkvis - visualize disk I/O activity and performance

SYNOPSIS

       dkvis [-brVw] [-m maxrate] [-X ndisk] [-Y nctl] [pmview options] [diskid ...]

DESCRIPTION

       dkvis  displays  a  three dimensional bar chart of disk activity.  Each row of bars on the
       base plane represents a disk controller (or host adapter, or bus), and the bars  within  a
       row correspond to the disks attached to the controller.

       The label to the left of each row identifies the common part of disk name for all disks in
       that row, e.g. dks3 for all IRIX SCSI disks attached to controller number 3.

       The height of the bars is proportional to the activity.

       The user can specify a list of disks as diskid arguments  using  the  disk  naming  scheme
       reported by
          $ pminfo -f disk.dev.total
       e.g.     hda    or    dks0d4    or    sda    or    scsi/host1/bus0/target4/lun0/disc    or
       20000080e5114459/lun3/c2p1 depending on the type of disks.  Alternatively, if  the  diskid
       argument  contains  one  of  the  characters ^ or .  or [ then diskid will be treated as a
       regular expression in the style of egrep(1) and the matching set of  disk  names  will  be
       used instead of diskid.

       If one or more diskid arguments is specified, only the disks in this list are displayed in
       the view.  The disks are grouped in the scene by controller as in the default  scene  when
       all disks are present.

       dkvis  generates  a  pmview(1) configuration file, and passes most command line options to
       pmview(1).  Therefore, the command line options -A, -a, -C, -h, -n, -O, -p, -S, -t, -T, -Z
       and -z, and the user interface are described in the pmview(1) man page.

COMMAND LINE OPTIONS

       The dkvis specific options are:

       -b     Report the activity as data throughput in Kbytes per second rather than the default
              I/O operations per second (IOPS).

       -m     Use maxrate  as  the  maximum  activity  from  which  utilization  percentages  are
              computed.  This effectively specifies the height at which bars will be clipped.  If
              -b is specified the default maximum value is 2048 Kbytes per second, otherwise  the
              default maximum value is 150 IOPS.

       -r     Display  the  read  activity.  The default is to display the total (read and write)
              activity.

       -V     Verbose mode - output the generated pmview(1) configuration file.

       -w     Display the write activity.  The default is to display the total (read  and  write)
              activity.

       -X     The  default  arrangement attempts to display up to 12 disks on the same controller
              in a single row.  When more  than  12  disks  are  associated  with  a  controller,
              additional  rows are created in an attempt to achieve a baseplane footprint for the
              scene that is as close to square as we can manage.

              The -X option may be used to over-ride the default layout  algorithm  and  force  a
              scene in which each row contains no more than ndisk disks.

       -Y     The default arrangement attempts to display disks for up to 16 controller rows in a
              single block.  When more than 16 controller rows are present, additional blocks are
              created  in  an  attempt  to achieve a baseplane footprint for the scene that is as
              close to square as we can manage.

              The -Y option may be used to over-ride the default layout  algorithm  and  force  a
              scene  in  which  blocks  are  assigned  such  that each contains no more than nctl
              controller rows.

              For backwards compatibility -R is a deprecated synonym for -Y .

       Only one type of activity can be displayed per invocation of dkvis, hence -r  and  -w  are
       mutually exclusive.

LAUNCH

       The behavior of pmchart(1) when launched from dkvis is dependent on the number of disks in
       each row.  If there are more than 6 controllers then a separate chart  will  be  generated
       for  each  column  of  disks.   In other words, the first disk from each controller in one
       chart, the second disk in the next chart and so on.  Otherwise a separate  chart  will  be
       generated for each disk controller.

FILES

       $PCP_VAR_DIR/config/pmlogger/config.dkvis
                 A pmlogger(1) configuration file for dkvis metrics.
       $PCP_SHARE_DIR/lib/pmview-args
                 Shell procedures for parsing pmview(1) command line options.

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory
       names used by PCP.  On each installation, the file /etc/pcp.conf contains the local values
       for  these  variables.   The  $PCP_CONF  variable  may  be  used to specify an alternative
       configuration file, as described in pcp.conf(4).

SEE ALSO

       dkstat(1),  mpvis(1),  nfsvis(1),  pmchart(1),  pmlogger(1),  pmview(1),  pcp.conf(4)  and
       pcp.env(4).

       The Disk and DiskCntrls views for pmchart(1).