1PMIE2COL(1)                 General Commands Manual                PMIE2COL(1)
2
3
4

NAME

6       pmie2col - convert pmie output to multi-column format
7

SYNOPSIS

9       pmie2col [-?]  [-d delimiter] [-p precision] [-w width]
10

DESCRIPTION

12       pmie2col  is a simple tool that converts output from pmie(1) into regu‐
13       lar column format.  Each column is 7 characters wide (by  default,  may
14       be  changed  with  the  -w option) with a single space between columns.
15       That single space can be substituted with an alternate delimiter  using
16       the  -d  option  (this  is useful for importing the data into a spread‐
17       sheet, for example).
18
19       The precision of the tabulated values from pmie can be  specified  with
20       the  -p option (default is 2 decimal places).  This option can and will
21       override any width setting in order to present the requested precision.
22
23       The pmie(1) configuration must follow these rules:
24
25       (1)    Each pmie(1) expression is of the form ``NAME =  expr;''.   NAME
26              will  be  used  as the column heading, and must contain no white
27              space, although special characters can be escaped  by  enclosing
28              NAME in single quotes.
29
30       (2)    The  ``expr'' must be a valid pmie(1) expression that produces a
31              singular value.
32
33       In addition, pmie(1) must be run with the -v command line option.
34
35       It is also possible to use the -e command line to  pmie(1)  and  output
36       lines will be prefixed by a timestamp.
37

OPTIONS

39       The available command line options are:
40
41       -d char, --delimiter=char
42            Use char as output delimiter.
43
44       -p N, --precision=N
45            Use n as output floating point precision.
46
47       -w N, --width=N
48            Use n as output column width.
49
50       -?, --help
51            Display usage message and exit.
52

EXAMPLES

54       Given this pmie(1) configuration file (config):
55
56            loadav = kernel.all.load #'1 minute';
57            '%usr' = kernel.all.cpu.user;
58            '%sys' = kernel.all.cpu.sys;
59            '%wio' = kernel.all.cpu.wait.total;
60            '%idle' = kernel.all.cpu.idle;
61            'max-iops' = max_inst(disk.dev.total);
62
63       Then this command pipeline:
64
65            $ pmie -v -t 5 <config | pmie2col -w 8
66
67       Produces output like this:
68
69               loadav     %usr     %sys     %wio    %idle max-iops
70                 0.21        ?        ?        ?        ?        ?
71                 0.36     0.49     0.03     0.18     0.29    25.40
72                 0.49     0.41     0.10     0.36     0.13    51.00
73                 0.69     0.49     0.10     0.05     0.37    43.20
74                 0.71     0.39     0.08     0.04     0.49    14.00
75                 0.83     0.63     0.15     0.00     0.21    32.30
76                 1.09     0.60     0.02     0.10     0.27    47.00
77                 0.92     0.01     0.00     0.00     0.99     2.40
78
79

PCP ENVIRONMENT

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

SEE ALSO

88       PCPIntro(1) and pmie(1).
89
90
91
92Performance Co-Pilot                  PCP                          PMIE2COL(1)
Impressum