перезаписать архивы Performance Co-Pilot (rewrite Performance Co-Pilot archives)
Параметры (Options)
The available command line options are:
-c config, --config=config
If config is a file or symbolic link, read and parse
rewriting rules from there. If config is a directory, then
all of the files or symbolic links in that directory
(excluding those beginning with a period ``.'') will be used
to provide the rewriting rules. Multiple -c options are
allowed.
-C, --check
Parse the rewriting rules and quit. outlog is not created.
When -C is specified, this also sets -v and -w so that all
warnings and verbose messages are displayed as config is
parsed.
-d, --desperate
Desperate mode. Normally if a fatal error occurs, all trace
of the partially written PCP archive outlog is removed.
With the -d option, the partially created outlog archive log
is not removed.
-i Rather than creating outlog, inlog is rewritten in place
when the -i option is used. A new archive is created using
temporary file names and then renamed to inlog in such a way
that if any errors (not warnings) are encountered, inlog
remains unaltered.
-q, --quick
Quick mode, where if there are no rewriting actions to be
performed (none of the global data, instance domains or
metrics from inlog will be changed), then pmlogrewrite will
exit (with status 0, so success) immediately after parsing
the configuration file(s) and outlog is not created.
-s, --scale
When the ``units'' of a metric are changed, if the dimension
in terms of space, time and count is unaltered, then the
scaling factor is being changed, e.g. BYTE to KBYTE, or
MSEC-1 to USEC-1, or the composite MBYTE.SEC-1 to
KBYTE.USEC-1. The motivation may be (a) that the original
metadata was wrong but the values in inlog are correct, or
(b) the metadata is changing so the values need to change as
well. The default pmlogrewrite behaviour matches case (a).
If case (b) applies, then use the -s option and the values
of all the metrics with a scale factor change in each result
will be rescaled. For finer control over value rescaling
refer to the RESCALE option for the UNITS clause of the
metric rewriting rule described below.
-v, --verbose
Enable verbose mode.
-w, --warnings
Emit warnings. Normally pmlogrewrite remains silent for any
warning that is not fatal and it is expected that for a
particular archive, some (or indeed, all) of the rewriting
specifications may not apply. For example, changes to a
PMDA may be captured in a set of rewriting rules, but a
single archive may not contain all of the modified metrics
nor all of the modified instance domains and/or instances.
Because these cases are expected, they do not prevent
pmlogrewrite executing, and rules that do not apply to inlog
are silently ignored by default. Similarly, some rewriting
rules may involve no change because the metadata in inlog
already matches the intent of the rewriting rule to correct
data from a previous version of a PMDA. The -w flag forces
warnings to be emitted for all of these cases.
-?, --help
Display usage message and exit.
The argument outlog is required in all cases, except when -i is
specified.
