1PMDARSYSLOG(1) General Commands Manual PMDARSYSLOG(1)
2
3
4
6 pmdarsyslog - rsyslog (reliable and extended syslog) PMDA
7
9 pmdarsyslog is a Performance Metrics Domain Agent (PMDA) which exports
10 metric values from the rsyslogd(8) server.
11
12 Further details about rsyslog can be found at http://www.rsyslog.com/.
13
15 If you want access to the names and values for the rsyslog performance
16 metrics, do the following as root:
17
18 # cd $PCP_PMDAS_DIR/rsyslog
19 # ./Install
20
21 To uninstall, do the following as root:
22
23 # cd $PCP_PMDAS_DIR/rsyslog
24 # ./Remove
25
26 pmdarsyslog is launched by pmcd(1) and should never be executed
27 directly. The Install and Remove scripts notify pmcd(1) when the agent
28 is installed or removed.
29
30 In order to use this agent, rsyslog stats gathering must be enabled.
31 This is done by adding the lines:
32
33 $ModLoad impstats
34 $PStatsInterval 5 # log every 5 seconds
35 syslog.info |/var/log/pcp/rsyslog/stats
36
37 to your rsyslog.conf(5) configuration file after installing the PMDA.
38 Take care to ensure the syslog.info messages do not get logged in any
39 other file, as this could unexpectedly fill your filesystem. Syntax
40 useful for this is syslog.!=info for explicitly excluding these.
41
43 $PCP_LOG_DIR/rsyslog/stats
44 named pipe containing statistics exported from rsyslog, usually
45 created by the PMDA Install script.
46
47 $PCP_PMDAS_DIR/rsyslog/rsyslog.conf
48 optional configuration file for pmdarsyslog
49
50 $PCP_PMDAS_DIR/rsyslog/Install
51 installation script for the pmdarsyslog agent
52
53 $PCP_PMDAS_DIR/rsyslog/Remove
54 undo installation script for the pmdarsyslog agent
55
56 $PCP_LOG_DIR/pmcd/rsyslog.log
57 default log file for error messages from pmdarsyslog
58
60 Environment variables with the prefix PCP_ are used to parameterize the
61 file and directory names used by PCP. On each installation, the file
62 /etc/pcp.conf contains the local values for these variables. The
63 $PCP_CONF variable may be used to specify an alternative configuration
64 file, as described in pcp.conf(5).
65
67 PCPIntro(1), pmcd(1) and rsyslogd(1).
68
69
70
71Performance Co-Pilot PCP PMDARSYSLOG(1)