NAME

       pmlogcheck - checks for invalid data in a PCP archive


SYNOPSIS

       pmlogcheck  [-lz] [-n pmnsfile] [-S start] [-T finish] [-Z
       timezone] archive


DESCRIPTION

       pmlogcheck prints information  about  the  nature  of  any
       invalid  data  which it detects in a PCP archive.  Of par­
       ticular interest are wrapped values for metrics which  are
       expected  to  have  monotonically  increasing values.  The
       archive has the base name archive and must have been  pre­
       viously created using pmlogger(1).

       Normally  pmlogcheck  operates  on the default Performance
       Metrics Namespace (PMNS(4)), however if the -n  option  is
       specified an alternative namespace is loaded from the file
       pmnsfile.

       The command line options -S and -T can be used to  specify
       a  time  window  over  which metrics should be summarized.
       These options are  common  to  many  Performance  Co-Pilot
       tools and are fully described in PCPIntro(1).

       The  -l  option  prints the archive label, showing the log
       format version, the time and date for the start and  (cur­
       rent) end of the archive, and the host from which the per­
       formance metrics values were collected.

       By default, pmlogcheck reports the time of  day  according
       to  the  local  timezone on the system where pmlogcheck is
       run.  The -Z option changes the timezone  to  timezone  in
       the  format of the environment variable TZ as described in
       environ(5).  The -z option changes  the  timezone  to  the
       local  timezone at the host that is the source of the per­
       formance metrics, as specified in the label record of  the
       archive log.


OUTPUT FORMAT

       For  each  metric  having  ``counter'' semantics (i.e. the
       metric is expected to increase  monotonically)  which  has
       been  detected  as  having  wrapped  at  some point in the
       archive, pmlogcheck produces output describing the  metric
       name  (with  instance  identifiers where appropriate), the
       internal storage type for the metric,  the  value  of  the
       metric before the counter wrap (with its associated times­
       tamp), and the value of the metric after  the  wrap  (also
       with a timestamp).

       pmlogcheck   produces  two  different  timestamp  formats,
       depending on the interval over which it is  run.   For  an

       addition to the time at which the counter  wrap  occurred.
       If  the  extent  of the data being checked is less than 24
       hours, a more precise format is used  (time  is  displayed
       with millisecond precision, but without the date).


FILES

       $PCP_VAR_DIR/pmns/*
                 default PMNS specification files
       $PCP_LOG_DIR/pmloggerhostname
                 default  directory  for  PCP archives containing
                 performance data collected from the  host  host­
                 name.


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


SEE ALSO

       PCPIntro(1), pmdumplog(1),  pmlogextract(1),  pmlogger(1),
       pmlogmerge(1),   pmlogsummary(1),  pmval(1),  pcp.conf(4),
       pcp.env(4) and PMNS(4).


DIAGNOSTICS

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


Man(1) output converted with man2html