PMSERIES(1) General Commands Manual PMSERIES(1) (NAME) pmseries - (SYNOPSIS) pmseries [-adFiIlLmMnqsStvV?] [-c config] [-D debug] [-g pattern] [-h host] [-p port] [-w window] [-Z timezone] [query | labels ... | series ... | source ... ] (DESCRIPTION) pmseries Performance Co-Pilot (PCP) - https://valkey/io . pmseries - -h -p - . . pmseries - ( - ) . () pmproxy(1) <<>> ( ) pmlogger(1) . TIMESERIES LOADING -L . pmseries . SHA-1 . . ( ) . ( ) - /etc/machine-id hostname domainname /etc/pcp/labels . pminfo(1) pmcd.labels . pmLookupLabels(3) pmLookupInDom(3) pmLookupName(3) pmLookupDesc(3) . ( ) PCP ( pmID) (pmInDom) . PCPIntro(1) . pmseries pminfo(1) indom . pmseries ( ) . ( ) pmseries - -a . ..SH " (TIMESERIES QUERIES)" pmseries . ( glob) : $ pmseries kernel.all.cpu* 1d7b0bb3f6aec0f49c54f5210885464a53629b60 379db729afd63fb9eff436625bd6c55a7adc5cfd 3dd3b45bb05f96636043e5d58b52b441ce542285 [...] ed2bf325ff6dc7589ec966698e5404b67252306a dcb2a032a308b5717bf605ba8f8737e9c6e1ed19 : [metric.name] '{metadata qualifiers}' '[time specification]' metric.name PCP ( PCP pminfo(1) --host --archive ). pmseries pminfo glob(7) . pmseries . EXPRESSIONS . (METADATA QUALIFIERS AND METADATA OPERATORS) ({}) . (instance) metadata.name OPERATOR value : instance.name == "cpu0" metric.name != "kernel.all.pswitch" : label.hostname == "www.acme.com" hostname == "www.acme.com" . : (Boolean operators) ( ) () ("==") ("!=") . (String operators) glob ("~~") ("=~") ("!~") . ":" "~~" ( glob) . ( ) (Relational operators (numeric label values only)) ("<") (">") ("<=") (">=") ("==") ("!=") ..SS (Logical operators) AND ("&&") OR ("||") . (",") AND ("&&") . (TIME SPECIFICATION) () . . ([]) . keyword: value : samples:10 (Sample count) samples ( ) count . value . ( << >> ) . (Sample interval) interval ( ) delta . value pmParseInterval(3) 5 () 2min (). (Time window) . pmParseTimeWindow(3) : start ( ) begin finish ( ) end align offset. (Time zones) timezone hostzone . value timezone pmNewZone(3) . true false hostzone true pmNewContextZone(3) ..SH " (EXPRESSIONS)" . [metric.name] '{metadata qualifiers}' '[time specification]' metadata qualifiers . hostname. . (binary) . ( ) rescale. operand | expr operator expr | func(expr[, arg]) (+): func1(func2(expr)) func1(expr) + func2(expr) expr + func(expr) func(expr) + expr expr + expr / . . pmseries (SID) . SID REST API /series/values?series=SID . (Arithmetic Operators) pmseries . () . (instance domain) . ( ) . ( ) . ( ) ( ). ( hostname) . (pswitch) node88 node89 (rate): $ pmseries 'rate(kernel.all.pswitch{hostname:node88}[count:2] + kernel.all.pswitch{hostname:node89}[count:2])' 1cf1a85d5978640ef94c68264d3ae8866cc11f7c [Tue Nov 10 14:39:48.771868000 2020] 71.257509 8e0a59304eb99237b89593a3e839b5bb8b9a9924 rate . : 1. 2. 3. . 4. - . 5. - . 6. - ..SS " (Functions)" (Expression functions) . (instance) . $ pmseries 'min_sample(kernel.all.load[count:100])' (load average) . : $ pmseries 'kernel.all.load[count:2]' 726a325c4c1ba4339ecffcdebd240f441ea77848 [Tue Nov 10 11:52:30.833379000 2020] 1.100000e+00 a7c96e5e2e0431a12279756d11590fa9fed8f306 [Tue Nov 10 11:52:30.833379000 2020] 9.900000e-01 ee9b506935fd0976a893dc27242926f49326b9a1 [Tue Nov 10 11:52:30.833379000 2020] 1.070000e+00 d5e1c360d13064c461169091997e1e8be7488133 [Tue Nov 10 11:52:20.827134000 2020] 1.120000e+00 a7c96e5e2e0431a12279756d11590fa9fed8f306 [Tue Nov 10 11:52:20.827134000 2020] 9.900000e-01 ee9b506935fd0976a893dc27242926f49326b9a1 [Tue Nov 10 11:52:20.827134000 2020] 1.070000e+00 d5e1c360d13064c461169091997e1e8be7488133 min_sample: $ pmseries 'min_sample(kernel.all.load[count:2])' 11b965bc5f9598034ed9139fb3a78c6c0b7065ba [Tue Nov 10 11:52:30.833379000 2020] 1.100000e+00 a7c96e5e2e0431a12279756d11590fa9fed8f306 [Tue Nov 10 11:52:30.833379000 2020] 9.900000e-01 ee9b506935fd0976a893dc27242926f49326b9a1 [Tue Nov 10 11:52:30.833379000 2020] 1.070000e+00 d5e1c360d13064c461169091997e1e8be7488133 ( ) (context switching): $ pmseries 'kernel.all.pswitch[count:5]' d7832c4fba33bcc980b1a1b614e0508043288480 [Tue Nov 10 12:44:59.380666000 2020] 460774294 [Tue Nov 10 12:44:49.382070000 2020] 460747232 [Tue Nov 10 12:44:39.378545000 2020] 460722370 [Tue Nov 10 12:44:29.379029000 2020] 460697388 [Tue Nov 10 12:44:19.379096000 2020] 460657412 $ pmseries 'min_sample(kernel.all.pswitch[count:5])' 1b6e92fb5bc012372f54452734dd03f0f131fa06 [Tue Nov 10 12:44:19.379096000 2020] 460657412 d7832c4fba33bcc980b1a1b614e0508043288480 pmseries . max_inst(expr) max_sample(expr) . pmseries . (Function Reference) max_inst(expr) expr. max max_inst . max_sample(expr) expr . min_inst(expr) expr. min min_inst . min_sample(expr) expr . sum_inst(expr) expr. sum sum_inst . sum_sample(expr) expr . avg_inst(expr) expr. avg avg_inst . avg_sample(expr) expr . rate(expr) . expr counter instant ( ). - ( ). rescale(expr,scale) expr scale () . expr instant discrete ( counter - ). expr scale . : . disk.dev.read_bytes counter . $ pmseries 'rescale(rate(disk.dev.read_bytes[count:4]), "mbytes/s")' abs(expr) expr. expr (unsigned) . floor(expr) expr. round(expr) expr. log(expr) expr sqrt(expr) () expr stdev_inst(expr) expr. stdev_sample(expr) expr . topk_inst(expr,k) k expr. topk_sample(expr,k) k expr ..P nth_percentile_inst(expr,percentile_value) n- expr. percentile_value 0 100 . nth_percentile_sample(expr,percentile_value) n- expr . percentile_value 0 100 . (Compatibility) . . . (SID) REST API /series/values?series=SID . PMWEBAPI(3) . ( PM_SEM_INSTANT PM_SEM_DISCRETE) PM_SEM_INSTANT PM_SEM_DISCRETE PM_SEM_DISCRETE . (TIMESERIES METADATA) pmseries ( ) : $ pmseries -a dcb2a032a308b5717bf605ba8f8737e9c6e1ed19 dcb2a032a308b5717bf605ba8f8737e9c6e1ed19 PMID: 60.0.21 Data Type: 64-bit unsigned int InDom: PM_INDOM_NULL 0xffffffff Semantics: counter Units: millisec Source: f5ca7481da8c038325d15612bb1c6473ce1ef16f Metric: kernel.all.cpu.nice labels {"agent":"linux","domainname":"localdomain",\ "groupid":1000,"hostname":"shard",\ "latitude":-25.28496,"longitude":152.87886,\ "machineid":"295b16e3b6074cc8bdbda8bf96f6930a",\ "userid":1000} pmseries : -a, --all -deilms. -d, --desc PMID (InDom) . pminfo(1) . -F, --fast . -g pattern, --glob=pattern pattern () glob(7) -i -l -m -S. -i, --instances PMID . -I, --fullindom InDom (verbose). pminfo(1) . -l, --labels . pmLookupLabels(3) . pminfo(1) . -m, --metrics . -M, --fullpmid PMID (verbose). pminfo(1) . -n, --names ( ) . -s, --series . ( ) PMAPI () . pmcd(1) . pminfo(1) . pmLookupLabels(3) -l/--labels ..SH " (TIMESERIES SOURCES)" ( SHA-1 ) / . (context) ( -s ) : -S, --sources . (hostname) . ( ) SHA-1 ( PCP pmcd(1) ). (TIMESERIES LOADING) pmproxy(1) pmseries -L/--load: $ pmseries --load "{source.path: \"$PCP_LOG_DIR/pmlogger/acme\"}" pmseries: [Info] processed 2275 archive records from [...] ( ) . load access(2) : $ pmseries --load $PCP_LOG_DIR/pmlogger/acme.0 : ( ) - (append-only) stream.maxlen ( $PCP_SYSCONF_DIR/pmseries/pmseries.conf) . (OPTIONS) : -c config, --config=config config . -h host, --host=host - host localhost. -L, --load -. -p port, --port=port - port 6379. -q, --query . . -t, --times ( ) . -v, --values () label series. -w, --window series ( query ) . <