bionic (1) pmlogsize.1.gz

Provided by: pcp_4.0.1-1_amd64 bug

NAME

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

SYNOPSIS

       pmlogsize [-drv] [-x thres] archive ...

DESCRIPTION

       pmlogsize prints information about the size of the index, metadata and data sections of a Performance Co-
       Pilot (PCP) archive.  The output is intended to guide improvements in archive  encoding  format  for  PCP
       developers  and  to help trim pmlogger(1) configuration files to remove metrics that are bloating the PCP
       archives with low-value data in production environments.

       The archive arguments can be any mixture of the names of the physical files  of  a  PCP  archive  or  the
       basename  that  is  common  to  all the component physical files in a single archive.  In the latter case
       archive is replaced by a list of all of the matching component file names.

       Note the semantics is a little different to other  PCP  tools  in  that  foo.meta  means  just  the  file
       foo.meta, not foo.index, foo.meta, foo.0, etc.

       The  -d  flag  requests more detailed reporting.  This means space per instance domain in a metadata file
       and space per metric (for values) in a data file.

       The -r flag requests additional information about  possible  replicated  values  in  the  data  file  and
       replicated instances in the metadata file.  It implies -d.

       When the -d (or -r) flag is specified, the -x flag may be used to cut off the report after at least thres
       percent of the associated space (metric values or instance  domains)  has  been  reported.   The  default
       behaviour is equivalent to thres being set to 100.

       Additional verbosity can be enabled with one or more -v flags.

SEE ALSO

       PCPIntro(1), pmdumplog(1), pmlogcheck(1) and pmlogger(1).

DIAGNOSTICS

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