PMREP(1) General Commands Manual PMREP(1) (NAME) pmrep, pcp2csv - (SYNOPSIS) pmrep [-12357CdgGHIjkLmnprRuUvVxz?] [-4 action] [-6 sort-metric] [-8|-9 limit] [-a archive] [-A align] [--archive-folio folio] [-b|-B space- scale] [-c config] [--container container] [--csv-unit-info] [-D debug] [--daemonize] [-e derived] [-E lines] [-f format] [-F outfile] [-h host] [-i instances] [--include-texts] [-J rank] [-K spec] [-l delimiter] [-N predicate] [--no-inst-info] [-o output] [-O origin] [-P|-0 precision] [-q|-Q count-scale] [-s samples] [-S starttime] [-t interval] [-T endtime] [-w|-W width] [-X label] [-y|-Y time-scale] [-Z timezone] metricspec [...] (DESCRIPTION) pmrep . / . pmrep Performance Co-Pilot (PCP) PCPIntro(1). . PCP . (derived metrics) pmRegisterDerived(3) . metricset ( ) NUMA sar(1) pmrep $PCP_SYSCONF_DIR/pmrep ( /etc/pcp/pmrep) . Tab metricset bash zsh . -h pmrep (PMCD pmcd(1)) . -a pmrep PMCD . -a -h ( ) . -L pmrep (context) DSO PMDA ( <<>>) PMCD . . -a -h -L . () metricspec . metricspec (PMNS) pmrep PMNS ( ) metricspec . pminfo(1) ( PMNS) . metricspec . (``:'') metricset pmrep ( -c pmrep.conf(5)) . metricspec PMNS . (compact form) metricspec : metric[,label[,instances[,unit/scale[,type[,width[,precision[,limit]]]]]]] PMNS (metric) . label stdout . instances csv stdout ( -i). unit/scale . unit/scale . (rate) type raw . stdout width . . precision . limit ..PP ( ) unit/scale ( / ) sec ( -y -Y ). metricspec kernel.all.sysfork forks count/s 8 . . kernel.all.sysfork,forks,,,,8 metricspec verbose form pmrep.conf(5) . PMNS . ( pmGetOptions(3)) ( ) . ( ) . ( ) . pcp2csv pmrep . (OPTIONS) : -0 precision, --precision-force=precision -P . -1, --dynamic-header . . -4 -7 -E. -2, --overall-rank . ( -J) . . pmlogsummary(1) . -3, --overall-rank-alt -2 metricspec pmrep . -4 action, --names-change=action . PMDA pmrep . action update ( ) ignore ( - ) abort ( ). update --dynamic-header . -5, --ignore-unknown pmrep <<>> (unknown) : PMNS (pmcd(1) PCP ) . pmrep . -5 pmrep . pmRegisterDerivedMetric(3) . -6, --sort-metric=sort-metric -X . (``-'') . -J -N. -7, --fixed-header -X ( -E) . () . () . -1 -E. -8 limit, --limit-filter=limit / limit . . . . . -J -N. -9 limit, --limit-filter-force=limit -8 . -a archive, --archive=archive Performance Co-Pilot (PCP) archive . -u. -A align, --align=align align . align PCPIntro(1) ..TP --archive-folio=folio folio PCP pmchart(1) mkaf(1) . -b scale, --space-scale=scale / () bytes Kbytes KB Mbytes MB . . pmParseUnitsStr(3). -B scale, --space-scale-force=scale -b . -c config, --config=config config . config .conf . : ./pmrep.conf $HOME/.pmrep.conf $HOME/pcp/pmrep.conf $PCP_SYSCONF_DIR/pmrep/pmrep.conf $PCP_SYSCONF_DIR/pmrep. pmrep.conf(5). --container=container container ( -h). --csv-unit-info CSV metric(unit) metric[inst](unit). -k. -C, --check . -d, --delay ( -t) . --daemonize (Daemonize) . -e derived, --derived=derived (derived). derived (``/'') (``.'') PCP . PCP pmLoadDerivedConfig(3) pmRegisterDerived(3). pmrep.conf(5) (metricsets) . . -Dderive . -E lines, --repeat-header=lines lines . -1 -7 auto . -1 -7. -f format, --timestamp-format=format format . datetime.strftime strftime(3) . format ( "") . stdout %H:%M:%S . csv %Y-%m-%d %H:%M:%S . -F outfile, --output-file=outfile outfile. -o. -g, --separate-header . -G, --no-globals ( pmrep.conf(5)). -h host, --host=host pmcd(1) host localhost. -H, --no-header . -i instances, --instances=instances (instances) . ( -o) . instances . -j . (set-valued) metricspec . <<>> (flat) -v ..PP instances . (') (") . metricspec . (|) . -i . : name . sda disk.dev eth0 network.interface. PID proc. command proc. pmcd pmcd(1) PID . regex . .*python.* python Python PID . : $ pmrep -i '. minute' kernel.all.load $ pmrep -i '1 minute','5 minute' kernel.all.load $ pmrep -i "'1 minute','5 minute'" kernel.all.load $ pmrep -i '1 minute' -i '5 minute' kernel.all.load $ pmrep kernel.all.load,,"'1 minute','5 minute'" $ pmrep kernel.all.load,,'1 minute|5 minute' 1-minute : $ pmrep -i '1 minute','5 minute' kernel.all.load,,'1 minute' ( regex ): $ pmrep -i '1 minute','5 minute' 'kernel.all.load,,.*' -I, --ignore-incompat -5 pmrep <<>> : pmrep ( PM_TYPE_AGGREGATE PM_TYPE_EVENT) PMNS . pmrep . -I pmrep . PMNS . --include-texts PCP PCP . -j, --live-filter . ( ). . -1 -n. -J rank, --rank=rank / rank- (set- valued) . . . . -6. -2 -8. -k, --extended-csv CSV sadf(1) . --csv-unit-info. -K spec, --spec-local=spec ( -L) -K DSO PMDA . spec pmSpecLocalPMDA(3) . -K . -l delimiter, --delimiter=delimiter (delimiter) csv stdout . stdout (" ") csv (",") . ("_") . ( ) CSV --delimiter=, -L, --local-PMDA DSO PMDA PMCD . -K. -m, --include-labels PCP . -n, --invert-filter . ( -j) ( -J) . . -N predicate, --predicate=predicate predicate . ( -J) . (predicates) . (instance domain) ( PCPIntro(1)) / . -6. proc.memory.rss ( ) predicate proc.io.total_bytes mem.util.used / ( -J) . mem.util.used ( ) . --no-inst-info (instance) . ( -g). -o output, --output=output output . stdout . : archive PCP PCP pmrep . PCP LOGARCHIVE(5) PCPIntro(1). -F . csv CSV ( ). stdout stdout ( ). -O origin, --origin=origin origin ( -S -T). origin PCPIntro(1) . -p, --timestamps . . -P precision, --precision=precision precision . precision . ( ). . -q scale, --count-scale=scale / count x 10^-1, count, count x 10, count x 10^2, 10^-8 10^7 . ( .) . pmParseUnitsStr(3). -Q scale, --count-scale-force=scale -q . -r, --raw . . . -R, --raw-prefer -r . -s samples, --samples=samples samples . samples 0 -s pmrep ( ) PCP ( ) . -T. -S starttime, --start=starttime starttime . starttime PCPIntro(1) . -t interval, --interval=interval interval . interval PCPIntro(1) ( ). -T -u. -T endtime, --finish=endtime endtime . endtime PCPIntro(1) . pmrep samples ( -s) interval ( -t). samples interval samples . -T, -s, -t endtime pmrep . -u, --no-interpol ( -t ) . PCP . -u (-t) . PCP pmrep . -u ( -r -R ). -U, --no-unit-info stdout. -v, --omit-flat ( disk.dev.read) <<>> ( kernel.all.sysfork). : -i -I. -V, --version . -w width, --width=width width () stdout. . width . . -W width, --width-force=width -w . -x, --extended-header . -X label, --colxrow=label stdout label . ("") . grep(1) . : -i -6. -y scale, --time-scale=scale / nanosec ns microsec us millisec ms hour hr. . : pmParseUnitsStr(3). -Y scale, --time-scale-force=scale -y . -z, --hostzone -h -a . . -Z timezone, --timezone=timezone timezone . Timezone TZ environ(7) . UTC ISO 8601 ( -Z EST+5 UTC-5 ). -?, --help ..SH " (EXAMPLES)" PCP . (.IR metricsets ) pmrep . bash zsh Tab . : $ pmrep network.interface.total.bytes wlan0: $ pmrep -i wlan0 -v network.interface.out slab ( ) slab : $ pmrep mem.slabinfo.slabs.total_size,,'kmalloc-4k|xfs_inode',MB vmstat(8) inode : $ pmrep -p -B MB :vmstat vfs.inodes.count server1 CSV sadf(1): $ pmrep -h server1 -t 2s -o csv -k disk.dev.read disk.dev.write -g (): $ pmrep -b MB --limit-filter 100 --dynamic-header proc.memory.rss pmrep.conf(5) I/O () pmlogger: $ pmrep -gp -i pmlogger :proc-io CPU : $ pmrep -1gUJ 3 proc.hog.cpu sar -w sar -W PCP ./20150921.09.13 : $ pmrep -a ./20150921.09.13 -S @15:00 -T @17:00 :sar-w :sar-W CPU I/O ( ) ./a : $ pmrep --daemonize -A 1m -t 1m -i '.*java.*' -j -o archive -F ./a \ :proc-info :proc-cpu :proc-mem :proc-io 389 Directory Server XFS CPU// PCP ./a: $ pmrep -t 5s -T 5m -o archive -F ./a ds389 xfs kernel.all.cpu mem disk I/O : $ pmrep -o archive -F ./a -J 3 -N proc.memory.rss proc.memory proc.io pmrep.conf pmrep ( -c) $PCP_SYSCONF_DIR/pmrep/*.conf pmrep PCP (PCP ENVIRONMENT) PCP_ PCP . /etc/pcp.conf . $PCP_CONF pcp.conf(5) . PCP pmGetOptions(3) . PCP_DISCRETE_ONCE . (DEBUGGING OPTIONS) -D --debug stderr . debug pmdbg(1) -l . pmrep : +----------------+-----------------------------------------------------+ | | | +----------------+-----------------------------------------------------+ |appl1 | | | | | | | | | | | +----------------+-----------------------------------------------------+ |derive | | | | | | | | +----------------+-----------------------------------------------------+ (SEE ALSO) PCPIntro(1), mkaf(1), pcp(1), pcp2elasticsearch(1), pcp2graphite(1), pcp2influxdb(1), pcp2json(1), pcp2spark(1), pcp2xlsx(1), pcp2xml(1), pcp2zabbix(1), pcp-atop(1), pmcd(1), pmchart(1), pmdiff(1), pmdumptext(1), pminfo(1), pmiostat(1), pmlogdump(1), pmlogextract(1), pmlogsummary(1), pmprobe(1), pmstat(1), pmval(1), sadf(1), sar(1), PMAPI(3), pmGetOptions(3), pmLoadDerivedConfig(3), pmParseUnitsStr(3), pmRegisterDerived(3), pmSpecLocalPMDA(3), strftime(3), LOGARCHIVE(5), PMNS(5), pcp.conf(5), pmrep.conf(5), environ(7) vmstat(8). Performance Co-Pilot PCP PMREP(1)