1PMLOGGER_DAILY_REPORT(1) General Commands Manual PMLOGGER_DAILY_REPORT(1)
2
3
4
6 pmlogger_daily_report - write Performance Co-Pilot daily summary
7 reports
8
10 $PCP_BINADM_DIR/pmlogger_daily_report [-a archivefile] [-f outputfile]
11 [-h hostname] [-l logfile] [-o directory] [-t interval] [-A] [-V]
12 [--help]
13
15 pmlogger_daily_report and the associated crontab(5) entry (depending on
16 local platform, either $PCP_ETC_DIR/cron.d/pcp-pmlogger-daily-report or
17 $PCP_SYSCONF_DIR/pmlogger/crontab-daily-report) write daily performance
18 summary reports, much like those produced by sadc(1) and the sa2(8)
19 utility.
20
21 All of the command line arguments are optional and intended to be self
22 explanatory. If no arguments are specified, pmlogger_daily_report will
23 be run by cron(8) at 2am each morning and write a performance summary
24 report named sarXX (where XX is yesterdays day-of-the-month, wrapping
25 to the previous month if today is the 1st). The outputfile may be
26 changed with the -f option. The report will be written to the
27 $PCP_LOG_DIR/sa directory by default, but this may be changed with the
28 -o option to a different directory. Note the default crontab(5) entry
29 currently specifies $PCP_LOG_DIR/sa as the output directory; this may
30 be changed in the future.
31
32 If the -a option is not given, the default input archivefile is
33 $PCP_LOG_DIR/pmlogger/HOSTNAME/YYYYMMDD, where HOSTNAME defaults to the
34 local hostname (may be changed with the -h option) and YYYYMMDD is the
35 base name of yesterdays merged archive, as produced by pmlogger(1) and
36 the pmlogger_daily(1) scripts. If archivefile is a directory, then
37 pmlogger_daily_report will use all PCP archives found in that directory
38 to write the report (this is known as multi-archive mode, and may be
39 considerably slower than specifying a single archive as the input).
40
41 Note that there are suffciently flexible command line options for
42 pmlogger_daily_report to be used to read any archivefile and write the
43 report to any output directory. As such, this tool can be configured
44 by editing the crontab entry, $PCP_ETC_DIR/cron.d/pcp-pmlogger-daily-
45 report and adding whatever command line options are required.
46
47 The reports themselves are created by the pmrep(1) utility using its
48 default configuration file, see pmrep.conf(5). The pmrep(1) configura‐
49 tion entries used to write the reports is currently hardwired into the
50 pmlogger_daily_report script.
51
52 Finally, the input archives must contain sufficient metrics as needed
53 by pmrep(1) to write the report. On platforms that support it, the
54 pcp-zeroconf package configures PCP logging as required for this -
55 hence pmlogger_daily_report should be used with the pmlogger(1) config‐
56 uration that is set up by pcp-zeroconf. As the name suggests, pcp-
57 zeroconf requires no additional configuration after installation in
58 order to capture the required archives needed by pmlogger_daily_report.
59
60 In order to ensure that mail is not unintentionally sent when this
61 script is run from cron(8) diagnostics are always sent to a log file.
62 By default, this file is $PCP_LOG_DIR/pmlogger/pmlog‐
63 ger_daily_report.log but this can be changed using the -l option. If
64 this log file already exists when the script starts, it will be renamed
65 with a .prev suffix (overwriting any log file saved earlier) before
66 diagnostics are generated to the log file.
67
68 The output from the cron execution of the script may be extended using
69 the -V option which enables verbose tracing of activity. By default
70 the script generates no log output unless some error or warning condi‐
71 tion is encountered.
72
74 Environment variables with the prefix PCP_ are used to parameterize the
75 file and directory names used by PCP. On each installation, the file
76 /etc/pcp.conf contains the local values for these variables. The
77 $PCP_CONF variable may be used to specify an alternative configuration
78 file, as described in pcp.conf(5).
79
81 PCPIntro(1), pmlogger_daily(1), pmlogger(1), pmrep(1), sadc(1),
82 crontab(5), sa2(8) and cron(8).
83
84
85
86Performance Co-Pilot PCP PMLOGGER_DAILY_REPORT(1)