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

NAME

6       pmlogpaste - paste text into a metric in a PCP archive
7

SYNOPSIS

9       pmlogpaste  [-?]   [-f  file]  [-h hostname] [-l label] [-m metric] [-o
10       outfile] [-t timezone]
11

DESCRIPTION

13       pmlogpaste takes input text from a file or the command line, and writes
14       it as a metric value in a new PCP archive.  This metric value is times‐
15       tamped with the current time, and is stored as a string type metric.
16
17       The main purpose of this tool is to take captured output  and  preserve
18       this  in  a  PCP  archive.   This  allows, for example, the output of a
19       benchmark run to be stored along with performance metrics captured dur‐
20       ing  that  run,  in a single archive.  Archives can be merged using the
21       pmlogextract(1) utility.
22
23       pmlogpaste uses the LOGIMPORT(3) library interfaces  internally,  which
24       support  the  creation of archives from external sources of performance
25       data.
26

OPTIONS

28       The available command line options are:
29
30       -f file, --file=file
31            File with input text to be archived, or ``-'' for standard input.
32
33       -h hostname, --hostname=hostname
34            Source host name for the archive.  The default value is the  local
35            host name, or ``localhost'' if that cannot be obtained.
36
37       -l label, --label=label
38            Add  context  labels to the generated archive.  This option can be
39            presented multiple times to produce multiple  labels  in  the  ar‐
40            chive.  The label should be in the form name:value.
41
42       -m metric, --metric=metric
43            Metric   name  for  the  archive.   The  default  metric  name  is
44            paste.value.
45
46       -o outfile, --outfile=outfile
47            Archive output file.  The default archive name is paste.
48
49       -t timezone, --timezone=timezone
50            Source timezone for the archive archive.  The default value is the
51            local timezone.
52
53       -?, --help
54            Display usage message and exit.
55

PCP ENVIRONMENT

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

SEE ALSO

64       PCPIntro(1), pmcd(1), pmlogextract(1) and LOGIMPORT(3).
65
66
67
68Performance Co-Pilot                  PCP                        PMLOGPASTE(1)
Impressum