1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
|
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004 Ian Berry |
| |
| This program is free software; you can redistribute it and/or |
| modify it under the terms of the GNU General Public License |
| as published by the Free Software Foundation; either version 2 |
| of the License, or (at your option) any later version. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
+-------------------------------------------------------------------------+
| cacti: a php-based graphing solution |
+-------------------------------------------------------------------------+
| Most of this code has been designed, written and is maintained by |
| Ian Berry. See about.php for specific developer credit. Any questions |
| or comments regarding this code should be directed to: |
| - iberry@raxnet.net |
+-------------------------------------------------------------------------+
| - raXnet - http://www.raxnet.net/ |
+-------------------------------------------------------------------------+
*/
/* ninety_fifth_percentile - given a data source, calculate the 95th percentile for a given
time period
@arg $local_data_id - the data source to perform the 95th percentile calculation
@arg $start_time - the start time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $end_time - the end time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $resolution - the accuracy of the data measured in seconds
@returns - (array) an array containing each data source item, and its 95th percentile */
function ninety_fifth_percentile($local_data_id, $start_time, $end_time) {
$fetch_array = rrdtool_function_fetch($local_data_id, $start_time, $end_time);
if ((!isset($fetch_array["data_source_names"])) || (count($fetch_array["data_source_names"]) == 0)) {
return;
}
$return_array = array();
/* loop through each regexp determined above (or each data source) */
for ($i=0;$i<count($fetch_array["data_source_names"]);$i++) {
if (isset($fetch_array["values"][$i])) {
$values_array = $fetch_array["values"][$i];
/* sort the array in descending order */
rsort($values_array);
/* grab the 95% row (or 5% in reverse) and use that as our 95th percentile
value */
$target = ((count($values_array) + 1) * .05);
$target = sprintf("%d", $target);
}
if (empty($values_array[$target])) { $values_array[$target] = 0; }
/* collect 95th percentile values in this array so we can return them */
$return_array{$fetch_array["data_source_names"][$i]} = $values_array[$target];
}
return $return_array;
}
/* bandwidth_summation - given a data source, sums all data in the rrd for a given
time period
@arg $local_data_id - the data source to perform the summation for
@arg $start_time - the start time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $end_time - the end time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $resolution - the accuracy of the data measured in seconds
@arg $rra_steps - how many periods each sample in the RRA counts for, values above '1'
result in an averaged summation
@arg $ds_steps - how many seconds each period represents
@returns - (array) an array containing each data source item, and its sum */
function bandwidth_summation($local_data_id, $start_time, $end_time, $rra_steps, $ds_steps) {
$fetch_array = rrdtool_function_fetch($local_data_id, $start_time, $end_time, $rra_steps * $ds_steps);
if ((!isset($fetch_array["data_source_names"])) || (count($fetch_array["data_source_names"]) == 0)) {
return;
}
$return_array = array();
/* loop through each regexp determined above (or each data source) */
for ($i=0;$i<count($fetch_array["data_source_names"]);$i++) {
$sum = 0;
if (isset($fetch_array["values"][$i])) {
$values_array = $fetch_array["values"][$i];
for ($j=0;$j<count($fetch_array["values"][$i]);$j++) {
$sum += $fetch_array["values"][$i][$j];
}
if (count($fetch_array["values"][$i]) != 0) {
$sum = ($sum * $ds_steps * $rra_steps);
}else{
$sum = 0;
}
/* collect 95th percentile values in this array so we can return them */
$return_array{$fetch_array["data_source_names"][$i]} = $sum;
}
}
return $return_array;
}
/* variable_ninety_fifth_percentile - given a 95th percentile variable, calculate the 95th percentile
and format it for display on the graph
@arg $regexp_match_array - the array that contains each argument in the 95th percentile variable. it
should be formatted like so:
$arr[0] // full variable string
$arr[1] // bits or bytes
$arr[2] // power of 10 divisor
$arr[3] // current, total, or max
$arr[4] // digits of floating point precision
@arg $graph_item - an array that contains the current graph item
@arg $graph_items - an array that contains all graph items
@arg $graph_start - the start time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $graph_end - the end time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $seconds_between_graph_updates - the number of seconds between each update on the graph which
varies depending on the RRA in use
@returns - a string containg the 95th percentile suitable for placing on the graph */
function variable_ninety_fifth_percentile(&$regexp_match_array, &$graph_item, &$graph_items, $graph_start, $graph_end) {
global $graph_item_types;
if (sizeof($regexp_match_array) == 0) {
return 0;
}
if (($regexp_match_array[3] == "current") || ($regexp_match_array[3] == "max")) {
$ninety_fifth_cache{$graph_item["local_data_id"]} = ninety_fifth_percentile($graph_item["local_data_id"], $graph_start, $graph_end);
}elseif ($regexp_match_array[3] == "total") {
for ($t=0;($t<count($graph_items));$t++) {
if (!empty($graph_items[$t]["local_data_id"])) {
$ninety_fifth_cache{$graph_items[$t]["local_data_id"]} = ninety_fifth_percentile($graph_items[$t]["local_data_id"], $graph_start, $graph_end);
}
}
}
$ninety_fifth = 0;
/* format the output according to args passed to the variable */
if ($regexp_match_array[3] == "current") {
$ninety_fifth = $ninety_fifth_cache{$graph_item["local_data_id"]}{$graph_item["data_source_name"]};
$ninety_fifth = ($regexp_match_array[1] == "bits") ? $ninety_fifth * 8 : $ninety_fifth;
$ninety_fifth /= pow(10,intval($regexp_match_array[2]));
}elseif ($regexp_match_array[3] == "total") {
for ($t=0;($t<count($graph_items));$t++) {
if ((ereg("(AREA|STACK|LINE[123])", $graph_item_types{$graph_items[$t]["graph_type_id"]})) && (!empty($graph_items[$t]["data_template_rrd_id"]))) {
$local_ninety_fifth = $ninety_fifth_cache{$graph_items[$t]["local_data_id"]}{$graph_items[$t]["data_source_name"]};
$local_ninety_fifth = ($regexp_match_array[1] == "bits") ? $local_ninety_fifth * 8 : $local_ninety_fifth;
$local_ninety_fifth /= pow(10,intval($regexp_match_array[2]));
$ninety_fifth += $local_ninety_fifth;
}
}
}elseif ($regexp_match_array[3] == "max") {
$ninety_fifth = $ninety_fifth_cache{$graph_item["local_data_id"]}["ninety_fifth_percentile_maximum"];
$ninety_fifth = ($regexp_match_array[1] == "bits") ? $ninety_fifth * 8 : $ninety_fifth;
$ninety_fifth /= pow(10,intval($regexp_match_array[2]));
}
/* determine the floating point precision */
if ((isset($regexp_match_array[5])) && (ereg("^[0-9]+$", $regexp_match_array[5]))) {
$round_to = $regexp_match_array[5];
}else{
$round_to = 2;
}
/* return the final result and round off to two decimal digits */
return round($ninety_fifth, $round_to);
}
/* variable_bandwidth_summation - given a bandwidth summation variable, calculate the summation
and format it for display on the graph
@arg $regexp_match_array - the array that contains each argument in the bandwidth summation variable. it
should be formatted like so:
$arr[0] // full variable string
$arr[1] // power of 10 divisor or 'auto'
$arr[2] // current, total
$arr[3] // digits of floating point precision
$arr[4] // seconds to perform the calculation for or 'auto'
@arg $graph_item - an array that contains the current graph item
@arg $graph_items - an array that contains all graph items
@arg $graph_start - the start time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $graph_end - the end time to use for the data calculation. this value can
either be absolute (unix timestamp) or relative (to now)
@arg $seconds_between_graph_updates - the number of seconds between each update on the graph which
varies depending on the RRA in use
@arg $rra_step - how many periods each sample in the RRA counts for, values above '1' result in an
averaged summation
@arg $ds_step - how many seconds each period represents
@returns - a string containg the bandwidth summation suitable for placing on the graph */
function variable_bandwidth_summation(&$regexp_match_array, &$graph_item, &$graph_items, $graph_start, $graph_end, $rra_step, $ds_step) {
global $graph_item_types;
if (sizeof($regexp_match_array) == 0) {
return 0;
}
if (is_numeric($regexp_match_array[4])) {
$summation_timespan_start = -$regexp_match_array[4];
}else{
$summation_timespan_start = $graph_start;
}
if ($regexp_match_array[2] == "current") {
$summation_cache{$graph_item["local_data_id"]} = bandwidth_summation($graph_item["local_data_id"], $summation_timespan_start, $graph_end, $rra_step, $ds_step);
}elseif ($regexp_match_array[2] == "total") {
for ($t=0;($t<count($graph_items));$t++) {
if (!empty($graph_items[$t]["local_data_id"])) {
$summation_cache{$graph_items[$t]["local_data_id"]} = bandwidth_summation($graph_items[$t]["local_data_id"], $summation_timespan_start, $graph_end, $rra_step, $ds_step);
}
}
}elseif ($regexp_match_array[2] == "atomic") {
$summation_cache{$graph_item["local_data_id"]} = bandwidth_summation($graph_item["local_data_id"], $summation_timespan_start, $graph_end, $rra_step, 1);
}
$summation = 0;
/* format the output according to args passed to the variable */
if (($regexp_match_array[2] == "current") || ($regexp_match_array[2] == "atomic")) {
$summation = $summation_cache{$graph_item["local_data_id"]}{$graph_item["data_source_name"]};
}elseif ($regexp_match_array[2] == "total") {
for ($t=0;($t<count($graph_items));$t++) {
if ((ereg("(AREA|STACK|LINE[123])", $graph_item_types{$graph_items[$t]["graph_type_id"]})) && (!empty($graph_items[$t]["data_template_rrd_id"]))) {
$local_summation = $summation_cache{$graph_items[$t]["local_data_id"]}{$graph_items[$t]["data_source_name"]};
$summation += $local_summation;
}
}
}
if (preg_match("/\d+/", $regexp_match_array[1])) {
$summation /= pow(10,intval($regexp_match_array[1]));
}elseif ($regexp_match_array[1] == "auto") {
if ($summation < 1000) {
$summation_label = "bytes";
}elseif ($summation < 1000000) {
$summation_label = "KB";
$summation /= 1000;
}elseif ($summation < 1000000000) {
$summation_label = "MB";
$summation /= 1000000;
}elseif ($summation < 1000000000000) {
$summation_label = "GB";
$summation /= 1000000000;
}else{
$summation_label = "TB";
$summation /= 1000000000000;
}
}
/* determine the floating point precision */
if (is_numeric($regexp_match_array[3])) {
$round_to = $regexp_match_array[3];
}else{
$round_to = 2;
}
/* substitute in the final result and round off to two decimal digits */
if (isset($summation_label)) {
return round($summation, $round_to) . " $summation_label";
}else{
return round($summation, $round_to);
}
}
?>
|
