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

NAME

6       pmlogsize - report sizes for parts of PCP archive(s)
7

SYNOPSIS

9       pmlogsize [-drv?]  [-x threshold] archive [...]
10

DESCRIPTION

12       pmlogsize  prints information about the size of the index, metadata and
13       data sections of a Performance Co-Pilot (PCP) archive.  The  output  is
14       intended  to  guide improvements in archive encoding format for PCP de‐
15       velopers and to help trim pmlogger(1)  configuration  files  to  remove
16       metrics  that are bloating the PCP archives with low-value data in pro‐
17       duction environments.
18
19       The archive arguments can be any mixture of the names of  the  physical
20       files of a PCP archive or the basename that is common to all the compo‐
21       nent physical files in a single archive.  In the latter case archive is
22       replaced by a list of all of the matching component file names.
23
24       Note  the  semantics  is  a little different to other PCP tools in that
25       foo.meta means just the file foo.meta, not foo.index, foo.meta,  foo.0,
26       etc.
27

OPTIONS

29       The available command line options are:
30
31       -d, --detail
32            Enable  detailed  reporting.  This means space per instance domain
33            in a metadata file and space per metric (for  values)  in  a  data
34            file.
35
36       -r, --replication
37            Display additional information about possible replicated values in
38            the data file and replicated instances in the metadata file.  This
39            option implies -d.
40
41       -x threshold, --threshold=threshold
42            With  -d (or -r), cut off the report after at least threshold per‐
43            cent of the associated space (metric values or  instance  domains)
44            has been reported.  The default behaviour is equivalent to thresh‐
45            old being set to 100.
46
47       -v, --verbose
48            Enable verbose mode.  This option can be provided more  than  once
49            for additional verbosity.
50
51       -?, --help
52            Display usage message and exit.
53

PCP ENVIRONMENT

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

SEE ALSO

62       PCPIntro(1), pmdumplog(1), pmlogcheck(1) and pmlogger(1).
63
64
65
66Performance Co-Pilot                  PCP                         PMLOGSIZE(1)
Impressum