Software Development Kit (SDK) and API Discussions

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

kevingraham
1,673 Views

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?

0 REPLIES 0
Public