docs: describe the pmdaroot process interfaces
[pcp.git] / src / pmlogger / control
blob97b0295c06d6616b0cf00a34a8262c21717626d9
2 # PCP archive logging configuration/control
4 # This file is used by various of the PCP archive logging administrative
5 # tools to perform maintenance on the pmlogger instances running on
6 # the local host.
8 # This file contains one line per host to be logged, fields are
9 #    Host       name of host to be logged
10 #    P(rimary)  is this the primary logger? y or n
11 #    S(ocks)    should this logger be launched with pmsocks? y or n
12 #    Directory  full pathname to directory where archive logs are
13 #               to be maintained ... note all scripts "cd" to here as
14 #               a first step
15 #    Args       optional additional arguments to pmlogger and/or pmnewlog
17 # All files below "${PCP_PMLOGGERCONTROL_PATH}.d" are appended to this
18 # file before evaluation, if any exist.
21 # === VARIABLE ASSIGNMENTS ===
23 # DO NOT REMOVE OR EDIT THE FOLLOWING LINE
24 $version=1.1
26 # if pmsocks is being used, edit the IP address for $SOCKS_SERVER
27 #$SOCKS_SERVER=123.456.789.123
29 # for remote loggers running over a WAN with potentially long delays
30 $PMCD_CONNECT_TIMEOUT=150
31 $PMCD_REQUEST_TIMEOUT=120
33 # === LOGGER CONTROL SPECIFICATIONS ===
35 #Host           P?  S?  directory                               args
38 # Note: - LOCALHOSTNAME will be expanded to local: in the first column,
39 #         and to `hostname` in the fourth (directory) column
40 #       - Default local primary logger specification is nowadays setup
41 #         via ${PCP_PMLOGGERCONTROL_PATH}.d/local
42 #       - If multiple pmloggers for the same host (e.g. both primary and
43 #         non-primary loggers are active), then they MUST use different
44 #         directories
47 # local non-primary logger
48 #LOCALHOSTNAME  n   n   PCP_LOG_DIR/pmlogger/mysummary          -r -T24h10m -c config.Summary
50 # remote host
51 #remote         n   n   PCP_LOG_DIR/pmlogger/remote             -r -T24h10m -c config.remote
53 # thru the firewall via socks
54 #distant        n   y   PCP_LOG_DIR/pmlogger/distant            -r -T24h10m -c config.distant