diff options
author | Igor Pashev <pashev.igor@gmail.com> | 2014-10-26 12:33:50 +0400 |
---|---|---|
committer | Igor Pashev <pashev.igor@gmail.com> | 2014-10-26 12:33:50 +0400 |
commit | 47e6e7c84f008a53061e661f31ae96629bc694ef (patch) | |
tree | 648a07f3b5b9d67ce19b0fd72e8caa1175c98f1a /src/pmdas/process/README | |
download | pcp-debian.tar.gz |
Debian 3.9.10debian/3.9.10debian
Diffstat (limited to 'src/pmdas/process/README')
-rw-r--r-- | src/pmdas/process/README | 74 |
1 files changed, 74 insertions, 0 deletions
diff --git a/src/pmdas/process/README b/src/pmdas/process/README new file mode 100644 index 0000000..78579e8 --- /dev/null +++ b/src/pmdas/process/README @@ -0,0 +1,74 @@ +# +# Copyright (c) 2001 Alan Bailey (bailey@mcs.anl.gov or abailey@ncsa.uiuc.edu) +# for the portions of the code supporting the initial agent functionality. +# All rights reserved. +# +# Copyright (c) 2001,2004 Silicon Graphics, Inc. All Rights Reserved. +# + +Process PMDA +============ + +This PMDA monitors root processes to see if they are still running. +The processes that are monitored are stored in a config file, +and the PMDA returns the number of root processes with that name +running. In this way, you can check to see if the number of processes +is in a range, is 1, is 0, or some other combination. + +This source code was contributed by Alan Bailey (abailey@ncsa.uiuc.edu) +to the PCP open source project. + +Metrics +======= + +The file ./help contains descriptions for all of the metrics exported +by this PMDA. + +Once the PMDA has been installed, the following command will list all +the available metrics and their explanatory "help" text: + + $ pminfo -fT process + +Installation +============ + + + # cd $PCP_PMDAS_DIR/process + + + Check that there is no clash in the Performance Metrics Domain + defined in ./domain.h and the other PMDAs currently in use + ($PCP_PMCDCONF_PATH). If there is, edit ./domain.h + to choose another domain number. + + + Then simply use + + # ./Install + + and choose both the "collector" and "monitor" installation + configuration options -- everything else is automated. + + + Alternatively, to install just the Performance Metrics Name Space + for the process metrics on the local system, but not the process + PMDA (presumably because the local system is running PCP 1.x and + you wish to connect to a remote system where PCP 2.0 and the process + PMDA is running), make sure the Performance Metrics Domain defined + in ./domain.h matches the domain chosen for the process PMDA on the + remote system (check the second field in the corresponding line of the + $PCP_PMCDCONF_PATH file on the remote system), then + + # ./Install -N + +De-installation +=============== + + + Simply use + + # cd $PCP_PMDAS_DIR/process + # ./Remove + +Troubleshooting +=============== + + + After installing or restarting the agent, the PMCD log file + ($PCP_LOG_DIR/pmcd/pmcd.log) and the PMDA log file + ($PCP_LOG_DIR/pmcd/process.log) should be checked for any warnings or + errors. |