Subscribe

Handling of matrix perf-object-counter-info types?

The 'perf' ZAPI documentations call out ARRAY types and dealing with their labels, but there's no definition of how to handle matrices.

One example is perf:perf:cpu_disk_util_matrix, whose perf-object-counter-list-info and perf-object-get-instances values are shown below:

                <counter-info>

                        <name>cpu_disk_util_matrix</name>

                        <desc>Matrix of per second correlation between CPU utili

zation and disk utilization</desc>

                        <privilege-level>diag</privilege-level>

                        <properties>delta</properties>

                        <unit>none</unit>

                        <type>array</type>

                        <labels>

                                <label-info>0 - <10%,10 - <20%,20 - <30%,30 - <4

0%,40 - <50%,50 - <60%,60 - <70%,70 - <80%,80 - <90%,90 - 100%</label-info>

                                <label-info>0 - <10%,10 - <20%,20 - <30%,30 - <4

0%,40 - <50%,50 - <60%,60 - <70%,70 - <80%,80 - <90%,90 - 100%</label-info>

                        </labels>

                </counter-info>

                                <counter-data>

                                        <name>cpu_disk_util_matrix</name>

                                        <value>296,3665,1094,156,60,47,28,11,2,6

4,1006,63311,20339,3294,619,1350,109,96,48,6127,185,154598,249343,52811,10754,52

76,857,667,889,15272,103,69159,496216,269353,66473,18853,4369,2712,4604,21806,48

,16976,336832,543179,236185,83707,22877,10183,8654,31663,16,5613,152144,526922,4

29262,204981,70852,29877,17113,33352,12,2154,61265,364364,563583,400869,176524,6

9122,30599,32601,9,1882,26045,209906,570886,632157,374827,158500,61580,41222,16,

3798,24520,113810,421882,756790,665648,350748,141147,70235,12,754,15408,100896,3

73368,1014174,1584875,1249035,518984,189089</value>

                                </counter-data>

It would seem that the presence of multiple label-info elements is the only indication this isn't a simple array type. Is there a more correct indicator that should be used?

The labels are presented dimensionally and the values (perf-object-get-instances) are collapsed to a single dimension. What's the correct serialization of the labels?

Though I couldn't find any examples, are counters with three or more dimensions supported by the underlying counter manager?