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
 453 // RRDR result options
 454 #define RRDR_RESULT_OPTION_ABSOLUTE 0x00000001
 455 #define RRDR_RESULT_OPTION_RELATIVE 0x00000002
 456
 457 typedef struct rrdresult {
 458     RRDSET *st;         // the chart this result refers to
 459
 460     uint32_t result_options;    // RRDR_RESULT_OPTION_*
 461
 462     int d;                  // the number of dimensions
 463     long n;                 // the number of values in the arrays
 464     long rows;              // the number of rows used
 465
 466     uint8_t *od;            // the options for the dimensions
 467
 468     time_t *t;              // array of n timestamps
 469     calculated_number *v;   // array n x d values
 470     uint8_t *o;             // array n x d options
 471
 472     long c;                 // current line ( -1 ~ n ), ( -1 = none, use rrdr_rows() to get number of rows )
 473
 474     long group;             // how many collected values were grouped for each row
 475     int update_every;       // what is the suggested update frequency in seconds
 476
 477     calculated_number min;
 478     calculated_number max;
 479
 480     time_t before;
 481     time_t after;
 482
 483     int has_st_lock;        // if st is read locked by us
 484 } RRDR;
 485
 486 #define rrdr_rows(r) ((r)->rows)
 487
 488 /*
 489 static void rrdr_dump(RRDR *r)
 490 {
 491     long c, i;
 492     RRDDIM *d;
 493
 494     fprintf(stderr, "\nCHART %s (%s)\n", r->st->id, r->st->name);
 495
 496     for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
 497         fprintf(stderr, "DIMENSION %s (%s), %s%s%s%s\n"
 498                 , d->id
 499                 , d->name
 500                 , (r->od[c] & RRDR_EMPTY)?"EMPTY ":""
 501                 , (r->od[c] & RRDR_RESET)?"RESET ":""
 502                 , (r->od[c] & RRDR_HIDDEN)?"HIDDEN ":""
 503                 , (r->od[c] & RRDR_NONZERO)?"NONZERO ":""
 504                 );
 505     }
 506
 507     if(r->rows <= 0) {
 508         fprintf(stderr, "RRDR does not have any values in it.\n");
 509         return;
 510     }
 511
 512     fprintf(stderr, "RRDR includes %d values in it:\n", r->rows);
 513
 514     // for each line in the array
 515     for(i = 0; i < r->rows ;i++) {
 516         calculated_number *cn = &r->v[ i * r->d ];
 517         uint8_t *co = &r->o[ i * r->d ];
 518
 519         // print the id and the timestamp of the line
 520         fprintf(stderr, "%ld %ld ", i + 1, r->t[i]);
 521
 522         // for each dimension
 523         for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
 524             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 525             if(unlikely(!(r->od[c] & RRDR_NONZERO))) continue;
 526
 527             if(co[c] & RRDR_EMPTY)
 528                 fprintf(stderr, "null ");
 529             else
 530                 fprintf(stderr, CALCULATED_NUMBER_FORMAT " %s%s%s%s "
 531                     , cn[c]
 532                     , (co[c] & RRDR_EMPTY)?"E":" "
 533                     , (co[c] & RRDR_RESET)?"R":" "
 534                     , (co[c] & RRDR_HIDDEN)?"H":" "
 535                     , (co[c] & RRDR_NONZERO)?"N":" "
 536                     );
 537         }
 538
 539         fprintf(stderr, "\n");
 540     }
 541 }
 542 */
 543
 544 void rrdr_disable_not_selected_dimensions(RRDR *r, const char *dims)
 545 {
 546     char b[strlen(dims) + 1];
 547     char *o = b, *tok;
 548     strcpy(o, dims);
 549
 550     long c;
 551     RRDDIM *d;
 552
 553     // disable all of them
 554     for(c = 0, d = r->st->dimensions; d ;c++, d = d->next)
 555         r->od[c] |= RRDR_HIDDEN;
 556
 557     while(o && *o && (tok = mystrsep(&o, ",|"))) {
 558         if(!*tok) continue;
 559
 560         uint32_t hash = simple_hash(tok);
 561
 562         // find it and enable it
 563         for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
 564             if(unlikely((hash == d->hash && !strcmp(d->id, tok)) || !strcmp(d->name, tok))) {
 565                 r->od[c] &= ~RRDR_HIDDEN;
 566
 567                 // since the user needs this dimension
 568                 // make it appear as NONZERO, to return it
 569                 // even if the dimension has only zeros
 570                 r->od[c] |= RRDR_NONZERO;
 571             }
 572         }
 573     }
 574 }
 575
 576 void rrdr_buffer_print_format(BUFFER *wb, uint32_t format)
 577 {
 578     switch(format) {
 579     case DATASOURCE_JSON:
 580         buffer_strcat(wb, DATASOURCE_FORMAT_JSON);
 581         break;
 582
 583     case DATASOURCE_DATATABLE_JSON:
 584         buffer_strcat(wb, DATASOURCE_FORMAT_DATATABLE_JSON);
 585         break;
 586
 587     case DATASOURCE_DATATABLE_JSONP:
 588         buffer_strcat(wb, DATASOURCE_FORMAT_DATATABLE_JSONP);
 589         break;
 590
 591     case DATASOURCE_JSONP:
 592         buffer_strcat(wb, DATASOURCE_FORMAT_JSONP);
 593         break;
 594
 595     case DATASOURCE_SSV:
 596         buffer_strcat(wb, DATASOURCE_FORMAT_SSV);
 597         break;
 598
 599     case DATASOURCE_CSV:
 600         buffer_strcat(wb, DATASOURCE_FORMAT_CSV);
 601         break;
 602
 603     case DATASOURCE_TSV:
 604         buffer_strcat(wb, DATASOURCE_FORMAT_TSV);
 605         break;
 606
 607     case DATASOURCE_HTML:
 608         buffer_strcat(wb, DATASOURCE_FORMAT_HTML);
 609         break;
 610
 611     case DATASOURCE_JS_ARRAY:
 612         buffer_strcat(wb, DATASOURCE_FORMAT_JS_ARRAY);
 613         break;
 614
 615     case DATASOURCE_SSV_COMMA:
 616         buffer_strcat(wb, DATASOURCE_FORMAT_SSV_COMMA);
 617         break;
 618
 619     default:
 620         buffer_strcat(wb, "unknown");
 621         break;
 622     }
 623 }
 624
 625 uint32_t rrdr_check_options(RRDR *r, uint32_t options, const char *dims)
 626 {
 627     (void)dims;
 628
 629     if(options & RRDR_OPTION_NONZERO) {
 630         long i;
 631
 632         // commented due to #1514
 633
 634         //if(dims && *dims) {
 635             // the caller wants specific dimensions
 636             // disable NONZERO option
 637             // to make sure we don't accidentally prevent
 638             // the specific dimensions from being returned
 639             // i = 0;
 640         //}
 641         //else {
 642             // find how many dimensions are not zero
 643             long c;
 644             RRDDIM *rd;
 645             for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ; c++, rd = rd->next) {
 646                 if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 647                 if(unlikely(!(r->od[c] & RRDR_NONZERO))) continue;
 648                 i++;
 649             }
 650         //}
 651
 652         // if with nonzero we get i = 0 (no dimensions will be returned)
 653         // disable nonzero to show all dimensions
 654         if(!i) options &= ~RRDR_OPTION_NONZERO;
 655     }
 656
 657     return options;
 658 }
 659
 660 void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t options, int string_value)
 661 {
 662     long rows = rrdr_rows(r);
 663     long c, i;
 664     RRDDIM *rd;
 665
 666     //info("JSONWRAPPER(): %s: BEGIN", r->st->id);
 667     char kq[2] = "",                    // key quote
 668         sq[2] = "";                     // string quote
 669
 670     if( options & RRDR_OPTION_GOOGLE_JSON ) {
 671         kq[0] = '\0';
 672         sq[0] = '\'';
 673     }
 674     else {
 675         kq[0] = '"';
 676         sq[0] = '"';
 677     }
 678
 679     buffer_sprintf(wb, "{\n"
 680             "   %sapi%s: 1,\n"
 681             "   %sid%s: %s%s%s,\n"
 682             "   %sname%s: %s%s%s,\n"
 683             "   %sview_update_every%s: %d,\n"
 684             "   %supdate_every%s: %d,\n"
 685             "   %sfirst_entry%s: %u,\n"
 686             "   %slast_entry%s: %u,\n"
 687             "   %sbefore%s: %u,\n"
 688             "   %safter%s: %u,\n"
 689             "   %sdimension_names%s: ["
 690             , kq, kq
 691             , kq, kq, sq, r->st->id, sq
 692             , kq, kq, sq, r->st->name, sq
 693             , kq, kq, r->update_every
 694             , kq, kq, r->st->update_every
 695             , kq, kq, (uint32_t)rrdset_first_entry_t(r->st)
 696             , kq, kq, (uint32_t)rrdset_last_entry_t(r->st)
 697             , kq, kq, (uint32_t)r->before
 698             , kq, kq, (uint32_t)r->after
 699             , kq, kq);
 700
 701     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
 702         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 703         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 704
 705         if(i) buffer_strcat(wb, ", ");
 706         buffer_strcat(wb, sq);
 707         buffer_strcat(wb, rd->name);
 708         buffer_strcat(wb, sq);
 709         i++;
 710     }
 711     if(!i) {
 712 #ifdef NETDATA_INTERNAL_CHECKS
 713         error("RRDR is empty for %s (RRDR has %d dimensions, options is 0x%08x)", r->st->id, r->d, options);
 714 #endif
 715         rows = 0;
 716         buffer_strcat(wb, sq);
 717         buffer_strcat(wb, "no data");
 718         buffer_strcat(wb, sq);
 719     }
 720
 721     buffer_sprintf(wb, "],\n"
 722             "   %sdimension_ids%s: ["
 723             , kq, kq);
 724
 725     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
 726         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 727         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 728
 729         if(i) buffer_strcat(wb, ", ");
 730         buffer_strcat(wb, sq);
 731         buffer_strcat(wb, rd->id);
 732         buffer_strcat(wb, sq);
 733         i++;
 734     }
 735     if(!i) {
 736         rows = 0;
 737         buffer_strcat(wb, sq);
 738         buffer_strcat(wb, "no data");
 739         buffer_strcat(wb, sq);
 740     }
 741
 742     buffer_sprintf(wb, "],\n"
 743             "   %slatest_values%s: ["
 744             , kq, kq);
 745
 746     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
 747         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 748         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 749
 750         if(i) buffer_strcat(wb, ", ");
 751         i++;
 752
 753         storage_number n = rd->values[rrdset_last_slot(r->st)];
 754
 755         if(!does_storage_number_exist(n))
 756             buffer_strcat(wb, "null");
 757         else
 758             buffer_rrd_value(wb, unpack_storage_number(n));
 759     }
 760     if(!i) {
 761         rows = 0;
 762         buffer_strcat(wb, "null");
 763     }
 764
 765     buffer_sprintf(wb, "],\n"
 766             "   %sview_latest_values%s: ["
 767             , kq, kq);
 768
 769     i = 0;
 770     if(rows) {
 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             calculated_number *cn = &r->v[ (0) * r->d ];
 779             uint8_t *co = &r->o[ (0) * r->d ];
 780
 781             if(co[c] & RRDR_EMPTY)
 782                 buffer_strcat(wb, "null");
 783             else
 784                 buffer_rrd_value(wb, cn[c]);
 785         }
 786     }
 787     if(!i) {
 788         rows = 0;
 789         buffer_strcat(wb, "null");
 790     }
 791
 792     buffer_sprintf(wb, "],\n"
 793             "   %sdimensions%s: %ld,\n"
 794             "   %spoints%s: %ld,\n"
 795             "   %sformat%s: %s"
 796             , kq, kq, i
 797             , kq, kq, rows
 798             , kq, kq, sq
 799             );
 800
 801     rrdr_buffer_print_format(wb, format);
 802
 803     buffer_sprintf(wb, "%s,\n"
 804             "   %sresult%s: "
 805             , sq
 806             , kq, kq
 807             );
 808
 809     if(string_value) buffer_strcat(wb, sq);
 810     //info("JSONWRAPPER(): %s: END", r->st->id);
 811 }
 812
 813 void rrdr_json_wrapper_end(RRDR *r, BUFFER *wb, uint32_t format, uint32_t options, int string_value)
 814 {
 815     (void)format;
 816
 817     char kq[2] = "",                    // key quote
 818         sq[2] = "";                     // string quote
 819
 820     if( options & RRDR_OPTION_GOOGLE_JSON ) {
 821         kq[0] = '\0';
 822         sq[0] = '\'';
 823     }
 824     else {
 825         kq[0] = '"';
 826         sq[0] = '"';
 827     }
 828
 829     if(string_value) buffer_strcat(wb, sq);
 830
 831     buffer_sprintf(wb, ",\n %smin%s: ", kq, kq);
 832     buffer_rrd_value(wb, r->min);
 833     buffer_sprintf(wb, ",\n %smax%s: ", kq, kq);
 834     buffer_rrd_value(wb, r->max);
 835     buffer_strcat(wb, "\n}\n");
 836 }
 837
 838 #define JSON_DATES_JS 1
 839 #define JSON_DATES_TIMESTAMP 2
 840
 841 static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
 842 {
 843     //info("RRD2JSON(): %s: BEGIN", r->st->id);
 844     int row_annotations = 0, dates, dates_with_new = 0;
 845     char kq[2] = "",                    // key quote
 846         sq[2] = "",                     // string quote
 847         pre_label[101] = "",            // before each label
 848         post_label[101] = "",           // after each label
 849         pre_date[101] = "",             // the beginning of line, to the date
 850         post_date[101] = "",            // closing the date
 851         pre_value[101] = "",            // before each value
 852         post_value[101] = "",           // after each value
 853         post_line[101] = "",            // at the end of each row
 854         normal_annotation[201] = "",    // default row annotation
 855         overflow_annotation[201] = "",  // overflow row annotation
 856         data_begin[101] = "",           // between labels and values
 857         finish[101] = "";               // at the end of everything
 858
 859     if(datatable) {
 860         dates = JSON_DATES_JS;
 861         if( options & RRDR_OPTION_GOOGLE_JSON ) {
 862             kq[0] = '\0';
 863             sq[0] = '\'';
 864         }
 865         else {
 866             kq[0] = '"';
 867             sq[0] = '"';
 868         }
 869         row_annotations = 1;
 870         snprintfz(pre_date,   100, "        {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
 871         snprintfz(post_date,  100, "%s}", sq);
 872         snprintfz(pre_label,  100, ",\n     {%sid%s:%s%s,%slabel%s:%s", kq, kq, sq, sq, kq, kq, sq);
 873         snprintfz(post_label, 100, "%s,%spattern%s:%s%s,%stype%s:%snumber%s}", sq, kq, kq, sq, sq, kq, kq, sq, sq);
 874         snprintfz(pre_value,  100, ",{%sv%s:", kq, kq);
 875         strcpy(post_value,         "}");
 876         strcpy(post_line,          "]}");
 877         snprintfz(data_begin, 100, "\n  ],\n    %srows%s:\n [\n", kq, kq);
 878         strcpy(finish,             "\n  ]\n}");
 879
 880         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);
 881         snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
 882
 883         buffer_sprintf(wb, "{\n %scols%s:\n [\n", kq, kq);
 884         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);
 885         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);
 886         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);
 887
 888         // remove the valueobjects flag
 889         // google wants its own keys
 890         if(options & RRDR_OPTION_OBJECTSROWS)
 891             options &= ~RRDR_OPTION_OBJECTSROWS;
 892     }
 893     else {
 894         kq[0] = '"';
 895         sq[0] = '"';
 896         if((options & RRDR_OPTION_SECONDS) || (options & RRDR_OPTION_MILLISECONDS)) {
 897             dates = JSON_DATES_TIMESTAMP;
 898             dates_with_new = 0;
 899         }
 900         else {
 901             dates = JSON_DATES_JS;
 902             dates_with_new = 1;
 903         }
 904         if( options & RRDR_OPTION_OBJECTSROWS )
 905             strcpy(pre_date, "      { ");
 906         else
 907             strcpy(pre_date, "      [ ");
 908         strcpy(pre_label,  ", \"");
 909         strcpy(post_label, "\"");
 910         strcpy(pre_value,  ", ");
 911         if( options & RRDR_OPTION_OBJECTSROWS )
 912             strcpy(post_line, "}");
 913         else
 914             strcpy(post_line, "]");
 915         snprintfz(data_begin, 100, "],\n    %sdata%s:\n [\n", kq, kq);
 916         strcpy(finish,             "\n  ]\n}");
 917
 918         buffer_sprintf(wb, "{\n %slabels%s: [", kq, kq);
 919         buffer_sprintf(wb, "%stime%s", sq, sq);
 920     }
 921
 922     // -------------------------------------------------------------------------
 923     // print the JSON header
 924
 925     long c, i;
 926     RRDDIM *rd;
 927
 928     // print the header lines
 929     for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
 930         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
 931         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 932
 933         buffer_strcat(wb, pre_label);
 934         buffer_strcat(wb, rd->name);
 935         buffer_strcat(wb, post_label);
 936         i++;
 937     }
 938     if(!i) {
 939         buffer_strcat(wb, pre_label);
 940         buffer_strcat(wb, "no data");
 941         buffer_strcat(wb, post_label);
 942     }
 943
 944     // print the begin of row data
 945     buffer_strcat(wb, data_begin);
 946
 947     // if all dimensions are hidden, print a null
 948     if(!i) {
 949         buffer_strcat(wb, finish);
 950         return;
 951     }
 952
 953     long start = 0, end = rrdr_rows(r), step = 1;
 954     if((options & RRDR_OPTION_REVERSED)) {
 955         start = rrdr_rows(r) - 1;
 956         end = -1;
 957         step = -1;
 958     }
 959
 960     // for each line in the array
 961     calculated_number total = 1;
 962     for(i = start; i != end ;i += step) {
 963         calculated_number *cn = &r->v[ i * r->d ];
 964         uint8_t *co = &r->o[ i * r->d ];
 965
 966         time_t now = r->t[i];
 967
 968         if(dates == JSON_DATES_JS) {
 969             // generate the local date time
 970             struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
 971             if(!tm) { error("localtime_r() failed."); continue; }
 972
 973             if(likely(i != start)) buffer_strcat(wb, ",\n");
 974             buffer_strcat(wb, pre_date);
 975
 976             if( options & RRDR_OPTION_OBJECTSROWS )
 977                 buffer_sprintf(wb, "%stime%s: ", kq, kq);
 978
 979             if(dates_with_new)
 980                 buffer_strcat(wb, "new ");
 981
 982             buffer_jsdate(wb, tm->tm_year + 1900, tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
 983
 984             buffer_strcat(wb, post_date);
 985
 986             if(row_annotations) {
 987                 // google supports one annotation per row
 988                 int annotation_found = 0;
 989                 for(c = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
 990                     if(co[c] & RRDR_RESET) {
 991                         buffer_strcat(wb, overflow_annotation);
 992                         annotation_found = 1;
 993                         break;
 994                     }
 995                 }
 996                 if(!annotation_found)
 997                     buffer_strcat(wb, normal_annotation);
 998             }
 999         }
1000         else {
1001             // print the timestamp of the line
1002             if(likely(i != start)) buffer_strcat(wb, ",\n");
1003             buffer_strcat(wb, pre_date);
1004
1005             if( options & RRDR_OPTION_OBJECTSROWS )
1006                 buffer_sprintf(wb, "%stime%s: ", kq, kq);
1007
1008             buffer_rrd_value(wb, (calculated_number)r->t[i]);
1009             // in ms
1010             if(options & RRDR_OPTION_MILLISECONDS) buffer_strcat(wb, "000");
1011
1012             buffer_strcat(wb, post_date);
1013         }
1014
1015         if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1016             total = 0;
1017             for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
1018                 calculated_number n = cn[c];
1019
1020                 if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1021                     n = -n;
1022
1023                 total += n;
1024             }
1025             // prevent a division by zero
1026             if(total == 0) total = 1;
1027         }
1028
1029         // for each dimension
1030         for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
1031             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1032             if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1033
1034             calculated_number n = cn[c];
1035
1036             buffer_strcat(wb, pre_value);
1037
1038             if( options & RRDR_OPTION_OBJECTSROWS )
1039                 buffer_sprintf(wb, "%s%s%s: ", kq, rd->name, kq);
1040
1041             if(co[c] & RRDR_EMPTY) {
1042                 if(options & RRDR_OPTION_NULL2ZERO)
1043                     buffer_strcat(wb, "0");
1044                 else
1045                     buffer_strcat(wb, "null");
1046             }
1047             else {
1048                 if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1049                     n = -n;
1050
1051                 if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1052                     n = n * 100 / total;
1053
1054                 buffer_rrd_value(wb, n);
1055             }
1056
1057             buffer_strcat(wb, post_value);
1058         }
1059
1060         buffer_strcat(wb, post_line);
1061     }
1062
1063     buffer_strcat(wb, finish);
1064     //info("RRD2JSON(): %s: END", r->st->id);
1065 }
1066
1067 static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startline, const char *separator, const char *endline, const char *betweenlines)
1068 {
1069     //info("RRD2CSV(): %s: BEGIN", r->st->id);
1070     long c, i;
1071     RRDDIM *d;
1072
1073     // print the csv header
1074     for(c = 0, i = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1075         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1076         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1077
1078         if(!i) {
1079             buffer_strcat(wb, startline);
1080             if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1081             buffer_strcat(wb, "time");
1082             if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1083         }
1084         buffer_strcat(wb, separator);
1085         if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1086         buffer_strcat(wb, d->name);
1087         if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
1088         i++;
1089     }
1090     buffer_strcat(wb, endline);
1091
1092     if(!i) {
1093         // no dimensions present
1094         return;
1095     }
1096
1097     long start = 0, end = rrdr_rows(r), step = 1;
1098     if((options & RRDR_OPTION_REVERSED)) {
1099         start = rrdr_rows(r) - 1;
1100         end = -1;
1101         step = -1;
1102     }
1103
1104     // for each line in the array
1105     calculated_number total = 1;
1106     for(i = start; i != end ;i += step) {
1107         calculated_number *cn = &r->v[ i * r->d ];
1108         uint8_t *co = &r->o[ i * r->d ];
1109
1110         buffer_strcat(wb, betweenlines);
1111         buffer_strcat(wb, startline);
1112
1113         time_t now = r->t[i];
1114
1115         if((options & RRDR_OPTION_SECONDS) || (options & RRDR_OPTION_MILLISECONDS)) {
1116             // print the timestamp of the line
1117             buffer_rrd_value(wb, (calculated_number)now);
1118             // in ms
1119             if(options & RRDR_OPTION_MILLISECONDS) buffer_strcat(wb, "000");
1120         }
1121         else {
1122             // generate the local date time
1123             struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
1124             if(!tm) { error("localtime() failed."); continue; }
1125             buffer_date(wb, tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
1126         }
1127
1128         if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1129             total = 0;
1130             for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1131                 calculated_number n = cn[c];
1132
1133                 if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1134                     n = -n;
1135
1136                 total += n;
1137             }
1138             // prevent a division by zero
1139             if(total == 0) total = 1;
1140         }
1141
1142         // for each dimension
1143         for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1144             if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1145             if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1146
1147             buffer_strcat(wb, separator);
1148
1149             calculated_number n = cn[c];
1150
1151             if(co[c] & RRDR_EMPTY) {
1152                 if(options & RRDR_OPTION_NULL2ZERO)
1153                     buffer_strcat(wb, "0");
1154                 else
1155                     buffer_strcat(wb, "null");
1156             }
1157             else {
1158                 if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1159                     n = -n;
1160
1161                 if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1162                     n = n * 100 / total;
1163
1164                 buffer_rrd_value(wb, n);
1165             }
1166         }
1167
1168         buffer_strcat(wb, endline);
1169     }
1170     //info("RRD2CSV(): %s: END", r->st->id);
1171 }
1172
1173 inline static calculated_number rrdr2value(RRDR *r, long i, uint32_t options, int *all_values_are_null) {
1174     long c;
1175     RRDDIM *d;
1176
1177     calculated_number *cn = &r->v[ i * r->d ];
1178     uint8_t *co = &r->o[ i * r->d ];
1179
1180     calculated_number sum = 0, min = 0, max = 0, v;
1181     int all_null = 1, init = 1;
1182
1183     calculated_number total = 1;
1184     if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
1185         total = 0;
1186         for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1187             calculated_number n = cn[c];
1188
1189             if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1190                 n = -n;
1191
1192             total += n;
1193         }
1194         // prevent a division by zero
1195         if(total == 0) total = 1;
1196     }
1197
1198     // for each dimension
1199     for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
1200         if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
1201         if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
1202
1203         calculated_number n = cn[c];
1204
1205         if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
1206             n = -n;
1207
1208         if(unlikely(options & RRDR_OPTION_PERCENTAGE))
1209             n = n * 100 / total;
1210
1211         if(unlikely(init)) {
1212             if(n > 0) {
1213                 min = 0;
1214                 max = n;
1215             }
1216             else {
1217                 min = n;
1218                 max = 0;
1219             }
1220             init = 0;
1221         }
1222
1223         if(likely(!(co[c] & RRDR_EMPTY))) {
1224             all_null = 0;
1225             sum += n;
1226         }
1227
1228         if(n < min) min = n;
1229         if(n > max) max = n;
1230     }
1231
1232     if(unlikely(all_null)) {
1233         if(likely(all_values_are_null))
1234             *all_values_are_null = 1;
1235         return 0;
1236     }
1237     else {
1238         if(likely(all_values_are_null))
1239             *all_values_are_null = 0;
1240     }
1241
1242     if(options & RRDR_OPTION_MIN2MAX)
1243         v = max - min;
1244     else
1245         v = sum;
1246
1247     return v;
1248 }
1249
1250 static void rrdr2ssv(RRDR *r, BUFFER *wb, uint32_t options, const char *prefix, const char *separator, const char *suffix)
1251 {
1252     //info("RRD2SSV(): %s: BEGIN", r->st->id);
1253     long i;
1254
1255     buffer_strcat(wb, prefix);
1256     long start = 0, end = rrdr_rows(r), step = 1;
1257     if((options & RRDR_OPTION_REVERSED)) {
1258         start = rrdr_rows(r) - 1;
1259         end = -1;
1260         step = -1;
1261     }
1262
1263     // for each line in the array
1264     for(i = start; i != end ;i += step) {
1265         int all_values_are_null = 0;
1266         calculated_number v = rrdr2value(r, i, options, &all_values_are_null);
1267
1268         if(likely(i != start)) {
1269             if(r->min > v) r->min = v;
1270             if(r->max < v) r->max = v;
1271         }
1272         else {
1273             r->min = v;
1274             r->max = v;
1275         }
1276
1277         if(likely(i != start))
1278             buffer_strcat(wb, separator);
1279
1280         if(all_values_are_null) {
1281             if(options & RRDR_OPTION_NULL2ZERO)
1282                 buffer_strcat(wb, "0");
1283             else
1284                 buffer_strcat(wb, "null");
1285         }
1286         else
1287             buffer_rrd_value(wb, v);
1288     }
1289     buffer_strcat(wb, suffix);
1290     //info("RRD2SSV(): %s: END", r->st->id);
1291 }
1292
1293 inline static calculated_number *rrdr_line_values(RRDR *r)
1294 {
1295     return &r->v[ r->c * r->d ];
1296 }
1297
1298 inline static uint8_t *rrdr_line_options(RRDR *r)
1299 {
1300     return &r->o[ r->c * r->d ];
1301 }
1302
1303 inline static int rrdr_line_init(RRDR *r, time_t t)
1304 {
1305     r->c++;
1306
1307     if(unlikely(r->c >= r->n)) {
1308         error("requested to step above RRDR size for chart %s", r->st->name);
1309         r->c = r->n - 1;
1310     }
1311
1312     // save the time
1313     r->t[r->c] = t;
1314
1315     return 1;
1316 }
1317
1318 inline static void rrdr_lock_rrdset(RRDR *r) {
1319     if(unlikely(!r)) {
1320         error("NULL value given!");
1321         return;
1322     }
1323
1324     pthread_rwlock_rdlock(&r->st->rwlock);
1325     r->has_st_lock = 1;
1326 }
1327
1328 inline static void rrdr_unlock_rrdset(RRDR *r) {
1329     if(unlikely(!r)) {
1330         error("NULL value given!");
1331         return;
1332     }
1333
1334     if(likely(r->has_st_lock)) {
1335         pthread_rwlock_unlock(&r->st->rwlock);
1336         r->has_st_lock = 0;
1337     }
1338 }
1339
1340 inline static void rrdr_free(RRDR *r)
1341 {
1342     if(unlikely(!r)) {
1343         error("NULL value given!");
1344         return;
1345     }
1346
1347     rrdr_unlock_rrdset(r);
1348     freez(r->t);
1349     freez(r->v);
1350     freez(r->o);
1351     freez(r->od);
1352     freez(r);
1353 }
1354
1355 static inline void rrdr_done(RRDR *r)
1356 {
1357     r->rows = r->c + 1;
1358     r->c = 0;
1359 }
1360
1361 static RRDR *rrdr_create(RRDSET *st, long n)
1362 {
1363     if(unlikely(!st)) {
1364         error("NULL value given!");
1365         return NULL;
1366     }
1367
1368     RRDR *r = callocz(1, sizeof(RRDR));
1369     r->st = st;
1370
1371     rrdr_lock_rrdset(r);
1372
1373     RRDDIM *rd;
1374     for(rd = st->dimensions ; rd ; rd = rd->next) r->d++;
1375
1376     r->n = n;
1377
1378     r->t = mallocz(n * sizeof(time_t));
1379     r->v = mallocz(n * r->d * sizeof(calculated_number));
1380     r->o = mallocz(n * r->d * sizeof(uint8_t));
1381     r->od = mallocz(r->d * sizeof(uint8_t));
1382
1383     // set the hidden flag on hidden dimensions
1384     int c;
1385     for(c = 0, rd = st->dimensions ; rd ; c++, rd = rd->next) {
1386         if(unlikely(rd->flags & RRDDIM_FLAG_HIDDEN)) r->od[c] = RRDR_HIDDEN;
1387         else r->od[c] = 0;
1388     }
1389
1390     r->c = -1;
1391     r->group = 1;
1392     r->update_every = 1;
1393
1394     return r;
1395 }
1396
1397 RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int group_method, int aligned)
1398 {
1399     int debug = st->debug;
1400     int absolute_period_requested = -1;
1401
1402     time_t first_entry_t = rrdset_first_entry_t(st);
1403     time_t last_entry_t  = rrdset_last_entry_t(st);
1404
1405     if(before == 0 && after == 0) {
1406         // dump the all the data
1407         before = last_entry_t;
1408         after = first_entry_t;
1409         absolute_period_requested = 0;
1410     }
1411
1412     // allow relative for before (smaller than API_RELATIVE_TIME_MAX)
1413     if(((before < 0)?-before:before) <= API_RELATIVE_TIME_MAX) {
1414         if(abs(before) % st->update_every) {
1415             // make sure it is multiple of st->update_every
1416             if(before < 0) before = before - st->update_every - before % st->update_every;
1417             else           before = before + st->update_every - before % st->update_every;
1418         }
1419         if(before > 0) before = first_entry_t + before;
1420         else           before = last_entry_t  + before;
1421         absolute_period_requested = 0;
1422     }
1423
1424     // allow relative for after (smaller than API_RELATIVE_TIME_MAX)
1425     if(((after < 0)?-after:after) <= API_RELATIVE_TIME_MAX) {
1426         if(after == 0) after = -st->update_every;
1427         if(abs(after) % st->update_every) {
1428             // make sure it is multiple of st->update_every
1429             if(after < 0) after = after - st->update_every - after % st->update_every;
1430             else          after = after + st->update_every - after % st->update_every;
1431         }
1432         after = before + after;
1433         absolute_period_requested = 0;
1434     }
1435
1436     if(absolute_period_requested == -1)
1437         absolute_period_requested = 1;
1438
1439     // make sure they are within our timeframe
1440     if(before > last_entry_t)  before = last_entry_t;
1441     if(before < first_entry_t) before = first_entry_t;
1442
1443     if(after > last_entry_t)  after = last_entry_t;
1444     if(after < first_entry_t) after = first_entry_t;
1445
1446     // check if they are upside down
1447     if(after > before) {
1448         time_t tmp = before;
1449         before = after;
1450         after = tmp;
1451     }
1452
1453     // the duration of the chart
1454     time_t duration = before - after;
1455     long available_points = duration / st->update_every;
1456
1457     if(duration <= 0 || available_points <= 0)
1458         return rrdr_create(st, 1);
1459
1460     // check the wanted points
1461     if(points < 0) points = -points;
1462     if(points > available_points) points = available_points;
1463     if(points == 0) points = available_points;
1464
1465     // calculate proper grouping of source data
1466     long group = available_points / points;
1467     if(group <= 0) group = 1;
1468
1469     // round group to the closest integer
1470     if(available_points % points > points / 2) group++;
1471
1472     time_t after_new  = (aligned) ? (after  - (after  % (group * st->update_every))) : after;
1473     time_t before_new = (aligned) ? (before - (before % (group * st->update_every))) : before;
1474     long points_new   = (before_new - after_new) / st->update_every / group;
1475
1476     // find the starting and ending slots in our round robin db
1477     long    start_at_slot = rrdset_time2slot(st, before_new),
1478             stop_at_slot  = rrdset_time2slot(st, after_new);
1479
1480 #ifdef NETDATA_INTERNAL_CHECKS
1481     if(after_new < first_entry_t) {
1482         error("after_new %u is too small, minimum %u", (uint32_t)after_new, (uint32_t)first_entry_t);
1483     }
1484     if(after_new > last_entry_t) {
1485         error("after_new %u is too big, maximum %u", (uint32_t)after_new, (uint32_t)last_entry_t);
1486     }
1487     if(before_new < first_entry_t) {
1488         error("before_new %u is too small, minimum %u", (uint32_t)before_new, (uint32_t)first_entry_t);
1489     }
1490     if(before_new > last_entry_t) {
1491         error("before_new %u is too big, maximum %u", (uint32_t)before_new, (uint32_t)last_entry_t);
1492     }
1493     if(start_at_slot < 0 || start_at_slot >= st->entries) {
1494         error("start_at_slot is invalid %ld, expected 0 to %ld", start_at_slot, st->entries - 1);
1495     }
1496     if(stop_at_slot < 0 || stop_at_slot >= st->entries) {
1497         error("stop_at_slot is invalid %ld, expected 0 to %ld", stop_at_slot, st->entries - 1);
1498     }
1499     if(points_new > (before_new - after_new) / group / st->update_every + 1) {
1500         error("points_new %ld is more than points %ld", points_new, (before_new - after_new) / group / st->update_every + 1);
1501     }
1502 #endif
1503
1504     //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);
1505
1506     after = after_new;
1507     before = before_new;
1508     duration = before - after;
1509     points = points_new;
1510
1511     // Now we have:
1512     // before = the end time of the calculation
1513     // after = the start time of the calculation
1514     // duration = the duration of the calculation
1515     // group = the number of source points to aggregate / group together
1516     // method = the method of grouping source points
1517     // points = the number of points to generate
1518
1519
1520     // -------------------------------------------------------------------------
1521     // initialize our result set
1522
1523     RRDR *r = rrdr_create(st, points);
1524     if(!r) {
1525 #ifdef NETDATA_INTERNAL_CHECKS
1526         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);
1527 #endif
1528         return NULL;
1529     }
1530     if(!r->d) {
1531 #ifdef NETDATA_INTERNAL_CHECKS
1532         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);
1533 #endif
1534         return r;
1535     }
1536
1537     if(absolute_period_requested == 1)
1538         r->result_options |= RRDR_RESULT_OPTION_ABSOLUTE;
1539     else
1540         r->result_options |= RRDR_RESULT_OPTION_RELATIVE;
1541
1542     // find how many dimensions we have
1543     long dimensions = r->d;
1544
1545
1546     // -------------------------------------------------------------------------
1547     // checks for debugging
1548
1549     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"
1550             , st->id
1551             , (uint32_t)first_entry_t
1552             , (uint32_t)last_entry_t
1553             , (uint32_t)(last_entry_t - first_entry_t)
1554             , (uint32_t)after
1555             , (uint32_t)before
1556             , (uint32_t)duration
1557             , points
1558             , group
1559             );
1560
1561
1562     // -------------------------------------------------------------------------
1563     // temp arrays for keeping values per dimension
1564
1565     calculated_number   last_values[dimensions]; // keep the last value of each dimension
1566     calculated_number   group_values[dimensions]; // keep sums when grouping
1567     long                group_counts[dimensions]; // keep the number of values added to group_values
1568     uint8_t             group_options[dimensions];
1569     uint8_t             found_non_zero[dimensions];
1570
1571
1572     // initialize them
1573     RRDDIM *rd;
1574     long c;
1575     for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1576         last_values[c] = 0;
1577         group_values[c] = (group_method == GROUP_MAX || group_method == GROUP_MIN)?NAN:0;
1578         group_counts[c] = 0;
1579         group_options[c] = 0;
1580         found_non_zero[c] = 0;
1581     }
1582
1583
1584     // -------------------------------------------------------------------------
1585     // the main loop
1586
1587     time_t  now = rrdset_slot2time(st, start_at_slot),
1588             dt = st->update_every,
1589             group_start_t = 0;
1590
1591     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"
1592             , st->id
1593             , (uint32_t)after
1594             , stop_at_slot
1595             , (uint32_t)before
1596             , start_at_slot
1597             , (uint32_t)now
1598             , st->current_entry
1599             , st->entries
1600             );
1601
1602     r->group = group;
1603     r->update_every = group * st->update_every;
1604     r->before = now;
1605     r->after = now;
1606
1607     //info("RRD2RRDR(): %s: STARTING", st->id);
1608
1609     long slot = start_at_slot, counter = 0, stop_now = 0, added = 0, group_count = 0, add_this = 0;
1610     for(; !stop_now ; now -= dt, slot--, counter++) {
1611         if(unlikely(slot < 0)) slot = st->entries - 1;
1612         if(unlikely(slot == stop_at_slot)) stop_now = counter;
1613
1614         if(unlikely(debug)) debug(D_RRD_STATS, "ROW %s slot: %ld, entries_counter: %ld, group_count: %ld, added: %ld, now: %ld, %s %s"
1615                 , st->id
1616                 , slot
1617                 , counter
1618                 , group_count + 1
1619                 , added
1620                 , now
1621                 , (group_count + 1 == group)?"PRINT":"  -  "
1622                 , (now >= after && now <= before)?"RANGE":"  -  "
1623                 );
1624
1625         // make sure we return data in the proper time range
1626         if(unlikely(now > before)) continue;
1627         if(unlikely(now < after)) break;
1628
1629         if(unlikely(group_count == 0)) {
1630             group_start_t = now;
1631         }
1632         group_count++;
1633
1634         if(unlikely(group_count == group)) {
1635             if(unlikely(added >= points)) break;
1636             add_this = 1;
1637         }
1638
1639         // do the calculations
1640         for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1641             storage_number n = rd->values[slot];
1642             if(unlikely(!does_storage_number_exist(n))) continue;
1643
1644             group_counts[c]++;
1645
1646             calculated_number value = unpack_storage_number(n);
1647             if(likely(value != 0.0)) {
1648                 group_options[c] |= RRDR_NONZERO;
1649                 found_non_zero[c] = 1;
1650             }
1651
1652             if(unlikely(did_storage_number_reset(n)))
1653                 group_options[c] |= RRDR_RESET;
1654
1655             switch(group_method) {
1656                 case GROUP_MIN:
1657                     if(unlikely(isnan(group_values[c])) ||
1658                             fabsl(value) < fabsl(group_values[c]))
1659                         group_values[c] = value;
1660                     break;
1661
1662                 case GROUP_MAX:
1663                     if(unlikely(isnan(group_values[c])) ||
1664                             fabsl(value) > fabsl(group_values[c]))
1665                         group_values[c] = value;
1666                     break;
1667
1668                 default:
1669                 case GROUP_SUM:
1670                 case GROUP_AVERAGE:
1671                 case GROUP_UNDEFINED:
1672                     group_values[c] += value;
1673                     break;
1674
1675                 case GROUP_INCREMENTAL_SUM:
1676                     if(unlikely(slot == start_at_slot))
1677                         last_values[c] = value;
1678
1679                     group_values[c] += last_values[c] - value;
1680                     last_values[c] = value;
1681                     break;
1682             }
1683         }
1684
1685         // added it
1686         if(unlikely(add_this)) {
1687             if(unlikely(!rrdr_line_init(r, group_start_t))) break;
1688
1689             r->after = now;
1690
1691             calculated_number *cn = rrdr_line_values(r);
1692             uint8_t *co = rrdr_line_options(r);
1693
1694             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
1695
1696                 // update the dimension options
1697                 if(likely(found_non_zero[c])) r->od[c] |= RRDR_NONZERO;
1698
1699                 // store the specific point options
1700                 co[c] = group_options[c];
1701
1702                 // store the value
1703                 if(unlikely(group_counts[c] == 0)) {
1704                     cn[c] = 0.0;
1705                     co[c] |= RRDR_EMPTY;
1706                     group_values[c] = (group_method == GROUP_MAX || group_method == GROUP_MIN)?NAN:0;
1707                 }
1708                 else {
1709                     switch(group_method) {
1710                         case GROUP_MIN:
1711                         case GROUP_MAX:
1712                             if(unlikely(isnan(group_values[c])))
1713                                 cn[c] = 0;
1714                             else {
1715                                 cn[c] = group_values[c];
1716                                 group_values[c] = NAN;
1717                             }
1718                             break;
1719
1720                         case GROUP_SUM:
1721                         case GROUP_INCREMENTAL_SUM:
1722                             cn[c] = group_values[c];
1723                             group_values[c] = 0;
1724                             break;
1725
1726                         default:
1727                         case GROUP_AVERAGE:
1728                         case GROUP_UNDEFINED:
1729                             cn[c] = group_values[c] / group_counts[c];
1730                             group_values[c] = 0;
1731                             break;
1732                     }
1733
1734                     if(cn[c] < r->min) r->min = cn[c];
1735                     if(cn[c] > r->max) r->max = cn[c];
1736                 }
1737
1738                 // reset for the next loop
1739                 group_counts[c] = 0;
1740                 group_options[c] = 0;
1741             }
1742
1743             added++;
1744             group_count = 0;
1745             add_this = 0;
1746         }
1747     }
1748
1749     rrdr_done(r);
1750     //info("RRD2RRDR(): %s: END %ld loops made, %ld points generated", st->id, counter, rrdr_rows(r));
1751     //error("SHIFT: %s: wanted %ld points, got %ld", st->id, points, rrdr_rows(r));
1752     return r;
1753 }
1754
1755 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)
1756 {
1757     RRDR *r = rrd2rrdr(st, points, after, before, group_method, !(options & RRDR_OPTION_NOT_ALIGNED));
1758     if(!r) {
1759         if(value_is_null) *value_is_null = 1;
1760         return 500;
1761     }
1762
1763     if(rrdr_rows(r) == 0) {
1764         rrdr_free(r);
1765
1766         if(db_after)  *db_after  = 0;
1767         if(db_before) *db_before = 0;
1768         if(value_is_null) *value_is_null = 1;
1769
1770         return 400;
1771     }
1772
1773     if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
1774         buffer_no_cacheable(wb);
1775     else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
1776         buffer_cacheable(wb);
1777
1778     options = rrdr_check_options(r, options, dimensions);
1779
1780     if(dimensions)
1781         rrdr_disable_not_selected_dimensions(r, dimensions);
1782
1783     if(db_after)  *db_after  = r->after;
1784     if(db_before) *db_before = r->before;
1785
1786     long i = (options & RRDR_OPTION_REVERSED)?rrdr_rows(r) - 1:0;
1787     *n = rrdr2value(r, i, options, value_is_null);
1788
1789     rrdr_free(r);
1790     return 200;
1791 }
1792
1793 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)
1794 {
1795     RRDR *r = rrd2rrdr(st, points, after, before, group_method, !(options & RRDR_OPTION_NOT_ALIGNED));
1796     if(!r) {
1797         buffer_strcat(wb, "Cannot generate output with these parameters on this chart.");
1798         return 500;
1799     }
1800
1801     if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
1802         buffer_no_cacheable(wb);
1803     else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
1804         buffer_cacheable(wb);
1805
1806     options = rrdr_check_options(r, options, (dimensions)?buffer_tostring(dimensions):NULL);
1807
1808     if(dimensions)
1809         rrdr_disable_not_selected_dimensions(r, buffer_tostring(dimensions));
1810
1811     if(latest_timestamp && rrdr_rows(r) > 0)
1812         *latest_timestamp = r->before;
1813
1814     switch(format) {
1815     case DATASOURCE_SSV:
1816         if(options & RRDR_OPTION_JSON_WRAP) {
1817             wb->contenttype = CT_APPLICATION_JSON;
1818             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1819             rrdr2ssv(r, wb, options, "", " ", "");
1820             rrdr_json_wrapper_end(r, wb, format, options, 1);
1821         }
1822         else {
1823             wb->contenttype = CT_TEXT_PLAIN;
1824             rrdr2ssv(r, wb, options, "", " ", "");
1825         }
1826         break;
1827
1828     case DATASOURCE_SSV_COMMA:
1829         if(options & RRDR_OPTION_JSON_WRAP) {
1830             wb->contenttype = CT_APPLICATION_JSON;
1831             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1832             rrdr2ssv(r, wb, options, "", ",", "");
1833             rrdr_json_wrapper_end(r, wb, format, options, 1);
1834         }
1835         else {
1836             wb->contenttype = CT_TEXT_PLAIN;
1837             rrdr2ssv(r, wb, options, "", ",", "");
1838         }
1839         break;
1840
1841     case DATASOURCE_JS_ARRAY:
1842         if(options & RRDR_OPTION_JSON_WRAP) {
1843             wb->contenttype = CT_APPLICATION_JSON;
1844             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1845             rrdr2ssv(r, wb, options, "[", ",", "]");
1846             rrdr_json_wrapper_end(r, wb, format, options, 0);
1847         }
1848         else {
1849             wb->contenttype = CT_APPLICATION_JSON;
1850             rrdr2ssv(r, wb, options, "[", ",", "]");
1851         }
1852         break;
1853
1854     case DATASOURCE_CSV:
1855         if(options & RRDR_OPTION_JSON_WRAP) {
1856             wb->contenttype = CT_APPLICATION_JSON;
1857             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1858             rrdr2csv(r, wb, options, "", ",", "\\n", "");
1859             rrdr_json_wrapper_end(r, wb, format, options, 1);
1860         }
1861         else {
1862             wb->contenttype = CT_TEXT_PLAIN;
1863             rrdr2csv(r, wb, options, "", ",", "\r\n", "");
1864         }
1865         break;
1866
1867     case DATASOURCE_CSV_JSON_ARRAY:
1868         wb->contenttype = CT_APPLICATION_JSON;
1869         if(options & RRDR_OPTION_JSON_WRAP) {
1870             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1871             buffer_strcat(wb, "[\n");
1872             rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
1873             buffer_strcat(wb, "\n]");
1874             rrdr_json_wrapper_end(r, wb, format, options, 0);
1875         }
1876         else {
1877             wb->contenttype = CT_TEXT_PLAIN;
1878             buffer_strcat(wb, "[\n");
1879             rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
1880             buffer_strcat(wb, "\n]");
1881         }
1882         break;
1883
1884     case DATASOURCE_TSV:
1885         if(options & RRDR_OPTION_JSON_WRAP) {
1886             wb->contenttype = CT_APPLICATION_JSON;
1887             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1888             rrdr2csv(r, wb, options, "", "\t", "\\n", "");
1889             rrdr_json_wrapper_end(r, wb, format, options, 1);
1890         }
1891         else {
1892             wb->contenttype = CT_TEXT_PLAIN;
1893             rrdr2csv(r, wb, options, "", "\t", "\r\n", "");
1894         }
1895         break;
1896
1897     case DATASOURCE_HTML:
1898         if(options & RRDR_OPTION_JSON_WRAP) {
1899             wb->contenttype = CT_APPLICATION_JSON;
1900             rrdr_json_wrapper_begin(r, wb, format, options, 1);
1901             buffer_strcat(wb, "<html>\\n<center>\\n<table border=\\\"0\\\" cellpadding=\\\"5\\\" cellspacing=\\\"5\\\">\\n");
1902             rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\\n", "");
1903             buffer_strcat(wb, "</table>\\n</center>\\n</html>\\n");
1904             rrdr_json_wrapper_end(r, wb, format, options, 1);
1905         }
1906         else {
1907             wb->contenttype = CT_TEXT_HTML;
1908             buffer_strcat(wb, "<html>\n<center>\n<table border=\"0\" cellpadding=\"5\" cellspacing=\"5\">\n");
1909             rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\n", "");
1910             buffer_strcat(wb, "</table>\n</center>\n</html>\n");
1911         }
1912         break;
1913
1914     case DATASOURCE_DATATABLE_JSONP:
1915         wb->contenttype = CT_APPLICATION_X_JAVASCRIPT;
1916
1917         if(options & RRDR_OPTION_JSON_WRAP)
1918             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1919
1920         rrdr2json(r, wb, options, 1);
1921
1922         if(options & RRDR_OPTION_JSON_WRAP)
1923             rrdr_json_wrapper_end(r, wb, format, options, 0);
1924         break;
1925
1926     case DATASOURCE_DATATABLE_JSON:
1927         wb->contenttype = CT_APPLICATION_JSON;
1928
1929         if(options & RRDR_OPTION_JSON_WRAP)
1930             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1931
1932         rrdr2json(r, wb, options, 1);
1933
1934         if(options & RRDR_OPTION_JSON_WRAP)
1935             rrdr_json_wrapper_end(r, wb, format, options, 0);
1936         break;
1937
1938     case DATASOURCE_JSONP:
1939         wb->contenttype = CT_APPLICATION_X_JAVASCRIPT;
1940         if(options & RRDR_OPTION_JSON_WRAP)
1941             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1942
1943         rrdr2json(r, wb, options, 0);
1944
1945         if(options & RRDR_OPTION_JSON_WRAP)
1946             rrdr_json_wrapper_end(r, wb, format, options, 0);
1947         break;
1948
1949     case DATASOURCE_JSON:
1950     default:
1951         wb->contenttype = CT_APPLICATION_JSON;
1952
1953         if(options & RRDR_OPTION_JSON_WRAP)
1954             rrdr_json_wrapper_begin(r, wb, format, options, 0);
1955
1956         rrdr2json(r, wb, options, 0);
1957
1958         if(options & RRDR_OPTION_JSON_WRAP)
1959             rrdr_json_wrapper_end(r, wb, format, options, 0);
1960         break;
1961     }
1962
1963     rrdr_free(r);
1964     return 200;
1965 }
1966
1967 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)
1968 {
1969     int c;
1970     pthread_rwlock_rdlock(&st->rwlock);
1971
1972
1973     // -------------------------------------------------------------------------
1974     // switch from JSON to google JSON
1975
1976     char kq[2] = "\"";
1977     char sq[2] = "\"";
1978     switch(type) {
1979         case DATASOURCE_DATATABLE_JSON:
1980         case DATASOURCE_DATATABLE_JSONP:
1981             kq[0] = '\0';
1982             sq[0] = '\'';
1983             break;
1984
1985         case DATASOURCE_JSON:
1986         default:
1987             break;
1988     }
1989
1990
1991     // -------------------------------------------------------------------------
1992     // validate the parameters
1993
1994     if(points < 1) points = 1;
1995     if(group < 1) group = 1;
1996
1997     if(before == 0 || before > rrdset_last_entry_t(st)) before = rrdset_last_entry_t(st);
1998     if(after  == 0 || after < rrdset_first_entry_t(st)) after = rrdset_first_entry_t(st);
1999
2000     // ---
2001
2002     // our return value (the last timestamp printed)
2003     // this is required to detect re-transmit in google JSONP
2004     time_t last_timestamp = 0;
2005
2006
2007     // -------------------------------------------------------------------------
2008     // find how many dimensions we have
2009
2010     int dimensions = 0;
2011     RRDDIM *rd;
2012     for( rd = st->dimensions ; rd ; rd = rd->next) dimensions++;
2013     if(!dimensions) {
2014         pthread_rwlock_unlock(&st->rwlock);
2015         buffer_strcat(wb, "No dimensions yet.");
2016         return 0;
2017     }
2018
2019
2020     // -------------------------------------------------------------------------
2021     // prepare various strings, to speed up the loop
2022
2023     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);
2024     char normal_annotation[201];   snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
2025     char pre_date[51];             snprintfz(pre_date,             50, "        {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
2026     char post_date[21];            snprintfz(post_date,            20, "%s}", sq);
2027     char pre_value[21];            snprintfz(pre_value,            20, ",{%sv%s:", kq, kq);
2028     char post_value[21];           strcpy(post_value,                  "}");
2029
2030
2031     // -------------------------------------------------------------------------
2032     // checks for debugging
2033
2034     if(st->debug) {
2035         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"
2036             , st->id
2037             , rrdset_first_entry_t(st)
2038             , rrdset_last_entry_t(st)
2039             , rrdset_last_entry_t(st) - rrdset_first_entry_t(st)
2040             , after
2041             , before
2042             , before - after
2043             , points
2044             , group
2045             );
2046
2047         if(before < after)
2048             debug(D_RRD_STATS, "WARNING: %s The newest value in the database (%ld) is earlier than the oldest (%ld)", st->name, before, after);
2049
2050         if((before - after) > st->entries * st->update_every)
2051             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);
2052     }
2053
2054
2055     // -------------------------------------------------------------------------
2056     // temp arrays for keeping values per dimension
2057
2058     calculated_number group_values[dimensions]; // keep sums when grouping
2059     int               print_hidden[dimensions]; // keep hidden flags
2060     int               found_non_zero[dimensions];
2061     int               found_non_existing[dimensions];
2062
2063     // initialize them
2064     for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2065         group_values[c] = 0;
2066         print_hidden[c] = (rd->flags & RRDDIM_FLAG_HIDDEN)?1:0;
2067         found_non_zero[c] = 0;
2068         found_non_existing[c] = 0;
2069     }
2070
2071
2072     // 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);
2073     // rrd2array(st, entries_to_show, before - (st->update_every * group * entries_to_show), before, group_method, only_non_zero);
2074     // rrd2rrdr(st, entries_to_show, before - (st->update_every * group * entries_to_show), before, group_method);
2075
2076     // -------------------------------------------------------------------------
2077     // remove dimensions that contain only zeros
2078
2079     int max_loop = 1;
2080     if(only_non_zero) max_loop = 2;
2081
2082     for(; max_loop ; max_loop--) {
2083
2084         // -------------------------------------------------------------------------
2085         // print the JSON header
2086
2087         buffer_sprintf(wb, "{\n %scols%s:\n [\n", kq, kq);
2088         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);
2089         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);
2090         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);
2091
2092         // print the header for each dimension
2093         // and update the print_hidden array for the dimensions that should be hidden
2094         int pc = 0;
2095         for( rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2096             if(!print_hidden[c]) {
2097                 pc++;
2098                 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);
2099             }
2100         }
2101         if(!pc) {
2102             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);
2103         }
2104
2105         // print the begin of row data
2106         buffer_sprintf(wb, "\n  ],\n    %srows%s:\n [\n", kq, kq);
2107
2108
2109         // -------------------------------------------------------------------------
2110         // the main loop
2111
2112         int annotate_reset = 0;
2113         int annotation_count = 0;
2114
2115         long    t = rrdset_time2slot(st, before),
2116                 stop_at_t = rrdset_time2slot(st, after),
2117                 stop_now = 0;
2118
2119         t -= t % group;
2120
2121         time_t  now = rrdset_slot2time(st, t),
2122                 dt = st->update_every;
2123
2124         long count = 0, printed = 0, group_count = 0;
2125         last_timestamp = 0;
2126
2127         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"
2128                     , st->id
2129                     , (uint32_t)after
2130                     , (uint32_t)before
2131                     , points
2132                     , group
2133                     , st->current_entry
2134                     , (uint32_t)rrdset_first_entry_t(st)
2135                     , (uint32_t)rrdset_last_entry_t(st)
2136                     , t
2137                     , stop_at_t
2138                     );
2139
2140         long counter = 0;
2141         for(; !stop_now ; now -= dt, t--, counter++) {
2142             if(t < 0) t = st->entries - 1;
2143             if(t == stop_at_t) stop_now = counter;
2144
2145             int print_this = 0;
2146
2147             if(st->debug) debug(D_RRD_STATS, "%s t = %ld, count = %ld, group_count = %ld, printed = %ld, now = %ld, %s %s"
2148                     , st->id
2149                     , t
2150                     , count + 1
2151                     , group_count + 1
2152                     , printed
2153                     , now
2154                     , (group_count + 1 == group)?"PRINT":"  -  "
2155                     , (now >= after && now <= before)?"RANGE":"  -  "
2156                     );
2157
2158
2159             // make sure we return data in the proper time range
2160             if(now > before) continue;
2161             if(now < after) break;
2162
2163             //if(rrdset_slot2time(st, t) != now)
2164             //  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));
2165
2166             count++;
2167             group_count++;
2168
2169             // check if we have to print this now
2170             if(group_count == group) {
2171                 if(printed >= points) {
2172                     // debug(D_RRD_STATS, "Already printed all rows. Stopping.");
2173                     break;
2174                 }
2175
2176                 // generate the local date time
2177                 struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
2178                 if(!tm) { error("localtime() failed."); continue; }
2179                 if(now > last_timestamp) last_timestamp = now;
2180
2181                 if(printed) buffer_strcat(wb, "]},\n");
2182                 buffer_strcat(wb, pre_date);
2183                 buffer_jsdate(wb, tm->tm_year + 1900, tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
2184                 buffer_strcat(wb, post_date);
2185
2186                 print_this = 1;
2187             }
2188
2189             // do the calculations
2190             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2191                 storage_number n = rd->values[t];
2192                 calculated_number value = unpack_storage_number(n);
2193
2194                 if(!does_storage_number_exist(n)) {
2195                     value = 0.0;
2196                     found_non_existing[c]++;
2197                 }
2198                 if(did_storage_number_reset(n)) annotate_reset = 1;
2199
2200                 switch(group_method) {
2201                     case GROUP_MAX:
2202                         if(abs(value) > abs(group_values[c])) group_values[c] = value;
2203                         break;
2204
2205                     case GROUP_SUM:
2206                         group_values[c] += value;
2207                         break;
2208
2209                     default:
2210                     case GROUP_AVERAGE:
2211                         group_values[c] += value;
2212                         if(print_this) group_values[c] /= ( group_count - found_non_existing[c] );
2213                         break;
2214                 }
2215             }
2216
2217             if(print_this) {
2218                 if(annotate_reset) {
2219                     annotation_count++;
2220                     buffer_strcat(wb, overflow_annotation);
2221                     annotate_reset = 0;
2222                 }
2223                 else
2224                     buffer_strcat(wb, normal_annotation);
2225
2226                 pc = 0;
2227                 for(c = 0 ; c < dimensions ; c++) {
2228                     if(found_non_existing[c] == group_count) {
2229                         // all entries are non-existing
2230                         pc++;
2231                         buffer_strcat(wb, pre_value);
2232                         buffer_strcat(wb, "null");
2233                         buffer_strcat(wb, post_value);
2234                     }
2235                     else if(!print_hidden[c]) {
2236                         pc++;
2237                         buffer_strcat(wb, pre_value);
2238                         buffer_rrd_value(wb, group_values[c]);
2239                         buffer_strcat(wb, post_value);
2240
2241                         if(group_values[c]) found_non_zero[c]++;
2242                     }
2243
2244                     // reset them for the next loop
2245                     group_values[c] = 0;
2246                     found_non_existing[c] = 0;
2247                 }
2248
2249                 // if all dimensions are hidden, print a null
2250                 if(!pc) {
2251                     buffer_strcat(wb, pre_value);
2252                     buffer_strcat(wb, "null");
2253                     buffer_strcat(wb, post_value);
2254                 }
2255
2256                 printed++;
2257                 group_count = 0;
2258             }
2259         }
2260
2261         if(printed) buffer_strcat(wb, "]}");
2262         buffer_strcat(wb, "\n   ]\n}\n");
2263
2264         if(only_non_zero && max_loop > 1) {
2265             int changed = 0;
2266             for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
2267                 group_values[c] = 0;
2268                 found_non_existing[c] = 0;
2269
2270                 if(!print_hidden[c] && !found_non_zero[c]) {
2271                     changed = 1;
2272                     print_hidden[c] = 1;
2273                 }
2274             }
2275
2276             if(changed) buffer_flush(wb);
2277             else break;
2278         }
2279         else break;
2280
2281     } // max_loop
2282
2283     debug(D_RRD_STATS, "RRD_STATS_JSON: %s total %lu bytes", st->name, wb->len);
2284
2285     pthread_rwlock_unlock(&st->rwlock);
2286     return last_timestamp;
2287 }