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

DIAGNOSTICS

55       All  are  generated  on  standard  error  and  are intended to be self-
56       explanatory.
57

PCP ENVIRONMENT

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

SEE ALSO

66       PCPIntro(1), pmdumplog(1), pmlogcheck(1) and pmlogger(1).
67
68
69
70Performance Co-Pilot                  PCP                         PMLOGSIZE(1)
Impressum