Section 1: user commands and tools
NAME pmdatxmon – txmon performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/txmon/pmdatxmon [-d domain] [-l logfile] [-U username] tx_type … $PCP_PMDAS_DIR/txmon/txrecord [-l] $PCP_PMDAS_DIR/txmon/txrecord tx_type servtime [tx_type servtime … ] $PCP_PMDAS_DIR/txmon/genload DESCRIPTION pmdatxmon is an example Performance Metrics Domain Agent (PMDA) which exports a small number of performance metrics from a simulated transaction monitor. The txmon PMDA…
NAME pmdatrivial – trivial performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/trivial/pmdatrivial [-d domain] [-l logfile] [-U username] DESCRIPTION pmdatrivial is the simplest possible Performance Metrics Domain Agent (PMDA) which exports a single performance metric, the time in seconds since the 1st of January, 1970. The trivial PMDA is shipped as source code and is designed…
NAME pmdatrace – application-level transaction performance metrics domain agent SYNOPSIS $PCP_PMDAS_DIR/trace/pmdatrace [-d domain] [-l logfile] [-A access] [-I port] [-M username] [-N buckets] [-T period] [-U units] DESCRIPTION pmdatrace is a Performance Metrics Domain Agent (PMDA) which exports transaction performance metrics from application processes which use the pcp_trace library described in pmdatrace(3). A brief description…
NAME pmdate – display an offset date SYNOPSIS pmdate [ offset … ] format DESCRIPTION pmdate displays the current date and/or time, with an optional offset. An offset is specified with a leading sign (“+” or “-”), followed by an integer value, followed by one of the following “scale” specifiers; S seconds M minutes H…
NAME pmdasystemd – systemd performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/systemd/pmdasystemd [-f] [-d domain] [-l logfile] [-m memory] [-s interval] [-U username] DESCRIPTION pmdasystemd is a systemd log file monitoring Performance Metrics Domain Agent (PMDA). It can be seen as analagous to the -f option to journalctl(1) and converts each new log line into a…
NAME pmdasummary – summary performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/summary/pmdasummary [-d domain] [-h helpfile] [-l logfile] [-U username] pmie-command-line DESCRIPTION pmdasummary is a Performance Metrics Domain Agent (PMDA) which derives performance metrics values from values made available by other PMDAs. pmdasummary consists of two processes: pmie process The inference engine for performance values pmie(1)…
NAME pmdasnmp – Gateway from SNMP to PCP (PMDA) DESCRIPTION pmdasnmp is a Performance Metrics Domain Agent (PMDA) which provides a generic gateway from PCP queries from a PCP client to SNMP queries to one or more SNMP agents. INSTALLATION If you want access to the SNMP gateway performance metrics, do the following as root:…
NAME pmdaslurm – SLURM statistics performance metrics domain agent (PMDA) DESCRIPTION pmdaslurm is a Performance Metrics Domain Agent (PMDA) which exports metric values from the slurm perlapi interface to provide information on slurm jobs, nodes and users. INSTALLATION Install the slurm PMDA by using the Install script as root: # cd $PCP_PMDAS_DIR/slurm # ./Install To uninstall, do the…
NAME pmdasimple – simple performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/simple/pmdasimple [-d domain] [-i port] [-l logfile] [-p] [-u socket] [-U username] DESCRIPTION pmdasimple is a simple Performance Metrics Domain Agent (PMDA) which exports a small number of synthetic performance metrics. The simple PMDA is shipped as source code and is designed to be an…
NAME pmdashping – "shell-ping" performance metrics domain agent SYNOPSIS $PCP_PMDAS_DIR/shping/pmdashping [-C] [-d domain] [-l logfile] [-I interval] [-t timeout] [-U username] configfile DESCRIPTION pmdashping is a Performance Metrics Domain Agent (PMDA) which exports quality of service and response time measurements for arbitrary commands as might be run from a shell such as sh(1). These measurements…
NAME pmdasendmail – sendmail performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/sendmail/pmdasendmail [-d domain] [-l logfile] [-U username] DESCRIPTION pmdasendmail is a sendmail Performance Metrics Domain Agent (PMDA) which exports mail traffic statistics as collected by sendmail(1). Before the sendmail PMDA can export any metrics, sendmail(1) must have statistics collection enabled. This involves checking the name…
NAME pmdasample – sample performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/pmdasample [-d domain] [-i port] [-l logfile] [-p] [-u socket] [-U username] DESCRIPTION pmdasample is a sample Performance Metrics Domain Agent (PMDA) which exports a variety of synthetic performance metrics. This PMDA was developed as part of the quality assurance testing for the PCP product,…
NAME pmdasamba – Samba performance metrics domain agent (PMDA) DESCRIPTION pmdasamba is a Performance Metrics Domain Agent (PMDA) which exports metric values from Samba, a Windows SMB/CIFS server for UNIX. In order for values to be made available by this PMDA, Samba must have been built with profiling support (WITH_PROFILE in “smbd -b” output). This…
NAME pmdarsyslog – rsyslog (reliable and extended syslog) PMDA DESCRIPTION pmdarsyslog is a Performance Metrics Domain Agent (PMDA) which exports metric values from the rsyslogd(8) server. Further details about rsyslog can be found at http://www.rsyslog.com/. INSTALLATION If you want access to the names and values for the rsyslog performance metrics, do the following as root:…
NAME pmdaroot – a privileged PMCD helper performance metrics domain agent SYNOPSIS $PCP_PMDAS_DIR/root/pmdaroot [-d domain] [-l logfile] [-s sockname] DESCRIPTION pmdaroot is a special Performance Metrics Domain Agent (PMDA) which cooperates closely with pmcd(1) and other PMDAs to provide limited privileged services to these unprivileged processes. In this role it is used to discover operating…
NAME pmdaroomtemp – room temperature performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/roomtemp/pmdaroomtemp [-d domain] [-l logfile] DESCRIPTION pmdaroomtemp is a Performance Metrics Domain Agent (PMDA) which exports the temperature from one or more sensors built using the DS2480 and DS1280 chipsets and MicroLAN technology from Dallas Semiconductor Corporation. The roomtemp PMDA exports metrics that reflect…
NAME pmdaproc – process performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/proc/pmdaproc [-AL] [-d domain] [-l logfile] [-r cgroup] [-U username] DESCRIPTION pmdaproc is a Performance Metrics Domain Agent (PMDA) which extracts performance metrics describing the state of the individual processes running on a Linux system. The proc PMDA exports metrics that measure the memory, processor…
NAME pmdapostgresql – PostgreSQL database PMDA DESCRIPTION pmdapostgresql is a Performance Co-Pilot PMDA which extracts live performance data from a running PostgreSQL database. INSTALLATION pmdapostgresql uses a configuration file from (in this order): • /etc/pcpdbi.conf • $PCP_PMDAS_DIR/postgresql/postgresql.conf • ./postgresql.conf This file can contain overridden values (Perl code) for the settings listed at the start of…
NAME pmdapostfix – Postfix performance metrics domain agent (PMDA) DESCRIPTION pmdapostfix is a Performance Metrics Domain Agent (PMDA) which exports mail queue sizes as reported by qshape(1), as well as aggregate statistics collected from mail.log. INSTALLATION If you want access to the names and values for the Postfix performance metrics, do the following as root:…
NAME pmdapipe – command output capture performance metrics domain agent (PMDA) SYNOPSIS $PCP_PMDAS_DIR/pipe/pmdapipe [-c configfile] [-d domain] [-l logfile] [-m memory] DESCRIPTION pmdapipe is a configurable command output monitoring Performance Metrics Domain Agent (PMDA). It can be seen as analogous to a restricted shell, where options can be passed to preset commands, and each line…