]> arthur.barton.de Git - netdata.git/blob - src/rrd2json.c
Merge pull request #1737 from l2isbad/pythond_plugin_improvements
[netdata.git] / src / rrd2json.c
1 #include "common.h"
2
3 void rrd_stats_api_v1_chart_with_data(RRDSET *st, BUFFER *wb, size_t *dimensions_count, size_t *memory_used)
4 {
5     pthread_rwlock_rdlock(&st->rwlock);
6
7     buffer_sprintf(wb,
8         "\t\t{\n"
9         "\t\t\t\"id\": \"%s\",\n"
10         "\t\t\t\"name\": \"%s\",\n"
11         "\t\t\t\"type\": \"%s\",\n"
12         "\t\t\t\"family\": \"%s\",\n"
13         "\t\t\t\"context\": \"%s\",\n"
14         "\t\t\t\"title\": \"%s\",\n"
15         "\t\t\t\"priority\": %ld,\n"
16         "\t\t\t\"enabled\": %s,\n"
17         "\t\t\t\"units\": \"%s\",\n"
18         "\t\t\t\"data_url\": \"/api/v1/data?chart=%s\",\n"
19         "\t\t\t\"chart_type\": \"%s\",\n"
20         "\t\t\t\"duration\": %ld,\n"
21         "\t\t\t\"first_entry\": %ld,\n"
22         "\t\t\t\"last_entry\": %ld,\n"
23         "\t\t\t\"update_every\": %d,\n"
24         "\t\t\t\"dimensions\": {\n"
25         , st->id
26         , st->name
27         , st->type
28         , st->family
29         , st->context
30         , st->title
31         , st->priority
32         , st->enabled?"true":"false"
33         , st->units
34         , st->name
35         , rrdset_type_name(st->chart_type)
36         , st->entries * st->update_every
37         , rrdset_first_entry_t(st)
38         , rrdset_last_entry_t(st)
39         , st->update_every
40         );
41
42     unsigned long memory = st->memsize;
43
44     size_t dimensions = 0;
45     RRDDIM *rd;
46     for(rd = st->dimensions; rd ; rd = rd->next) {
47         if(rd->flags & RRDDIM_FLAG_HIDDEN) continue;
48
49         memory += rd->memsize;
50
51         buffer_sprintf(wb,
52             "%s"
53             "\t\t\t\t\"%s\": { \"name\": \"%s\" }"
54             , dimensions?",\n":""
55             , rd->id
56             , rd->name
57             );
58
59         dimensions++;
60     }
61
62     if(dimensions_count) *dimensions_count += dimensions;
63     if(memory_used) *memory_used += memory;
64
65     buffer_strcat(wb, "\n\t\t\t},\n\t\t\t\"green\": ");
66     buffer_rrd_value(wb, st->green);
67     buffer_strcat(wb, ",\n\t\t\t\"red\": ");
68     buffer_rrd_value(wb, st->red);
69
70     buffer_sprintf(wb,
71         "\n\t\t}"
72         );
73
74     pthread_rwlock_unlock(&st->rwlock);
75 }
76
77 void rrd_stats_api_v1_chart(RRDSET *st, BUFFER *wb) {
78     rrd_stats_api_v1_chart_with_data(st, wb, NULL, NULL);
79 }
80
81 void rrd_stats_api_v1_charts(BUFFER *wb)
82 {
83     size_t c, dimensions = 0, memory = 0, alarms = 0;
84     RRDSET *st;
85
86     buffer_sprintf(wb, "{\n"
87            "\t\"hostname\": \"%s\""
88         ",\n\t\"update_every\": %d"
89         ",\n\t\"history\": %d"
90         ",\n\t\"charts\": {"
91         , localhost.hostname
92         , rrd_update_every
93         , rrd_default_history_entries
94         );
95
96     pthread_rwlock_rdlock(&localhost.rrdset_root_rwlock);
97     for(st = localhost.rrdset_root, c = 0; st ; st = st->next) {
98         if(st->enabled && st->dimensions) {
99             if(c) buffer_strcat(wb, ",");
100             buffer_strcat(wb, "\n\t\t\"");
101             buffer_strcat(wb, st->id);
102             buffer_strcat(wb, "\": ");
103             rrd_stats_api_v1_chart_with_data(st, wb, &dimensions, &memory);
104             c++;
105         }
106     }
107
108     RRDCALC *rc;
109     for(rc = localhost.alarms; rc ; rc = rc->next) {
110         if(rc->rrdset)
111             alarms++;
112     }
113     pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
114
115     buffer_sprintf(wb, "\n\t}"
116                     ",\n\t\"charts_count\": %zu"
117                     ",\n\t\"dimensions_count\": %zu"
118                     ",\n\t\"alarms_count\": %zu"
119                     ",\n\t\"rrd_memory_bytes\": %zu"
120                     "\n}\n"
121                    , c
122                    , dimensions
123                    , alarms
124                    , memory
125     );
126 }
127
128 // ----------------------------------------------------------------------------
129 // PROMETHEUS
130 // /api/v1/allmetrics?format=prometheus
131
132 static inline size_t prometheus_name_copy(char *d, const char *s, size_t usable) {
133     size_t n;
134
135     for(n = 0; *s && n < usable ; d++, s++, n++) {
136         register char c = *s;
137
138         if(unlikely(!isalnum(c))) *d = '_';
139         else *d = c;
140     }
141     *d = '\0';
142
143     return n;
144 }
145
146 #define PROMETHEUS_ELEMENT_MAX 256
147
148 void rrd_stats_api_v1_charts_allmetrics_prometheus(BUFFER *wb)
149 {
150     pthread_rwlock_rdlock(&localhost.rrdset_root_rwlock);
151
152     char host[PROMETHEUS_ELEMENT_MAX + 1];
153     prometheus_name_copy(host, config_get("global", "hostname", "localhost"), PROMETHEUS_ELEMENT_MAX);
154
155     // for each chart
156     RRDSET *st;
157     for(st = localhost.rrdset_root; st ; st = st->next) {
158         char chart[PROMETHEUS_ELEMENT_MAX + 1];
159         prometheus_name_copy(chart, st->id, PROMETHEUS_ELEMENT_MAX);
160
161         buffer_strcat(wb, "\n");
162         if(st->enabled && st->dimensions) {
163             pthread_rwlock_rdlock(&st->rwlock);
164
165             // for each dimension
166             RRDDIM *rd;
167             for(rd = st->dimensions; rd ; rd = rd->next) {
168                 if(rd->counter) {
169                     char dimension[PROMETHEUS_ELEMENT_MAX + 1];
170                     prometheus_name_copy(dimension, rd->id, PROMETHEUS_ELEMENT_MAX);
171
172                     // buffer_sprintf(wb, "# HELP %s.%s %s\n", st->id, rd->id, st->units);
173
174                     switch(rd->algorithm) {
175                         case RRDDIM_INCREMENTAL:
176                         case RRDDIM_PCENT_OVER_DIFF_TOTAL:
177                             buffer_sprintf(wb, "# TYPE %s_%s counter\n", chart, dimension);
178                             break;
179
180                         default:
181                             buffer_sprintf(wb, "# TYPE %s_%s gauge\n", chart, dimension);
182                             break;
183                     }
184
185                     // calculated_number n = (calculated_number)rd->last_collected_value * (calculated_number)(abs(rd->multiplier)) / (calculated_number)(abs(rd->divisor));
186                     // buffer_sprintf(wb, "%s.%s " CALCULATED_NUMBER_FORMAT " %llu\n", st->id, rd->id, n,
187                     //        (unsigned long long)((rd->last_collected_time.tv_sec * 1000) + (rd->last_collected_time.tv_usec / 1000)));
188
189                     buffer_sprintf(wb, "%s_%s{instance=\"%s\"} " COLLECTED_NUMBER_FORMAT " %llu\n",
190                             chart, dimension, host, rd->last_collected_value,
191                             (unsigned long long)((rd->last_collected_time.tv_sec * 1000) + (rd->last_collected_time.tv_usec / 1000)));
192
193                 }
194             }
195
196             pthread_rwlock_unlock(&st->rwlock);
197         }
198     }
199
200     pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
201 }
202
203 // ----------------------------------------------------------------------------
204 // BASH
205 // /api/v1/allmetrics?format=bash
206
207 static inline size_t shell_name_copy(char *d, const char *s, size_t usable) {
208     size_t n;
209
210     for(n = 0; *s && n < usable ; d++, s++, n++) {
211         register char c = *s;
212
213         if(unlikely(!isalnum(c))) *d = '_';
214         else *d = (char)toupper(c);
215     }
216     *d = '\0';
217
218     return n;
219 }
220
221 #define SHELL_ELEMENT_MAX 100
222
223 void rrd_stats_api_v1_charts_allmetrics_shell(BUFFER *wb)
224 {
225     pthread_rwlock_rdlock(&localhost.rrdset_root_rwlock);
226
227     char host[SHELL_ELEMENT_MAX + 1];
228     shell_name_copy(host, config_get("global", "hostname", "localhost"), SHELL_ELEMENT_MAX);
229
230     // for each chart
231     RRDSET *st;
232     for(st = localhost.rrdset_root; st ; st = st->next) {
233         calculated_number total = 0.0;
234         char chart[SHELL_ELEMENT_MAX + 1];
235         shell_name_copy(chart, st->id, SHELL_ELEMENT_MAX);
236
237         buffer_sprintf(wb, "\n# chart: %s (name: %s)\n", st->id, st->name);
238         if(st->enabled && st->dimensions) {
239             pthread_rwlock_rdlock(&st->rwlock);
240
241             // for each dimension
242             RRDDIM *rd;
243             for(rd = st->dimensions; rd ; rd = rd->next) {
244                 if(rd->counter) {
245                     char dimension[SHELL_ELEMENT_MAX + 1];
246                     shell_name_copy(dimension, rd->id, SHELL_ELEMENT_MAX);
247
248                     calculated_number n = rd->last_stored_value;
249
250                     if(isnan(n) || isinf(n))
251                         buffer_sprintf(wb, "NETDATA_%s_%s=\"\"      # %s\n", chart, dimension, st->units);
252                     else {
253                         if(rd->multiplier < 0 || rd->divisor < 0) n = -n;
254                         n = roundl(n);
255                         if(!(rd->flags & RRDDIM_FLAG_HIDDEN)) total += n;
256                         buffer_sprintf(wb, "NETDATA_%s_%s=\"%0.0Lf\"      # %s\n", chart, dimension, n, st->units);
257                     }
258                 }
259             }
260
261             total = roundl(total);
262             buffer_sprintf(wb, "NETDATA_%s_VISIBLETOTAL=\"%0.0Lf\"      # %s\n", chart, total, st->units);
263             pthread_rwlock_unlock(&st->rwlock);
264         }
265     }
266
267     buffer_strcat(wb, "\n# NETDATA ALARMS RUNNING\n");
268
269     RRDCALC *rc;
270     for(rc = localhost.alarms; rc ;rc = rc->next) {
271         if(!rc->rrdset) continue;
272
273         char chart[SHELL_ELEMENT_MAX + 1];
274         shell_name_copy(chart, rc->rrdset->id, SHELL_ELEMENT_MAX);
275
276         char alarm[SHELL_ELEMENT_MAX + 1];
277         shell_name_copy(alarm, rc->name, SHELL_ELEMENT_MAX);
278
279         calculated_number n = rc->value;
280
281         if(isnan(n) || isinf(n))
282             buffer_sprintf(wb, "NETDATA_ALARM_%s_%s_VALUE=\"\"      # %s\n", chart, alarm, rc->units);
283         else {
284             n = roundl(n);
285             buffer_sprintf(wb, "NETDATA_ALARM_%s_%s_VALUE=\"%0.0Lf\"      # %s\n", chart, alarm, n, rc->units);
286         }
287
288         buffer_sprintf(wb, "NETDATA_ALARM_%s_%s_STATUS=\"%s\"\n", chart, alarm, rrdcalc_status2string(rc->status));
289     }
290
291     pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
292 }
293
294 // ----------------------------------------------------------------------------
295
296 unsigned long rrd_stats_one_json(RRDSET *st, char *options, BUFFER *wb)
297 {
298     time_t now = now_realtime_sec();
299
300     pthread_rwlock_rdlock(&st->rwlock);
301
302     buffer_sprintf(wb,
303         "\t\t{\n"
304         "\t\t\t\"id\": \"%s\",\n"
305         "\t\t\t\"name\": \"%s\",\n"
306         "\t\t\t\"type\": \"%s\",\n"
307         "\t\t\t\"family\": \"%s\",\n"
308         "\t\t\t\"context\": \"%s\",\n"
309         "\t\t\t\"title\": \"%s\",\n"
310         "\t\t\t\"priority\": %ld,\n"
311         "\t\t\t\"enabled\": %d,\n"
312         "\t\t\t\"units\": \"%s\",\n"
313         "\t\t\t\"url\": \"/data/%s/%s\",\n"
314         "\t\t\t\"chart_type\": \"%s\",\n"
315         "\t\t\t\"counter\": %lu,\n"
316         "\t\t\t\"entries\": %ld,\n"
317         "\t\t\t\"first_entry_t\": %ld,\n"
318         "\t\t\t\"last_entry\": %lu,\n"
319         "\t\t\t\"last_entry_t\": %ld,\n"
320         "\t\t\t\"last_entry_secs_ago\": %ld,\n"
321         "\t\t\t\"update_every\": %d,\n"
322         "\t\t\t\"isdetail\": %d,\n"
323         "\t\t\t\"usec_since_last_update\": %llu,\n"
324         "\t\t\t\"collected_total\": " TOTAL_NUMBER_FORMAT ",\n"
325         "\t\t\t\"last_collected_total\": " TOTAL_NUMBER_FORMAT ",\n"
326         "\t\t\t\"dimensions\": [\n"
327         , st->id
328         , st->name
329         , st->type
330         , st->family
331         , st->context
332         , st->title
333         , st->priority
334         , st->enabled
335         , st->units
336         , st->name, options?options:""
337         , rrdset_type_name(st->chart_type)
338         , st->counter
339         , st->entries
340         , rrdset_first_entry_t(st)
341         , rrdset_last_slot(st)
342         , rrdset_last_entry_t(st)
343         , (now < rrdset_last_entry_t(st)) ? (time_t)0 : now - rrdset_last_entry_t(st)
344         , st->update_every
345         , st->isdetail
346         , st->usec_since_last_update
347         , st->collected_total
348         , st->last_collected_total
349         );
350
351     unsigned long memory = st->memsize;
352
353     RRDDIM *rd;
354     for(rd = st->dimensions; rd ; rd = rd->next) {
355
356         memory += rd->memsize;
357
358         buffer_sprintf(wb,
359             "\t\t\t\t{\n"
360             "\t\t\t\t\t\"id\": \"%s\",\n"
361             "\t\t\t\t\t\"name\": \"%s\",\n"
362             "\t\t\t\t\t\"entries\": %ld,\n"
363             "\t\t\t\t\t\"isHidden\": %d,\n"
364             "\t\t\t\t\t\"algorithm\": \"%s\",\n"
365             "\t\t\t\t\t\"multiplier\": %ld,\n"
366             "\t\t\t\t\t\"divisor\": %ld,\n"
367             "\t\t\t\t\t\"last_entry_t\": %ld,\n"
368             "\t\t\t\t\t\"collected_value\": " COLLECTED_NUMBER_FORMAT ",\n"
369             "\t\t\t\t\t\"calculated_value\": " CALCULATED_NUMBER_FORMAT ",\n"
370             "\t\t\t\t\t\"last_collected_value\": " COLLECTED_NUMBER_FORMAT ",\n"
371             "\t\t\t\t\t\"last_calculated_value\": " CALCULATED_NUMBER_FORMAT ",\n"
372             "\t\t\t\t\t\"memory\": %lu\n"
373             "\t\t\t\t}%s\n"
374             , rd->id
375             , rd->name
376             , rd->entries
377             , (rd->flags & RRDDIM_FLAG_HIDDEN)?1:0
378             , rrddim_algorithm_name(rd->algorithm)
379             , rd->multiplier
380             , rd->divisor
381             , rd->last_collected_time.tv_sec
382             , rd->collected_value
383             , rd->calculated_value
384             , rd->last_collected_value
385             , rd->last_calculated_value
386             , rd->memsize
387             , rd->next?",":""
388             );
389     }
390
391     buffer_sprintf(wb,
392         "\t\t\t],\n"
393         "\t\t\t\"memory\" : %lu\n"
394         "\t\t}"
395         , memory
396         );
397
398     pthread_rwlock_unlock(&st->rwlock);
399     return memory;
400 }
401
402 #define RRD_GRAPH_JSON_HEADER "{\n\t\"charts\": [\n"
403 #define RRD_GRAPH_JSON_FOOTER "\n\t]\n}\n"
404
405 void rrd_stats_graph_json(RRDSET *st, char *options, BUFFER *wb)
406 {
407     buffer_strcat(wb, RRD_GRAPH_JSON_HEADER);
408     rrd_stats_one_json(st, options, wb);
409     buffer_strcat(wb, RRD_GRAPH_JSON_FOOTER);
410 }
411
412 void rrd_stats_all_json(BUFFER *wb)
413 {
414     unsigned long memory = 0;
415     long c;
416     RRDSET *st;
417
418     buffer_strcat(wb, RRD_GRAPH_JSON_HEADER);
419
420     pthread_rwlock_rdlock(&localhost.rrdset_root_rwlock);
421     for(st = localhost.rrdset_root, c = 0; st ; st = st->next) {
422         if(st->enabled && st->dimensions) {
423             if(c) buffer_strcat(wb, ",\n");
424             memory += rrd_stats_one_json(st, NULL, wb);
425             c++;
426         }
427     }
428     pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
429
430     buffer_sprintf(wb, "\n\t],\n"
431         "\t\"hostname\": \"%s\",\n"
432         "\t\"update_every\": %d,\n"
433         "\t\"history\": %d,\n"
434         "\t\"memory\": %lu\n"
435         "}\n"
436         , localhost.hostname
437         , rrd_update_every
438         , rrd_default_history_entries
439         , memory
440         );
441 }
442
443
444
445 // ----------------------------------------------------------------------------
446
447 // RRDR dimension options
448 #define RRDR_EMPTY      0x01 // the dimension contains / the value is empty (null)
449 #define RRDR_RESET      0x02 // the dimension contains / the value is reset
450 #define RRDR_HIDDEN     0x04 // the dimension contains / the value is hidden
451 #define RRDR_NONZERO    0x08 // the dimension contains / the value is non-zero
452 #define RRDR_SELECTED   0x10 // the dimension is selected
453
454 // RRDR result options
455 #define RRDR_RESULT_OPTION_ABSOLUTE 0x00000001
456 #define RRDR_RESULT_OPTION_RELATIVE 0x00000002
457
458 typedef struct rrdresult {
459     RRDSET *st;         // the chart this result refers to
460
461     uint32_t result_options;    // RRDR_RESULT_OPTION_*
462
463     int d;                  // the number of dimensions
464     long n;                 // the number of values in the arrays
465     long rows;              // the number of rows used
466
467     uint8_t *od;            // the options for the dimensions
468
469     time_t *t;              // array of n timestamps
470     calculated_number *v;   // array n x d values
471     uint8_t *o;             // array n x d options
472
473     long c;                 // current line ( -1 ~ n ), ( -1 = none, use rrdr_rows() to get number of rows )
474
475     long group;             // how many collected values were grouped for each row
476     int update_every;       // what is the suggested update frequency in seconds
477
478     calculated_number min;
479     calculated_number max;
480
481     time_t before;
482     time_t after;
483
484     int has_st_lock;        // if st is read locked by us
485 } RRDR;
486
487 #define rrdr_rows(r) ((r)->rows)
488
489 /*
490 static void rrdr_dump(RRDR *r)
491 {
492     long c, i;
493     RRDDIM *d;
494
495     fprintf(stderr, "\nCHART %s (%s)\n", r->st->id, r->st->name);
496
497     for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
498         fprintf(stderr, "DIMENSION %s (%s), %s%s%s%s\n"
499                 , d->id
500                 , d->name
501                 , (r->od[c] & RRDR_EMPTY)?"EMPTY ":""
502                 , (r->od[c] & RRDR_RESET)?"RESET ":""
503                 , (r->od[c] & RRDR_HIDDEN)?"HIDDEN ":""
504                 , (r->od[c] & RRDR_NONZERO)?"NONZERO ":""
505                 );
506     }
507
508     if(r->rows <= 0) {
509         fprintf(stderr, "RRDR does not have any values in it.\n");
510         return;
511     }
512
513     fprintf(stderr, "RRDR includes %d values in it:\n", r->rows);
514
515     // for each line in the array
516     for(i = 0; i < r->rows ;i++) {
517         calculated_number *cn = &r->v[ i * r->d ];
518         uint8_t *co = &r->o[ i * r->d ];
519
520         // print the id and the timestamp of the line
521         fprintf(stderr, "%ld %ld ", i + 1, r->t[i]);
522
523         // for each dimension
524         for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
525             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
526             if(unlikely(!(r->od[c] & RRDR_NONZERO))) continue;
527
528             if(co[c] & RRDR_EMPTY)
529                 fprintf(stderr, "null ");
530             else
531                 fprintf(stderr, CALCULATED_NUMBER_FORMAT " %s%s%s%s "
532                     , cn[c]
533                     , (co[c] & RRDR_EMPTY)?"E":" "
534                     , (co[c] & RRDR_RESET)?"R":" "
535                     , (co[c] & RRDR_HIDDEN)?"H":" "
536                     , (co[c] & RRDR_NONZERO)?"N":" "
537                     );
538         }
539
540         fprintf(stderr, "\n");
541     }
542 }
543 */
544
545 void rrdr_disable_not_selected_dimensions(RRDR *r, uint32_t options, const char *dims)
546 {
547     if(unlikely(!dims || !*dims)) return;
548
549     char b[strlen(dims) + 1];
550     char *o = b, *tok;
551     strcpy(o, dims);
552
553     long c, dims_selected = 0, dims_not_hidden_not_zero = 0;
554     RRDDIM *d;
555
556     // disable all of them
557     for(c = 0, d = r->st->dimensions; d ;c++, d = d->next)
558         r->od[c] |= RRDR_HIDDEN;
559
560     while(o && *o && (tok = mystrsep(&o, ",|"))) {
561         if(!*tok) continue;
562         
563         uint32_t hash = simple_hash(tok);
564
565         // find it and enable it
566         for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
567             if(unlikely((hash == d->hash && !strcmp(d->id, tok)) || !strcmp(d->name, tok))) {
568
569                 if(likely(r->od[c] & RRDR_HIDDEN)) {
570                     r->od[c] |= RRDR_SELECTED;
571                     r->od[c] &= ~RRDR_HIDDEN;
572                     dims_selected++;
573                 }
574
575                 // since the user needs this dimension
576                 // make it appear as NONZERO, to return it
577                 // even if the dimension has only zeros
578                 // unless option non_zero is set
579                 if(likely(!(options & RRDR_OPTION_NONZERO)))
580                     r->od[c] |= RRDR_NONZERO;
581
582                 // count the visible dimensions
583                 if(likely(r->od[c] & RRDR_NONZERO))
584                     dims_not_hidden_not_zero++;
585             }
586         }
587     }
588
589     // check if all dimensions are hidden
590     if(unlikely(!dims_not_hidden_not_zero && dims_selected)) {
591         // there are a few selected dimensions
592         // but they are all zero
593         // enable the selected ones
594         // to avoid returning an empty chart
595         for(c = 0, d = r->st->dimensions; d ;c++, d = d->next)
596             if(unlikely(r->od[c] & RRDR_SELECTED))
597                 r->od[c] |= RRDR_NONZERO;
598     }
599 }
600
601 void rrdr_buffer_print_format(BUFFER *wb, uint32_t format)
602 {
603     switch(format) {
604     case DATASOURCE_JSON:
605         buffer_strcat(wb, DATASOURCE_FORMAT_JSON);
606         break;
607
608     case DATASOURCE_DATATABLE_JSON:
609         buffer_strcat(wb, DATASOURCE_FORMAT_DATATABLE_JSON);
610         break;
611
612     case DATASOURCE_DATATABLE_JSONP:
613         buffer_strcat(wb, DATASOURCE_FORMAT_DATATABLE_JSONP);
614         break;
615
616     case DATASOURCE_JSONP:
617         buffer_strcat(wb, DATASOURCE_FORMAT_JSONP);
618         break;
619
620     case DATASOURCE_SSV:
621         buffer_strcat(wb, DATASOURCE_FORMAT_SSV);
622         break;
623
624     case DATASOURCE_CSV:
625         buffer_strcat(wb, DATASOURCE_FORMAT_CSV);
626         break;
627
628     case DATASOURCE_TSV:
629         buffer_strcat(wb, DATASOURCE_FORMAT_TSV);
630         break;
631
632     case DATASOURCE_HTML:
633         buffer_strcat(wb, DATASOURCE_FORMAT_HTML);
634         break;
635
636     case DATASOURCE_JS_ARRAY:
637         buffer_strcat(wb, DATASOURCE_FORMAT_JS_ARRAY);
638         break;
639
640     case DATASOURCE_SSV_COMMA:
641         buffer_strcat(wb, DATASOURCE_FORMAT_SSV_COMMA);
642         break;
643
644     default:
645         buffer_strcat(wb, "unknown");
646         break;
647     }
648 }
649
650 uint32_t rrdr_check_options(RRDR *r, uint32_t options, const char *dims)
651 {
652     (void)dims;
653
654     if(options & RRDR_OPTION_NONZERO) {
655         long i;
656
657         // commented due to #1514
658
659         //if(dims && *dims) {
660             // the caller wants specific dimensions
661             // disable NONZERO option
662             // to make sure we don't accidentally prevent
663             // the specific dimensions from being returned
664             // i = 0;
665         //}
666         //else {
667             // find how many dimensions are not zero
668             long c;
669             RRDDIM *rd;
670             for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ; c++, rd = rd->next) {
671                 if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
672                 if(unlikely(!(r->od[c] & RRDR_NONZERO))) continue;
673                 i++;
674             }
675         //}
676
677         // if with nonzero we get i = 0 (no dimensions will be returned)
678         // disable nonzero to show all dimensions
679         if(!i) options &= ~RRDR_OPTION_NONZERO;
680     }
681
682     return options;
683 }
684
685 void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t options, int string_value)
686 {
687     long rows = rrdr_rows(r);
688     long c, i;
689     RRDDIM *rd;
690
691     //info("JSONWRAPPER(): %s: BEGIN", r->st->id);
692     char kq[2] = "",                    // key quote
693         sq[2] = "";                     // string quote
694
695     if( options & RRDR_OPTION_GOOGLE_JSON ) {
696         kq[0] = '\0';
697         sq[0] = '\'';
698     }
699     else {
700         kq[0] = '"';
701         sq[0] = '"';
702     }
703
704     buffer_sprintf(wb, "{\n"
705             "   %sapi%s: 1,\n"
706             "   %sid%s: %s%s%s,\n"
707             "   %sname%s: %s%s%s,\n"
708             "   %sview_update_every%s: %d,\n"
709             "   %supdate_every%s: %d,\n"
710             "   %sfirst_entry%s: %u,\n"
711             "   %slast_entry%s: %u,\n"
712             "   %sbefore%s: %u,\n"
713             "   %safter%s: %u,\n"
714             "   %sdimension_names%s: ["
715             , kq, kq
716             , kq, kq, sq, r->st->id, sq
717             , kq, kq, sq, r->st->name, sq
718             , kq, kq, r->update_every
719             , kq, kq, r->st->update_every
720             , kq, kq, (uint32_t)rrdset_first_entry_t(r->st)
721             , kq, kq, (uint32_t)rrdset_last_entry_t(r->st)
722             , kq, kq, (uint32_t)r->before
723             , kq, kq, (uint32_t)r->after
724             , kq, kq);
725
726     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
727         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
728         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
729
730         if(i) buffer_strcat(wb, ", ");
731         buffer_strcat(wb, sq);
732         buffer_strcat(wb, rd->name);
733         buffer_strcat(wb, sq);
734         i++;
735     }
736     if(!i) {
737 #ifdef NETDATA_INTERNAL_CHECKS
738         error("RRDR is empty for %s (RRDR has %d dimensions, options is 0x%08x)", r->st->id, r->d, options);
739 #endif
740         rows = 0;
741         buffer_strcat(wb, sq);
742         buffer_strcat(wb, "no data");
743         buffer_strcat(wb, sq);
744     }
745
746     buffer_sprintf(wb, "],\n"
747             "   %sdimension_ids%s: ["
748             , kq, kq);
749
750     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
751         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
752         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
753
754         if(i) buffer_strcat(wb, ", ");
755         buffer_strcat(wb, sq);
756         buffer_strcat(wb, rd->id);
757         buffer_strcat(wb, sq);
758         i++;
759     }
760     if(!i) {
761         rows = 0;
762         buffer_strcat(wb, sq);
763         buffer_strcat(wb, "no data");
764         buffer_strcat(wb, sq);
765     }
766
767     buffer_sprintf(wb, "],\n"
768             "   %slatest_values%s: ["
769             , kq, kq);
770
771     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
772         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
773         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
774
775         if(i) buffer_strcat(wb, ", ");
776         i++;
777
778         storage_number n = rd->values[rrdset_last_slot(r->st)];
779
780         if(!does_storage_number_exist(n))
781             buffer_strcat(wb, "null");
782         else
783             buffer_rrd_value(wb, unpack_storage_number(n));
784     }
785     if(!i) {
786         rows = 0;
787         buffer_strcat(wb, "null");
788     }
789
790     buffer_sprintf(wb, "],\n"
791             "   %sview_latest_values%s: ["
792             , kq, kq);
793
794     i = 0;
795     if(rows) {
796         for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
797             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
798             if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
799
800             if(i) buffer_strcat(wb, ", ");
801             i++;
802
803             calculated_number *cn = &r->v[ (0) * r->d ];
804             uint8_t *co = &r->o[ (0) * r->d ];
805
806             if(co[c] & RRDR_EMPTY)
807                 buffer_strcat(wb, "null");
808             else
809                 buffer_rrd_value(wb, cn[c]);
810         }
811     }
812     if(!i) {
813         rows = 0;
814         buffer_strcat(wb, "null");
815     }
816
817     buffer_sprintf(wb, "],\n"
818             "   %sdimensions%s: %ld,\n"
819             "   %spoints%s: %ld,\n"
820             "   %sformat%s: %s"
821             , kq, kq, i
822             , kq, kq, rows
823             , kq, kq, sq
824             );
825
826     rrdr_buffer_print_format(wb, format);
827
828     buffer_sprintf(wb, "%s,\n"
829             "   %sresult%s: "
830             , sq
831             , kq, kq
832             );
833
834     if(string_value) buffer_strcat(wb, sq);
835     //info("JSONWRAPPER(): %s: END", r->st->id);
836 }
837
838 void rrdr_json_wrapper_end(RRDR *r, BUFFER *wb, uint32_t format, uint32_t options, int string_value)
839 {
840     (void)format;
841
842     char kq[2] = "",                    // key quote
843         sq[2] = "";                     // string quote
844
845     if( options & RRDR_OPTION_GOOGLE_JSON ) {
846         kq[0] = '\0';
847         sq[0] = '\'';
848     }
849     else {
850         kq[0] = '"';
851         sq[0] = '"';
852     }
853
854     if(string_value) buffer_strcat(wb, sq);
855
856     buffer_sprintf(wb, ",\n %smin%s: ", kq, kq);
857     buffer_rrd_value(wb, r->min);
858     buffer_sprintf(wb, ",\n %smax%s: ", kq, kq);
859     buffer_rrd_value(wb, r->max);
860     buffer_strcat(wb, "\n}\n");
861 }
862
863 #define JSON_DATES_JS 1
864 #define JSON_DATES_TIMESTAMP 2
865
866 static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
867 {
868     //info("RRD2JSON(): %s: BEGIN", r->st->id);
869     int row_annotations = 0, dates, dates_with_new = 0;
870     char kq[2] = "",                    // key quote
871         sq[2] = "",                     // string quote
872         pre_label[101] = "",            // before each label
873         post_label[101] = "",           // after each label
874         pre_date[101] = "",             // the beginning of line, to the date
875         post_date[101] = "",            // closing the date
876         pre_value[101] = "",            // before each value
877         post_value[101] = "",           // after each value
878         post_line[101] = "",            // at the end of each row
879         normal_annotation[201] = "",    // default row annotation
880         overflow_annotation[201] = "",  // overflow row annotation
881         data_begin[101] = "",           // between labels and values
882         finish[101] = "";               // at the end of everything
883
884     if(datatable) {
885         dates = JSON_DATES_JS;
886         if( options & RRDR_OPTION_GOOGLE_JSON ) {
887             kq[0] = '\0';
888             sq[0] = '\'';
889         }
890         else {
891             kq[0] = '"';
892             sq[0] = '"';
893         }
894         row_annotations = 1;
895         snprintfz(pre_date,   100, "        {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
896         snprintfz(post_date,  100, "%s}", sq);
897         snprintfz(pre_label,  100, ",\n     {%sid%s:%s%s,%slabel%s:%s", kq, kq, sq, sq, kq, kq, sq);
898         snprintfz(post_label, 100, "%s,%spattern%s:%s%s,%stype%s:%snumber%s}", sq, kq, kq, sq, sq, kq, kq, sq, sq);
899         snprintfz(pre_value,  100, ",{%sv%s:", kq, kq);
900         strcpy(post_value,         "}");
901         strcpy(post_line,          "]}");
902         snprintfz(data_begin, 100, "\n  ],\n    %srows%s:\n [\n", kq, kq);
903         strcpy(finish,             "\n  ]\n}");
904
905         snprintfz(overflow_annotation, 200, ",{%sv%s:%sRESET OR OVERFLOW%s},{%sv%s:%sThe counters have been wrapped.%s}", kq, kq, sq, sq, kq, kq, sq, sq);
906         snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
907
908         buffer_sprintf(wb, "{\n %scols%s:\n [\n", kq, kq);
909         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%stime%s,%spattern%s:%s%s,%stype%s:%sdatetime%s},\n", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq);
910         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%s%s,%spattern%s:%s%s,%stype%s:%sstring%s,%sp%s:{%srole%s:%sannotation%s}},\n", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, kq, kq, sq, sq);
911         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%s%s,%spattern%s:%s%s,%stype%s:%sstring%s,%sp%s:{%srole%s:%sannotationText%s}}", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, kq, kq, sq, sq);
912
913         // remove the valueobjects flag
914         // google wants its own keys
915         if(options & RRDR_OPTION_OBJECTSROWS)
916             options &= ~RRDR_OPTION_OBJECTSROWS;
917     }
918     else {
919         kq[0] = '"';
920         sq[0] = '"';
921         if(options & RRDR_OPTION_GOOGLE_JSON) {
922             dates = JSON_DATES_JS;
923             dates_with_new = 1;
924         }
925         else {
926             dates = JSON_DATES_TIMESTAMP;
927             dates_with_new = 0;
928         }
929         if( options & RRDR_OPTION_OBJECTSROWS )
930             strcpy(pre_date, "      { ");
931         else
932             strcpy(pre_date, "      [ ");
933         strcpy(pre_label,  ", \"");
934         strcpy(post_label, "\"");
935         strcpy(pre_value,  ", ");
936         if( options & RRDR_OPTION_OBJECTSROWS )
937             strcpy(post_line, "}");
938         else
939             strcpy(post_line, "]");
940         snprintfz(data_begin, 100, "],\n    %sdata%s:\n [\n", kq, kq);
941         strcpy(finish,             "\n  ]\n}");
942
943         buffer_sprintf(wb, "{\n %slabels%s: [", kq, kq);
944         buffer_sprintf(wb, "%stime%s", sq, sq);
945     }
946
947     // -------------------------------------------------------------------------
948     // print the JSON header
949
950     long c, i;
951     RRDDIM *rd;
952
953     // print the header lines
954     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
955         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
956         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
957
958         buffer_strcat(wb, pre_label);
959         buffer_strcat(wb, rd->name);
960         buffer_strcat(wb, post_label);
961         i++;
962     }
963     if(!i) {
964         buffer_strcat(wb, pre_label);
965         buffer_strcat(wb, "no data");
966         buffer_strcat(wb, post_label);
967     }
968
969     // print the begin of row data
970     buffer_strcat(wb, data_begin);
971
972     // if all dimensions are hidden, print a null
973     if(!i) {
974         buffer_strcat(wb, finish);
975         return;
976     }
977
978     long start = 0, end = rrdr_rows(r), step = 1;
979     if((options & RRDR_OPTION_REVERSED)) {
980         start = rrdr_rows(r) - 1;
981         end = -1;
982         step = -1;
983     }
984
985     // for each line in the array
986     calculated_number total = 1;
987     for(i = start; i != end ;i += step) {
988         calculated_number *cn = &r->v[ i * r->d ];
989         uint8_t *co = &r->o[ i * r->d ];
990
991         time_t now = r->t[i];
992
993         if(dates == JSON_DATES_JS) {
994             // generate the local date time
995             struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
996             if(!tm) { error("localtime_r() failed."); continue; }
997
998             if(likely(i != start)) buffer_strcat(wb, ",\n");
999             buffer_strcat(wb, pre_date);
1000
1001             if( options & RRDR_OPTION_OBJECTSROWS )
1002                 buffer_sprintf(wb, "%stime%s: ", kq, kq);
1003
1004             if(dates_with_new)
1005                 buffer_strcat(wb, "new ");
1006
1007             buffer_jsdate(wb, tm->tm_year + 1900, tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
1008
1009             buffer_strcat(wb, post_date);
1010
1011             if(row_annotations) {
1012                 // google supports one annotation per row
1013                 int annotation_found = 0;
1014                 for(c = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
1015                     if(co[c] & RRDR_RESET) {
1016                         buffer_strcat(wb, overflow_annotation);
1017                         annotation_found = 1;
1018                         break;
1019                     }
1020                 }
1021                 if(!annotation_found)
1022                     buffer_strcat(wb, normal_annotation);
1023             }
1024         }
1025         else {
1026             // print the timestamp of the line
1027             if(likely(i != start)) buffer_strcat(wb, ",\n");
1028             buffer_strcat(wb, pre_date);
1029
1030             if( options & RRDR_OPTION_OBJECTSROWS )
1031                 buffer_sprintf(wb, "%stime%s: ", kq, kq);
1032
1033             buffer_rrd_value(wb, (calculated_number)r->t[i]);
1034             // in ms
1035             if(options & RRDR_OPTION_MILLISECONDS) buffer_strcat(wb, "000");
1036
1037             buffer_strcat(wb, post_date);
1038         }
1039
1040         if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1041             total = 0;
1042             for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
1043                 calculated_number n = cn[c];
1044
1045                 if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1046                     n = -n;
1047
1048                 total += n;
1049             }
1050             // prevent a division by zero
1051             if(total == 0) total = 1;
1052         }
1053
1054         // for each dimension
1055         for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
1056             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1057             if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1058
1059             calculated_number n = cn[c];
1060
1061             buffer_strcat(wb, pre_value);
1062
1063             if( options & RRDR_OPTION_OBJECTSROWS )
1064                 buffer_sprintf(wb, "%s%s%s: ", kq, rd->name, kq);
1065
1066             if(co[c] & RRDR_EMPTY) {
1067                 if(options & RRDR_OPTION_NULL2ZERO)
1068                     buffer_strcat(wb, "0");
1069                 else
1070                     buffer_strcat(wb, "null");
1071             }
1072             else {
1073                 if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1074                     n = -n;
1075
1076                 if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1077                     n = n * 100 / total;
1078
1079                 buffer_rrd_value(wb, n);
1080             }
1081
1082             buffer_strcat(wb, post_value);
1083         }
1084
1085         buffer_strcat(wb, post_line);
1086     }
1087
1088     buffer_strcat(wb, finish);
1089     //info("RRD2JSON(): %s: END", r->st->id);
1090 }
1091
1092 static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startline, const char *separator, const char *endline, const char *betweenlines)
1093 {
1094     //info("RRD2CSV(): %s: BEGIN", r->st->id);
1095     long c, i;
1096     RRDDIM *d;
1097
1098     // print the csv header
1099     for(c = 0, i = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1100         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1101         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1102
1103         if(!i) {
1104             buffer_strcat(wb, startline);
1105             if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1106             buffer_strcat(wb, "time");
1107             if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1108         }
1109         buffer_strcat(wb, separator);
1110         if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1111         buffer_strcat(wb, d->name);
1112         if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1113         i++;
1114     }
1115     buffer_strcat(wb, endline);
1116
1117     if(!i) {
1118         // no dimensions present
1119         return;
1120     }
1121
1122     long start = 0, end = rrdr_rows(r), step = 1;
1123     if((options & RRDR_OPTION_REVERSED)) {
1124         start = rrdr_rows(r) - 1;
1125         end = -1;
1126         step = -1;
1127     }
1128
1129     // for each line in the array
1130     calculated_number total = 1;
1131     for(i = start; i != end ;i += step) {
1132         calculated_number *cn = &r->v[ i * r->d ];
1133         uint8_t *co = &r->o[ i * r->d ];
1134
1135         buffer_strcat(wb, betweenlines);
1136         buffer_strcat(wb, startline);
1137
1138         time_t now = r->t[i];
1139
1140         if((options & RRDR_OPTION_SECONDS) || (options & RRDR_OPTION_MILLISECONDS)) {
1141             // print the timestamp of the line
1142             buffer_rrd_value(wb, (calculated_number)now);
1143             // in ms
1144             if(options & RRDR_OPTION_MILLISECONDS) buffer_strcat(wb, "000");
1145         }
1146         else {
1147             // generate the local date time
1148             struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
1149             if(!tm) { error("localtime() failed."); continue; }
1150             buffer_date(wb, tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
1151         }
1152
1153         if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1154             total = 0;
1155             for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1156                 calculated_number n = cn[c];
1157
1158                 if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1159                     n = -n;
1160
1161                 total += n;
1162             }
1163             // prevent a division by zero
1164             if(total == 0) total = 1;
1165         }
1166
1167         // for each dimension
1168         for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1169             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1170             if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1171
1172             buffer_strcat(wb, separator);
1173
1174             calculated_number n = cn[c];
1175
1176             if(co[c] & RRDR_EMPTY) {
1177                 if(options & RRDR_OPTION_NULL2ZERO)
1178                     buffer_strcat(wb, "0");
1179                 else
1180                     buffer_strcat(wb, "null");
1181             }
1182             else {
1183                 if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1184                     n = -n;
1185
1186                 if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1187                     n = n * 100 / total;
1188
1189                 buffer_rrd_value(wb, n);
1190             }
1191         }
1192
1193         buffer_strcat(wb, endline);
1194     }
1195     //info("RRD2CSV(): %s: END", r->st->id);
1196 }
1197
1198 inline static calculated_number rrdr2value(RRDR *r, long i, uint32_t options, int *all_values_are_null) {
1199     long c;
1200     RRDDIM *d;
1201
1202     calculated_number *cn = &r->v[ i * r->d ];
1203     uint8_t *co = &r->o[ i * r->d ];
1204
1205     calculated_number sum = 0, min = 0, max = 0, v;
1206     int all_null = 1, init = 1;
1207
1208     calculated_number total = 1;
1209     if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1210         total = 0;
1211         for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1212             calculated_number n = cn[c];
1213
1214             if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1215                 n = -n;
1216
1217             total += n;
1218         }
1219         // prevent a division by zero
1220         if(total == 0) total = 1;
1221     }
1222
1223     // for each dimension
1224     for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1225         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1226         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1227
1228         calculated_number n = cn[c];
1229
1230         if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1231             n = -n;
1232
1233         if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1234             n = n * 100 / total;
1235
1236         if(unlikely(init)) {
1237             if(n > 0) {
1238                 min = 0;
1239                 max = n;
1240             }
1241             else {
1242                 min = n;
1243                 max = 0;
1244             }
1245             init = 0;
1246         }
1247
1248         if(likely(!(co[c] & RRDR_EMPTY))) {
1249             all_null = 0;
1250             sum += n;
1251         }
1252
1253         if(n < min) min = n;
1254         if(n > max) max = n;
1255     }
1256
1257     if(unlikely(all_null)) {
1258         if(likely(all_values_are_null))
1259             *all_values_are_null = 1;
1260         return 0;
1261     }
1262     else {
1263         if(likely(all_values_are_null))
1264             *all_values_are_null = 0;
1265     }
1266
1267     if(options & RRDR_OPTION_MIN2MAX)
1268         v = max - min;
1269     else
1270         v = sum;
1271
1272     return v;
1273 }
1274
1275 static void rrdr2ssv(RRDR *r, BUFFER *wb, uint32_t options, const char *prefix, const char *separator, const char *suffix)
1276 {
1277     //info("RRD2SSV(): %s: BEGIN", r->st->id);
1278     long i;
1279
1280     buffer_strcat(wb, prefix);
1281     long start = 0, end = rrdr_rows(r), step = 1;
1282     if((options & RRDR_OPTION_REVERSED)) {
1283         start = rrdr_rows(r) - 1;
1284         end = -1;
1285         step = -1;
1286     }
1287
1288     // for each line in the array
1289     for(i = start; i != end ;i += step) {
1290         int all_values_are_null = 0;
1291         calculated_number v = rrdr2value(r, i, options, &all_values_are_null);
1292
1293         if(likely(i != start)) {
1294             if(r->min > v) r->min = v;
1295             if(r->max < v) r->max = v;
1296         }
1297         else {
1298             r->min = v;
1299             r->max = v;
1300         }
1301
1302         if(likely(i != start))
1303             buffer_strcat(wb, separator);
1304
1305         if(all_values_are_null) {
1306             if(options & RRDR_OPTION_NULL2ZERO)
1307                 buffer_strcat(wb, "0");
1308             else
1309                 buffer_strcat(wb, "null");
1310         }
1311         else
1312             buffer_rrd_value(wb, v);
1313     }
1314     buffer_strcat(wb, suffix);
1315     //info("RRD2SSV(): %s: END", r->st->id);
1316 }
1317
1318 inline static calculated_number *rrdr_line_values(RRDR *r)
1319 {
1320     return &r->v[ r->c * r->d ];
1321 }
1322
1323 inline static uint8_t *rrdr_line_options(RRDR *r)
1324 {
1325     return &r->o[ r->c * r->d ];
1326 }
1327
1328 inline static int rrdr_line_init(RRDR *r, time_t t)
1329 {
1330     r->c++;
1331
1332     if(unlikely(r->c >= r->n)) {
1333         error("requested to step above RRDR size for chart %s", r->st->name);
1334         r->c = r->n - 1;
1335     }
1336
1337     // save the time
1338     r->t[r->c] = t;
1339
1340     return 1;
1341 }
1342
1343 inline static void rrdr_lock_rrdset(RRDR *r) {
1344     if(unlikely(!r)) {
1345         error("NULL value given!");
1346         return;
1347     }
1348
1349     pthread_rwlock_rdlock(&r->st->rwlock);
1350     r->has_st_lock = 1;
1351 }
1352
1353 inline static void rrdr_unlock_rrdset(RRDR *r) {
1354     if(unlikely(!r)) {
1355         error("NULL value given!");
1356         return;
1357     }
1358
1359     if(likely(r->has_st_lock)) {
1360         pthread_rwlock_unlock(&r->st->rwlock);
1361         r->has_st_lock = 0;
1362     }
1363 }
1364
1365 inline static void rrdr_free(RRDR *r)
1366 {
1367     if(unlikely(!r)) {
1368         error("NULL value given!");
1369         return;
1370     }
1371
1372     rrdr_unlock_rrdset(r);
1373     freez(r->t);
1374     freez(r->v);
1375     freez(r->o);
1376     freez(r->od);
1377     freez(r);
1378 }
1379
1380 static inline void rrdr_done(RRDR *r)
1381 {
1382     r->rows = r->c + 1;
1383     r->c = 0;
1384 }
1385
1386 static RRDR *rrdr_create(RRDSET *st, long n)
1387 {
1388     if(unlikely(!st)) {
1389         error("NULL value given!");
1390         return NULL;
1391     }
1392
1393     RRDR *r = callocz(1, sizeof(RRDR));
1394     r->st = st;
1395
1396     rrdr_lock_rrdset(r);
1397
1398     RRDDIM *rd;
1399     for(rd = st->dimensions ; rd ; rd = rd->next) r->d++;
1400
1401     r->n = n;
1402
1403     r->t = mallocz(n * sizeof(time_t));
1404     r->v = mallocz(n * r->d * sizeof(calculated_number));
1405     r->o = mallocz(n * r->d * sizeof(uint8_t));
1406     r->od = mallocz(r->d * sizeof(uint8_t));
1407
1408     // set the hidden flag on hidden dimensions
1409     int c;
1410     for(c = 0, rd = st->dimensions ; rd ; c++, rd = rd->next) {
1411         if(unlikely(rd->flags & RRDDIM_FLAG_HIDDEN)) r->od[c] = RRDR_HIDDEN;
1412         else r->od[c] = 0;
1413     }
1414
1415     r->c = -1;
1416     r->group = 1;
1417     r->update_every = 1;
1418
1419     return r;
1420 }
1421
1422 RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int group_method, int aligned)
1423 {
1424     int debug = st->debug;
1425     int absolute_period_requested = -1;
1426
1427     time_t first_entry_t = rrdset_first_entry_t(st);
1428     time_t last_entry_t  = rrdset_last_entry_t(st);
1429
1430     if(before == 0 && after == 0) {
1431         // dump the all the data
1432         before = last_entry_t;
1433         after = first_entry_t;
1434         absolute_period_requested = 0;
1435     }
1436
1437     // allow relative for before (smaller than API_RELATIVE_TIME_MAX)
1438     if(((before < 0)?-before:before) <= API_RELATIVE_TIME_MAX) {
1439         if(abs(before) % st->update_every) {
1440             // make sure it is multiple of st->update_every
1441             if(before < 0) before = before - st->update_every - before % st->update_every;
1442             else           before = before + st->update_every - before % st->update_every;
1443         }
1444         if(before > 0) before = first_entry_t + before;
1445         else           before = last_entry_t  + before;
1446         absolute_period_requested = 0;
1447     }
1448
1449     // allow relative for after (smaller than API_RELATIVE_TIME_MAX)
1450     if(((after < 0)?-after:after) <= API_RELATIVE_TIME_MAX) {
1451         if(after == 0) after = -st->update_every;
1452         if(abs(after) % st->update_every) {
1453             // make sure it is multiple of st->update_every
1454             if(after < 0) after = after - st->update_every - after % st->update_every;
1455             else          after = after + st->update_every - after % st->update_every;
1456         }
1457         after = before + after;
1458         absolute_period_requested = 0;
1459     }
1460
1461     if(absolute_period_requested == -1)
1462         absolute_period_requested = 1;
1463
1464     // make sure they are within our timeframe
1465     if(before > last_entry_t)  before = last_entry_t;
1466     if(before < first_entry_t) before = first_entry_t;
1467
1468     if(after > last_entry_t)  after = last_entry_t;
1469     if(after < first_entry_t) after = first_entry_t;
1470
1471     // check if they are upside down
1472     if(after > before) {
1473         time_t tmp = before;
1474         before = after;
1475         after = tmp;
1476     }
1477
1478     // the duration of the chart
1479     time_t duration = before - after;
1480     long available_points = duration / st->update_every;
1481
1482     if(duration <= 0 || available_points <= 0)
1483         return rrdr_create(st, 1);
1484
1485     // check the wanted points
1486     if(points < 0) points = -points;
1487     if(points > available_points) points = available_points;
1488     if(points == 0) points = available_points;
1489
1490     // calculate proper grouping of source data
1491     long group = available_points / points;
1492     if(group <= 0) group = 1;
1493
1494     // round group to the closest integer
1495     if(available_points % points > points / 2) group++;
1496
1497     time_t after_new  = (aligned) ? (after  - (after  % (group * st->update_every))) : after;
1498     time_t before_new = (aligned) ? (before - (before % (group * st->update_every))) : before;
1499     long points_new   = (before_new - after_new) / st->update_every / group;
1500
1501     // find the starting and ending slots in our round robin db
1502     long    start_at_slot = rrdset_time2slot(st, before_new),
1503             stop_at_slot  = rrdset_time2slot(st, after_new);
1504
1505 #ifdef NETDATA_INTERNAL_CHECKS
1506     if(after_new < first_entry_t) {
1507         error("after_new %u is too small, minimum %u", (uint32_t)after_new, (uint32_t)first_entry_t);
1508     }
1509     if(after_new > last_entry_t) {
1510         error("after_new %u is too big, maximum %u", (uint32_t)after_new, (uint32_t)last_entry_t);
1511     }
1512     if(before_new < first_entry_t) {
1513         error("before_new %u is too small, minimum %u", (uint32_t)before_new, (uint32_t)first_entry_t);
1514     }
1515     if(before_new > last_entry_t) {
1516         error("before_new %u is too big, maximum %u", (uint32_t)before_new, (uint32_t)last_entry_t);
1517     }
1518     if(start_at_slot < 0 || start_at_slot >= st->entries) {
1519         error("start_at_slot is invalid %ld, expected 0 to %ld", start_at_slot, st->entries - 1);
1520     }
1521     if(stop_at_slot < 0 || stop_at_slot >= st->entries) {
1522         error("stop_at_slot is invalid %ld, expected 0 to %ld", stop_at_slot, st->entries - 1);
1523     }
1524     if(points_new > (before_new - after_new) / group / st->update_every + 1) {
1525         error("points_new %ld is more than points %ld", points_new, (before_new - after_new) / group / st->update_every + 1);
1526     }
1527 #endif
1528
1529     //info("RRD2RRDR(): %s: wanted %ld points, got %ld - group=%ld, wanted duration=%u, got %u - wanted %ld - %ld, got %ld - %ld", st->id, points, points_new, group, before - after, before_new - after_new, after, before, after_new, before_new);
1530
1531     after = after_new;
1532     before = before_new;
1533     duration = before - after;
1534     points = points_new;
1535
1536     // Now we have:
1537     // before = the end time of the calculation
1538     // after = the start time of the calculation
1539     // duration = the duration of the calculation
1540     // group = the number of source points to aggregate / group together
1541     // method = the method of grouping source points
1542     // points = the number of points to generate
1543
1544
1545     // -------------------------------------------------------------------------
1546     // initialize our result set
1547
1548     RRDR *r = rrdr_create(st, points);
1549     if(!r) {
1550 #ifdef NETDATA_INTERNAL_CHECKS
1551         error("Cannot create RRDR for %s, after=%u, before=%u, duration=%u, points=%ld", st->id, (uint32_t)after, (uint32_t)before, (uint32_t)duration, points);
1552 #endif
1553         return NULL;
1554     }
1555     if(!r->d) {
1556 #ifdef NETDATA_INTERNAL_CHECKS
1557         error("Returning empty RRDR (no dimensions in RRDSET) for %s, after=%u, before=%u, duration=%u, points=%ld", st->id, (uint32_t)after, (uint32_t)before, (uint32_t)duration, points);
1558 #endif
1559         return r;
1560     }
1561
1562     if(absolute_period_requested == 1)
1563         r->result_options |= RRDR_RESULT_OPTION_ABSOLUTE;
1564     else
1565         r->result_options |= RRDR_RESULT_OPTION_RELATIVE;
1566
1567     // find how many dimensions we have
1568     long dimensions = r->d;
1569
1570
1571     // -------------------------------------------------------------------------
1572     // checks for debugging
1573
1574     if(debug) debug(D_RRD_STATS, "INFO %s first_t: %u, last_t: %u, all_duration: %u, after: %u, before: %u, duration: %u, points: %ld, group: %ld"
1575             , st->id
1576             , (uint32_t)first_entry_t
1577             , (uint32_t)last_entry_t
1578             , (uint32_t)(last_entry_t - first_entry_t)
1579             , (uint32_t)after
1580             , (uint32_t)before
1581             , (uint32_t)duration
1582             , points
1583             , group
1584             );
1585
1586
1587     // -------------------------------------------------------------------------
1588     // temp arrays for keeping values per dimension
1589
1590     calculated_number   last_values[dimensions]; // keep the last value of each dimension
1591     calculated_number   group_values[dimensions]; // keep sums when grouping
1592     long                group_counts[dimensions]; // keep the number of values added to group_values
1593     uint8_t             group_options[dimensions];
1594     uint8_t             found_non_zero[dimensions];
1595
1596
1597     // initialize them
1598     RRDDIM *rd;
1599     long c;
1600     for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1601         last_values[c] = 0;
1602         group_values[c] = (group_method == GROUP_MAX || group_method == GROUP_MIN)?NAN:0;
1603         group_counts[c] = 0;
1604         group_options[c] = 0;
1605         found_non_zero[c] = 0;
1606     }
1607
1608
1609     // -------------------------------------------------------------------------
1610     // the main loop
1611
1612     time_t  now = rrdset_slot2time(st, start_at_slot),
1613             dt = st->update_every,
1614             group_start_t = 0;
1615
1616     if(unlikely(debug)) debug(D_RRD_STATS, "BEGIN %s after_t: %u (stop_at_t: %ld), before_t: %u (start_at_t: %ld), start_t(now): %u, current_entry: %ld, entries: %ld"
1617             , st->id
1618             , (uint32_t)after
1619             , stop_at_slot
1620             , (uint32_t)before
1621             , start_at_slot
1622             , (uint32_t)now
1623             , st->current_entry
1624             , st->entries
1625             );
1626
1627     r->group = group;
1628     r->update_every = group * st->update_every;
1629     r->before = now;
1630     r->after = now;
1631
1632     //info("RRD2RRDR(): %s: STARTING", st->id);
1633
1634     long slot = start_at_slot, counter = 0, stop_now = 0, added = 0, group_count = 0, add_this = 0;
1635     for(; !stop_now ; now -= dt, slot--, counter++) {
1636         if(unlikely(slot < 0)) slot = st->entries - 1;
1637         if(unlikely(slot == stop_at_slot)) stop_now = counter;
1638
1639         if(unlikely(debug)) debug(D_RRD_STATS, "ROW %s slot: %ld, entries_counter: %ld, group_count: %ld, added: %ld, now: %ld, %s %s"
1640                 , st->id
1641                 , slot
1642                 , counter
1643                 , group_count + 1
1644                 , added
1645                 , now
1646                 , (group_count + 1 == group)?"PRINT":"  -  "
1647                 , (now >= after && now <= before)?"RANGE":"  -  "
1648                 );
1649
1650         // make sure we return data in the proper time range
1651         if(unlikely(now > before)) continue;
1652         if(unlikely(now < after)) break;
1653
1654         if(unlikely(group_count == 0)) {
1655             group_start_t = now;
1656         }
1657         group_count++;
1658
1659         if(unlikely(group_count == group)) {
1660             if(unlikely(added >= points)) break;
1661             add_this = 1;
1662         }
1663
1664         // do the calculations
1665         for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1666             storage_number n = rd->values[slot];
1667             if(unlikely(!does_storage_number_exist(n))) continue;
1668
1669             group_counts[c]++;
1670
1671             calculated_number value = unpack_storage_number(n);
1672             if(likely(value != 0.0)) {
1673                 group_options[c] |= RRDR_NONZERO;
1674                 found_non_zero[c] = 1;
1675             }
1676
1677             if(unlikely(did_storage_number_reset(n)))
1678                 group_options[c] |= RRDR_RESET;
1679
1680             switch(group_method) {
1681                 case GROUP_MIN:
1682                     if(unlikely(isnan(group_values[c])) ||
1683                             fabsl(value) < fabsl(group_values[c]))
1684                         group_values[c] = value;
1685                     break;
1686
1687                 case GROUP_MAX:
1688                     if(unlikely(isnan(group_values[c])) ||
1689                             fabsl(value) > fabsl(group_values[c]))
1690                         group_values[c] = value;
1691                     break;
1692
1693                 default:
1694                 case GROUP_SUM:
1695                 case GROUP_AVERAGE:
1696                 case GROUP_UNDEFINED:
1697                     group_values[c] += value;
1698                     break;
1699
1700                 case GROUP_INCREMENTAL_SUM:
1701                     if(unlikely(slot == start_at_slot))
1702                         last_values[c] = value;
1703
1704                     group_values[c] += last_values[c] - value;
1705                     last_values[c] = value;
1706                     break;
1707             }
1708         }
1709
1710         // added it
1711         if(unlikely(add_this)) {
1712             if(unlikely(!rrdr_line_init(r, group_start_t))) break;
1713
1714             r->after = now;
1715
1716             calculated_number *cn = rrdr_line_values(r);
1717             uint8_t *co = rrdr_line_options(r);
1718
1719             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1720
1721                 // update the dimension options
1722                 if(likely(found_non_zero[c])) r->od[c] |= RRDR_NONZERO;
1723
1724                 // store the specific point options
1725                 co[c] = group_options[c];
1726
1727                 // store the value
1728                 if(unlikely(group_counts[c] == 0)) {
1729                     cn[c] = 0.0;
1730                     co[c] |= RRDR_EMPTY;
1731                     group_values[c] = (group_method == GROUP_MAX || group_method == GROUP_MIN)?NAN:0;
1732                 }
1733                 else {
1734                     switch(group_method) {
1735                         case GROUP_MIN:
1736                         case GROUP_MAX:
1737                             if(unlikely(isnan(group_values[c])))
1738                                 cn[c] = 0;
1739                             else {
1740                                 cn[c] = group_values[c];
1741                                 group_values[c] = NAN;
1742                             }
1743                             break;
1744
1745                         case GROUP_SUM:
1746                         case GROUP_INCREMENTAL_SUM:
1747                             cn[c] = group_values[c];
1748                             group_values[c] = 0;
1749                             break;
1750
1751                         default:
1752                         case GROUP_AVERAGE:
1753                         case GROUP_UNDEFINED:
1754                             cn[c] = group_values[c] / group_counts[c];
1755                             group_values[c] = 0;
1756                             break;
1757                     }
1758
1759                     if(cn[c] < r->min) r->min = cn[c];
1760                     if(cn[c] > r->max) r->max = cn[c];
1761                 }
1762
1763                 // reset for the next loop
1764                 group_counts[c] = 0;
1765                 group_options[c] = 0;
1766             }
1767
1768             added++;
1769             group_count = 0;
1770             add_this = 0;
1771         }
1772     }
1773
1774     rrdr_done(r);
1775     //info("RRD2RRDR(): %s: END %ld loops made, %ld points generated", st->id, counter, rrdr_rows(r));
1776     //error("SHIFT: %s: wanted %ld points, got %ld", st->id, points, rrdr_rows(r));
1777     return r;
1778 }
1779
1780 int rrd2value(RRDSET *st, BUFFER *wb, calculated_number *n, const char *dimensions, long points, long long after, long long before, int group_method, uint32_t options, time_t *db_after, time_t *db_before, int *value_is_null)
1781 {
1782     RRDR *r = rrd2rrdr(st, points, after, before, group_method, !(options & RRDR_OPTION_NOT_ALIGNED));
1783     if(!r) {
1784         if(value_is_null) *value_is_null = 1;
1785         return 500;
1786     }
1787
1788     if(rrdr_rows(r) == 0) {
1789         rrdr_free(r);
1790
1791         if(db_after)  *db_after  = 0;
1792         if(db_before) *db_before = 0;
1793         if(value_is_null) *value_is_null = 1;
1794
1795         return 400;
1796     }
1797
1798     if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
1799         buffer_no_cacheable(wb);
1800     else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
1801         buffer_cacheable(wb);
1802
1803     options = rrdr_check_options(r, options, dimensions);
1804
1805     if(dimensions)
1806         rrdr_disable_not_selected_dimensions(r, options, dimensions);
1807
1808     if(db_after)  *db_after  = r->after;
1809     if(db_before) *db_before = r->before;
1810
1811     long i = (options & RRDR_OPTION_REVERSED)?rrdr_rows(r) - 1:0;
1812     *n = rrdr2value(r, i, options, value_is_null);
1813
1814     rrdr_free(r);
1815     return 200;
1816 }
1817
1818 int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long points, long long after, long long before, int group_method, uint32_t options, time_t *latest_timestamp)
1819 {
1820     RRDR *r = rrd2rrdr(st, points, after, before, group_method, !(options & RRDR_OPTION_NOT_ALIGNED));
1821     if(!r) {
1822         buffer_strcat(wb, "Cannot generate output with these parameters on this chart.");
1823         return 500;
1824     }
1825
1826     if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
1827         buffer_no_cacheable(wb);
1828     else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
1829         buffer_cacheable(wb);
1830
1831     options = rrdr_check_options(r, options, (dimensions)?buffer_tostring(dimensions):NULL);
1832
1833     if(dimensions)
1834         rrdr_disable_not_selected_dimensions(r, options, buffer_tostring(dimensions));
1835
1836     if(latest_timestamp && rrdr_rows(r) > 0)
1837         *latest_timestamp = r->before;
1838
1839     switch(format) {
1840     case DATASOURCE_SSV:
1841         if(options & RRDR_OPTION_JSON_WRAP) {
1842             wb->contenttype = CT_APPLICATION_JSON;
1843             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1844             rrdr2ssv(r, wb, options, "", " ", "");
1845             rrdr_json_wrapper_end(r, wb, format, options, 1);
1846         }
1847         else {
1848             wb->contenttype = CT_TEXT_PLAIN;
1849             rrdr2ssv(r, wb, options, "", " ", "");
1850         }
1851         break;
1852
1853     case DATASOURCE_SSV_COMMA:
1854         if(options & RRDR_OPTION_JSON_WRAP) {
1855             wb->contenttype = CT_APPLICATION_JSON;
1856             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1857             rrdr2ssv(r, wb, options, "", ",", "");
1858             rrdr_json_wrapper_end(r, wb, format, options, 1);
1859         }
1860         else {
1861             wb->contenttype = CT_TEXT_PLAIN;
1862             rrdr2ssv(r, wb, options, "", ",", "");
1863         }
1864         break;
1865
1866     case DATASOURCE_JS_ARRAY:
1867         if(options & RRDR_OPTION_JSON_WRAP) {
1868             wb->contenttype = CT_APPLICATION_JSON;
1869             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1870             rrdr2ssv(r, wb, options, "[", ",", "]");
1871             rrdr_json_wrapper_end(r, wb, format, options, 0);
1872         }
1873         else {
1874             wb->contenttype = CT_APPLICATION_JSON;
1875             rrdr2ssv(r, wb, options, "[", ",", "]");
1876         }
1877         break;
1878
1879     case DATASOURCE_CSV:
1880         if(options & RRDR_OPTION_JSON_WRAP) {
1881             wb->contenttype = CT_APPLICATION_JSON;
1882             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1883             rrdr2csv(r, wb, options, "", ",", "\\n", "");
1884             rrdr_json_wrapper_end(r, wb, format, options, 1);
1885         }
1886         else {
1887             wb->contenttype = CT_TEXT_PLAIN;
1888             rrdr2csv(r, wb, options, "", ",", "\r\n", "");
1889         }
1890         break;
1891
1892     case DATASOURCE_CSV_JSON_ARRAY:
1893         wb->contenttype = CT_APPLICATION_JSON;
1894         if(options & RRDR_OPTION_JSON_WRAP) {
1895             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1896             buffer_strcat(wb, "[\n");
1897             rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
1898             buffer_strcat(wb, "\n]");
1899             rrdr_json_wrapper_end(r, wb, format, options, 0);
1900         }
1901         else {
1902             wb->contenttype = CT_TEXT_PLAIN;
1903             buffer_strcat(wb, "[\n");
1904             rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
1905             buffer_strcat(wb, "\n]");
1906         }
1907         break;
1908
1909     case DATASOURCE_TSV:
1910         if(options & RRDR_OPTION_JSON_WRAP) {
1911             wb->contenttype = CT_APPLICATION_JSON;
1912             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1913             rrdr2csv(r, wb, options, "", "\t", "\\n", "");
1914             rrdr_json_wrapper_end(r, wb, format, options, 1);
1915         }
1916         else {
1917             wb->contenttype = CT_TEXT_PLAIN;
1918             rrdr2csv(r, wb, options, "", "\t", "\r\n", "");
1919         }
1920         break;
1921
1922     case DATASOURCE_HTML:
1923         if(options & RRDR_OPTION_JSON_WRAP) {
1924             wb->contenttype = CT_APPLICATION_JSON;
1925             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1926             buffer_strcat(wb, "<html>\\n<center>\\n<table border=\\\"0\\\" cellpadding=\\\"5\\\" cellspacing=\\\"5\\\">\\n");
1927             rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\\n", "");
1928             buffer_strcat(wb, "</table>\\n</center>\\n</html>\\n");
1929             rrdr_json_wrapper_end(r, wb, format, options, 1);
1930         }
1931         else {
1932             wb->contenttype = CT_TEXT_HTML;
1933             buffer_strcat(wb, "<html>\n<center>\n<table border=\"0\" cellpadding=\"5\" cellspacing=\"5\">\n");
1934             rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\n", "");
1935             buffer_strcat(wb, "</table>\n</center>\n</html>\n");
1936         }
1937         break;
1938
1939     case DATASOURCE_DATATABLE_JSONP:
1940         wb->contenttype = CT_APPLICATION_X_JAVASCRIPT;
1941
1942         if(options & RRDR_OPTION_JSON_WRAP)
1943             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1944
1945         rrdr2json(r, wb, options, 1);
1946
1947         if(options & RRDR_OPTION_JSON_WRAP)
1948             rrdr_json_wrapper_end(r, wb, format, options, 0);
1949         break;
1950
1951     case DATASOURCE_DATATABLE_JSON:
1952         wb->contenttype = CT_APPLICATION_JSON;
1953
1954         if(options & RRDR_OPTION_JSON_WRAP)
1955             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1956
1957         rrdr2json(r, wb, options, 1);
1958
1959         if(options & RRDR_OPTION_JSON_WRAP)
1960             rrdr_json_wrapper_end(r, wb, format, options, 0);
1961         break;
1962
1963     case DATASOURCE_JSONP:
1964         wb->contenttype = CT_APPLICATION_X_JAVASCRIPT;
1965         if(options & RRDR_OPTION_JSON_WRAP)
1966             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1967
1968         rrdr2json(r, wb, options, 0);
1969
1970         if(options & RRDR_OPTION_JSON_WRAP)
1971             rrdr_json_wrapper_end(r, wb, format, options, 0);
1972         break;
1973
1974     case DATASOURCE_JSON:
1975     default:
1976         wb->contenttype = CT_APPLICATION_JSON;
1977
1978         if(options & RRDR_OPTION_JSON_WRAP)
1979             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1980
1981         rrdr2json(r, wb, options, 0);
1982
1983         if(options & RRDR_OPTION_JSON_WRAP)
1984             rrdr_json_wrapper_end(r, wb, format, options, 0);
1985         break;
1986     }
1987
1988     rrdr_free(r);
1989     return 200;
1990 }
1991
1992 time_t rrd_stats_json(int type, RRDSET *st, BUFFER *wb, long points, long group, int group_method, time_t after, time_t before, int only_non_zero)
1993 {
1994     int c;
1995     pthread_rwlock_rdlock(&st->rwlock);
1996
1997
1998     // -------------------------------------------------------------------------
1999     // switch from JSON to google JSON
2000
2001     char kq[2] = "\"";
2002     char sq[2] = "\"";
2003     switch(type) {
2004         case DATASOURCE_DATATABLE_JSON:
2005         case DATASOURCE_DATATABLE_JSONP:
2006             kq[0] = '\0';
2007             sq[0] = '\'';
2008             break;
2009
2010         case DATASOURCE_JSON:
2011         default:
2012             break;
2013     }
2014
2015
2016     // -------------------------------------------------------------------------
2017     // validate the parameters
2018
2019     if(points < 1) points = 1;
2020     if(group < 1) group = 1;
2021
2022     if(before == 0 || before > rrdset_last_entry_t(st)) before = rrdset_last_entry_t(st);
2023     if(after  == 0 || after < rrdset_first_entry_t(st)) after = rrdset_first_entry_t(st);
2024
2025     // ---
2026
2027     // our return value (the last timestamp printed)
2028     // this is required to detect re-transmit in google JSONP
2029     time_t last_timestamp = 0;
2030
2031
2032     // -------------------------------------------------------------------------
2033     // find how many dimensions we have
2034
2035     int dimensions = 0;
2036     RRDDIM *rd;
2037     for( rd = st->dimensions ; rd ; rd = rd->next) dimensions++;
2038     if(!dimensions) {
2039         pthread_rwlock_unlock(&st->rwlock);
2040         buffer_strcat(wb, "No dimensions yet.");
2041         return 0;
2042     }
2043
2044
2045     // -------------------------------------------------------------------------
2046     // prepare various strings, to speed up the loop
2047
2048     char overflow_annotation[201]; snprintfz(overflow_annotation, 200, ",{%sv%s:%sRESET OR OVERFLOW%s},{%sv%s:%sThe counters have been wrapped.%s}", kq, kq, sq, sq, kq, kq, sq, sq);
2049     char normal_annotation[201];   snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
2050     char pre_date[51];             snprintfz(pre_date,             50, "        {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
2051     char post_date[21];            snprintfz(post_date,            20, "%s}", sq);
2052     char pre_value[21];            snprintfz(pre_value,            20, ",{%sv%s:", kq, kq);
2053     char post_value[21];           strcpy(post_value,                  "}");
2054
2055
2056     // -------------------------------------------------------------------------
2057     // checks for debugging
2058
2059     if(st->debug) {
2060         debug(D_RRD_STATS, "%s first_entry_t = %ld, last_entry_t = %ld, duration = %ld, after = %ld, before = %ld, duration = %ld, entries_to_show = %ld, group = %ld"
2061             , st->id
2062             , rrdset_first_entry_t(st)
2063             , rrdset_last_entry_t(st)
2064             , rrdset_last_entry_t(st) - rrdset_first_entry_t(st)
2065             , after
2066             , before
2067             , before - after
2068             , points
2069             , group
2070             );
2071
2072         if(before < after)
2073             debug(D_RRD_STATS, "WARNING: %s The newest value in the database (%ld) is earlier than the oldest (%ld)", st->name, before, after);
2074
2075         if((before - after) > st->entries * st->update_every)
2076             debug(D_RRD_STATS, "WARNING: %s The time difference between the oldest and the newest entries (%ld) is higher than the capacity of the database (%ld)", st->name, before - after, st->entries * st->update_every);
2077     }
2078
2079
2080     // -------------------------------------------------------------------------
2081     // temp arrays for keeping values per dimension
2082
2083     calculated_number group_values[dimensions]; // keep sums when grouping
2084     int               print_hidden[dimensions]; // keep hidden flags
2085     int               found_non_zero[dimensions];
2086     int               found_non_existing[dimensions];
2087
2088     // initialize them
2089     for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2090         group_values[c] = 0;
2091         print_hidden[c] = (rd->flags & RRDDIM_FLAG_HIDDEN)?1:0;
2092         found_non_zero[c] = 0;
2093         found_non_existing[c] = 0;
2094     }
2095
2096
2097     // error("OLD: points=%d after=%d before=%d group=%d, duration=%d", entries_to_show, before - (st->update_every * group * entries_to_show), before, group, before - after + 1);
2098     // rrd2array(st, entries_to_show, before - (st->update_every * group * entries_to_show), before, group_method, only_non_zero);
2099     // rrd2rrdr(st, entries_to_show, before - (st->update_every * group * entries_to_show), before, group_method);
2100
2101     // -------------------------------------------------------------------------
2102     // remove dimensions that contain only zeros
2103
2104     int max_loop = 1;
2105     if(only_non_zero) max_loop = 2;
2106
2107     for(; max_loop ; max_loop--) {
2108
2109         // -------------------------------------------------------------------------
2110         // print the JSON header
2111
2112         buffer_sprintf(wb, "{\n %scols%s:\n [\n", kq, kq);
2113         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%stime%s,%spattern%s:%s%s,%stype%s:%sdatetime%s},\n", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq);
2114         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%s%s,%spattern%s:%s%s,%stype%s:%sstring%s,%sp%s:{%srole%s:%sannotation%s}},\n", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, kq, kq, sq, sq);
2115         buffer_sprintf(wb, "        {%sid%s:%s%s,%slabel%s:%s%s,%spattern%s:%s%s,%stype%s:%sstring%s,%sp%s:{%srole%s:%sannotationText%s}}", kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, sq, sq, kq, kq, kq, kq, sq, sq);
2116
2117         // print the header for each dimension
2118         // and update the print_hidden array for the dimensions that should be hidden
2119         int pc = 0;
2120         for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2121             if(!print_hidden[c]) {
2122                 pc++;
2123                 buffer_sprintf(wb, ",\n     {%sid%s:%s%s,%slabel%s:%s%s%s,%spattern%s:%s%s,%stype%s:%snumber%s}", kq, kq, sq, sq, kq, kq, sq, rd->name, sq, kq, kq, sq, sq, kq, kq, sq, sq);
2124             }
2125         }
2126         if(!pc) {
2127             buffer_sprintf(wb, ",\n     {%sid%s:%s%s,%slabel%s:%s%s%s,%spattern%s:%s%s,%stype%s:%snumber%s}", kq, kq, sq, sq, kq, kq, sq, "no data", sq, kq, kq, sq, sq, kq, kq, sq, sq);
2128         }
2129
2130         // print the begin of row data
2131         buffer_sprintf(wb, "\n  ],\n    %srows%s:\n [\n", kq, kq);
2132
2133
2134         // -------------------------------------------------------------------------
2135         // the main loop
2136
2137         int annotate_reset = 0;
2138         int annotation_count = 0;
2139
2140         long    t = rrdset_time2slot(st, before),
2141                 stop_at_t = rrdset_time2slot(st, after),
2142                 stop_now = 0;
2143
2144         t -= t % group;
2145
2146         time_t  now = rrdset_slot2time(st, t),
2147                 dt = st->update_every;
2148
2149         long count = 0, printed = 0, group_count = 0;
2150         last_timestamp = 0;
2151
2152         if(st->debug) debug(D_RRD_STATS, "%s: REQUEST after:%u before:%u, points:%ld, group:%ld, CHART cur:%ld first: %u last:%u, CALC start_t:%ld, stop_t:%ld"
2153                     , st->id
2154                     , (uint32_t)after
2155                     , (uint32_t)before
2156                     , points
2157                     , group
2158                     , st->current_entry
2159                     , (uint32_t)rrdset_first_entry_t(st)
2160                     , (uint32_t)rrdset_last_entry_t(st)
2161                     , t
2162                     , stop_at_t
2163                     );
2164
2165         long counter = 0;
2166         for(; !stop_now ; now -= dt, t--, counter++) {
2167             if(t < 0) t = st->entries - 1;
2168             if(t == stop_at_t) stop_now = counter;
2169
2170             int print_this = 0;
2171
2172             if(st->debug) debug(D_RRD_STATS, "%s t = %ld, count = %ld, group_count = %ld, printed = %ld, now = %ld, %s %s"
2173                     , st->id
2174                     , t
2175                     , count + 1
2176                     , group_count + 1
2177                     , printed
2178                     , now
2179                     , (group_count + 1 == group)?"PRINT":"  -  "
2180                     , (now >= after && now <= before)?"RANGE":"  -  "
2181                     );
2182
2183
2184             // make sure we return data in the proper time range
2185             if(now > before) continue;
2186             if(now < after) break;
2187
2188             //if(rrdset_slot2time(st, t) != now)
2189             //  error("%s: slot=%ld, now=%ld, slot2time=%ld, diff=%ld, last_entry_t=%ld, rrdset_last_slot=%ld", st->id, t, now, rrdset_slot2time(st,t), now - rrdset_slot2time(st,t), rrdset_last_entry_t(st), rrdset_last_slot(st));
2190
2191             count++;
2192             group_count++;
2193
2194             // check if we have to print this now
2195             if(group_count == group) {
2196                 if(printed >= points) {
2197                     // debug(D_RRD_STATS, "Already printed all rows. Stopping.");
2198                     break;
2199                 }
2200
2201                 // generate the local date time
2202                 struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
2203                 if(!tm) { error("localtime() failed."); continue; }
2204                 if(now > last_timestamp) last_timestamp = now;
2205
2206                 if(printed) buffer_strcat(wb, "]},\n");
2207                 buffer_strcat(wb, pre_date);
2208                 buffer_jsdate(wb, tm->tm_year + 1900, tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
2209                 buffer_strcat(wb, post_date);
2210
2211                 print_this = 1;
2212             }
2213
2214             // do the calculations
2215             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2216                 storage_number n = rd->values[t];
2217                 calculated_number value = unpack_storage_number(n);
2218
2219                 if(!does_storage_number_exist(n)) {
2220                     value = 0.0;
2221                     found_non_existing[c]++;
2222                 }
2223                 if(did_storage_number_reset(n)) annotate_reset = 1;
2224
2225                 switch(group_method) {
2226                     case GROUP_MAX:
2227                         if(abs(value) > abs(group_values[c])) group_values[c] = value;
2228                         break;
2229
2230                     case GROUP_SUM:
2231                         group_values[c] += value;
2232                         break;
2233
2234                     default:
2235                     case GROUP_AVERAGE:
2236                         group_values[c] += value;
2237                         if(print_this) group_values[c] /= ( group_count - found_non_existing[c] );
2238                         break;
2239                 }
2240             }
2241
2242             if(print_this) {
2243                 if(annotate_reset) {
2244                     annotation_count++;
2245                     buffer_strcat(wb, overflow_annotation);
2246                     annotate_reset = 0;
2247                 }
2248                 else
2249                     buffer_strcat(wb, normal_annotation);
2250
2251                 pc = 0;
2252                 for(c = 0 ; c < dimensions ; c++) {
2253                     if(found_non_existing[c] == group_count) {
2254                         // all entries are non-existing
2255                         pc++;
2256                         buffer_strcat(wb, pre_value);
2257                         buffer_strcat(wb, "null");
2258                         buffer_strcat(wb, post_value);
2259                     }
2260                     else if(!print_hidden[c]) {
2261                         pc++;
2262                         buffer_strcat(wb, pre_value);
2263                         buffer_rrd_value(wb, group_values[c]);
2264                         buffer_strcat(wb, post_value);
2265
2266                         if(group_values[c]) found_non_zero[c]++;
2267                     }
2268
2269                     // reset them for the next loop
2270                     group_values[c] = 0;
2271                     found_non_existing[c] = 0;
2272                 }
2273
2274                 // if all dimensions are hidden, print a null
2275                 if(!pc) {
2276                     buffer_strcat(wb, pre_value);
2277                     buffer_strcat(wb, "null");
2278                     buffer_strcat(wb, post_value);
2279                 }
2280
2281                 printed++;
2282                 group_count = 0;
2283             }
2284         }
2285
2286         if(printed) buffer_strcat(wb, "]}");
2287         buffer_strcat(wb, "\n   ]\n}\n");
2288
2289         if(only_non_zero && max_loop > 1) {
2290             int changed = 0;
2291             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2292                 group_values[c] = 0;
2293                 found_non_existing[c] = 0;
2294
2295                 if(!print_hidden[c] && !found_non_zero[c]) {
2296                     changed = 1;
2297                     print_hidden[c] = 1;
2298                 }
2299             }
2300
2301             if(changed) buffer_flush(wb);
2302             else break;
2303         }
2304         else break;
2305
2306     } // max_loop
2307
2308     debug(D_RRD_STATS, "RRD_STATS_JSON: %s total %zu bytes", st->name, wb->len);
2309
2310     pthread_rwlock_unlock(&st->rwlock);
2311     return last_timestamp;
2312 }