1 QA output created by 716
2 dbpmda> open pipe /usr/bin/perl pmdasimple.pl
3 Start perl PMDA: /usr/bin/perl pmdasimple.pl
5 dbpmda> desc simple.numfetch
7 Data Type: 32-bit unsigned int InDom: PM_INDOM_NULL 0xffffffff
8 Semantics: instant Units: none
9 dbpmda> fetch simple.numfetch
11 pmResult ... numpmid: 1
12 253.0.0 (simple.numfetch): numval: 1 valfmt: 0 vlist[]:
14 dbpmda> text simple.numfetch
16 [Number of pmFetch operations.]
17 The cumulative number of pmFetch operations directed to the "simple"
20 This counter may be modified with pmstore(1).
21 dbpmda> desc simple.color
23 Data Type: 32-bit int InDom: 253.0 0x3f400000
24 Semantics: instant Units: none
25 dbpmda> fetch simple.color
27 pmResult ... numpmid: 1
28 253.0.1 (simple.color): numval: 3 valfmt: 0 vlist[]:
29 inst [0 or ???] value NUMBER
30 inst [1 or ???] value NUMBER
31 inst [2 or ???] value NUMBER
32 dbpmda> text simple.color
34 [Metrics which increment with each fetch]
35 This metric has 3 instances, designated "red", "green" and "blue".
37 The value of the metric is monotonic increasing in the range NUMBER to
38 255, then back to 0. The different instances have different starting
39 values, namely 0 (red), 100 (green) and 200 (blue).
41 The metric values my be altered using pmstore(1).
42 dbpmda> desc simple.now
44 Data Type: 32-bit unsigned int InDom: 253.1 0x3f400001
45 Semantics: instant Units: none
46 dbpmda> fetch simple.now
48 pmResult ... numpmid: 1
49 253.2.4 (simple.now): numval: 3 valfmt: 0 vlist[]:
50 inst [0 or ???] value NUMBER
51 inst [1 or ???] value NUMBER
52 inst [2 or ???] value NUMBER
53 dbpmda> text simple.now
55 [Time of day with a configurable instance domain]
56 The value reflects the current time of day through a dynamically
57 reconfigurable instance domain. On each metric value fetch request,
58 the agent checks to see whether the configuration file in
59 $PCP_PMDAS_DIR/simple/simple.conf has been modified - if it has then
60 the file is re-parsed and the instance domain for this metric is again
61 constructed according to its contents.
63 This configuration file contains a single line of comma-separated time
65 "sec" (seconds after the minute),
66 "min" (minutes after the hour),
67 "hour" (hour since midnight).
69 An example configuration file could be: sec,min,hour
70 and in this case the simple.now metric would export values
71 for the three instances "sec", "min" and "hour" corresponding
72 respectively to the components seconds, minutes and hours of the
75 The instance domain reflects each token present in the file, and the
76 values reflect the time at which the PMDA processes the fetch.
77 dbpmda> instance 253.0
79 [ 0] inst: 0 name: "red"
80 [ 1] inst: 1 name: "green"
81 [ 2] inst: 2 name: "blue"
82 dbpmda> text indom 253.1
84 [Instance domain "colour" for simple PMDA]
85 Universally 3 instances, "red" (0), "green" (1) and "blue" (3).