Provided by: pcp_4.3.1-1_amd64 bug

NAME

       pmie2col - convert pmie output to multi-column format

SYNOPSIS

       pmie2col [-d delimiter] [-p precision] [-w width]

DESCRIPTION

       pmie2col  is  a  simple tool that converts output from pmie(1) into regular column format.
       Each column is 7 characters wide (by default, may be changed with the -w  option)  with  a
       single  space  between  columns.   That  single space can be substituted with an alternate
       delimiter using the -d option (this is useful for importing the data into  a  spreadsheet,
       for example).

       The  precision  of  the  tabulated  values  from  pmie can be specified with the -p option
       (default is 2 decimal places).  This option can and will override  any  width  setting  in
       order to present the requested precision.

       The pmie(1) configuration must follow these rules:

       (1)    Each  pmie(1) expression is of the form ``NAME = expr;''.  NAME will be used as the
              column heading, and must contain no white space, although special characters can be
              escaped by enclosing NAME in single quotes.

       (2)    The ``expr'' must be a valid pmie(1) expression that produces a singular value.

       In addition, pmie(1) must be run with the -v command line option.

       It  is  also  possible  to  use  the  -e  command line to pmie(1) and output lines will be
       prefixed by a timestamp.

EXAMPLE

       Given this pmie(1) configuration file (config):

            loadav = kernel.all.load #'1 minute';
            '%usr' = kernel.all.cpu.user;
            '%sys' = kernel.all.cpu.sys;
            '%wio' = kernel.all.cpu.wait.total;
            '%idle' = kernel.all.cpu.idle;
            'max-iops' = max_inst(disk.dev.total);

       Then this command pipeline:

            $ pmie -v -t 5 <config | pmie2col -w 8

       Produces output like this:

               loadav     %usr     %sys     %wio    %idle max-iops
                 0.21        ?        ?        ?        ?        ?
                 0.36     0.49     0.03     0.18     0.29    25.40
                 0.49     0.41     0.10     0.36     0.13    51.00
                 0.69     0.49     0.10     0.05     0.37    43.20
                 0.71     0.39     0.08     0.04     0.49    14.00
                 0.83     0.63     0.15     0.00     0.21    32.30
                 1.09     0.60     0.02     0.10     0.27    47.00
                 0.92     0.01     0.00     0.00     0.99     2.40

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(5).

SEE ALSO

       PCPIntro(1) and pmie(1).