]> arthur.barton.de Git - netdata.git/blobdiff - src/rrd2json.c
added support for generating SVG badges with chart data
[netdata.git] / src / rrd2json.c
old mode 100755 (executable)
new mode 100644 (file)
index bbf132b..5adaab0
@@ -2,9 +2,10 @@
 #include <config.h>
 #endif
 #include <pthread.h>
-#include <sys/time.h>
 #include <stdlib.h>
 #include <string.h>
+#include <stdint.h>
+#include <math.h>
 
 #include "log.h"
 #include "common.h"
@@ -23,6 +24,7 @@ void rrd_stats_api_v1_chart(RRDSET *st, BUFFER *wb)
                "\t\t\t\"name\": \"%s\",\n"
                "\t\t\t\"type\": \"%s\",\n"
                "\t\t\t\"family\": \"%s\",\n"
+               "\t\t\t\"context\": \"%s\",\n"
                "\t\t\t\"title\": \"%s\",\n"
                "\t\t\t\"priority\": %ld,\n"
                "\t\t\t\"enabled\": %s,\n"
@@ -38,6 +40,7 @@ void rrd_stats_api_v1_chart(RRDSET *st, BUFFER *wb)
                , st->name
                , st->type
                , st->family
+               , st->context
                , st->title
                , st->priority
                , st->enabled?"true":"false"
@@ -122,6 +125,7 @@ unsigned long rrd_stats_one_json(RRDSET *st, char *options, BUFFER *wb)
                "\t\t\t\"name\": \"%s\",\n"
                "\t\t\t\"type\": \"%s\",\n"
                "\t\t\t\"family\": \"%s\",\n"
+               "\t\t\t\"context\": \"%s\",\n"
                "\t\t\t\"title\": \"%s\",\n"
                "\t\t\t\"priority\": %ld,\n"
                "\t\t\t\"enabled\": %d,\n"
@@ -144,6 +148,7 @@ unsigned long rrd_stats_one_json(RRDSET *st, char *options, BUFFER *wb)
                , st->name
                , st->type
                , st->family
+               , st->context
                , st->title
                , st->priority
                , st->enabled
@@ -259,19 +264,24 @@ void rrd_stats_all_json(BUFFER *wb)
 
 // ----------------------------------------------------------------------------
 
-// RRDR options
+// RRDR dimension options
 #define RRDR_EMPTY     0x01 // the dimension contains / the value is empty (null)
 #define RRDR_RESET     0x02 // the dimension contains / the value is reset
 #define RRDR_HIDDEN    0x04 // the dimension contains / the value is hidden
 #define RRDR_NONZERO   0x08 // the dimension contains / the value is non-zero
 
+// RRDR result options
+#define RRDR_RESULT_OPTION_ABSOLUTE 0x00000001
+#define RRDR_RESULT_OPTION_RELATIVE 0x00000002
 
 typedef struct rrdresult {
        RRDSET *st;                     // the chart this result refers to
 
+       uint32_t result_options;        // RRDR_RESULT_OPTION_*
+
        int d;                                  // the number of dimensions
-       int n;                                  // the number of values in the arrays
-       int rows;                       // the number of rows used
+       long n;                                 // the number of values in the arrays
+       long rows;                          // the number of rows used
 
        uint8_t *od;                    // the options for the dimensions
 
@@ -279,10 +289,10 @@ typedef struct rrdresult {
        calculated_number *v;   // array n x d values
        uint8_t *o;                             // array n x d options
 
-       int c;                                  // current line ( -1 ~ n ), ( -1 = none, use rrdr_rows() to get number of rows )
+       long c;                                 // current line ( -1 ~ n ), ( -1 = none, use rrdr_rows() to get number of rows )
 
-       int group;                              // how many collected values were grouped for each row
-       int update_every;               // what is the suggested update frequency in seconds
+       long group;                             // how many collected values were grouped for each row
+       long update_every;              // what is the suggested update frequency in seconds
 
        calculated_number min;
        calculated_number max;
@@ -371,6 +381,11 @@ void rrdr_disable_not_selected_dimensions(RRDR *r, const char *dims)
                for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
                        if(!strcmp(d->name, tok)) {
                                r->od[c] &= ~RRDR_HIDDEN;
+
+                               // since the user needs this dimension
+                               // make it appear as NONZERO, to return it
+                               // even if the dimension has only zeros
+                               r->od[c] |= RRDR_NONZERO;
                        }
                }
        }
@@ -425,8 +440,43 @@ void rrdr_buffer_print_format(BUFFER *wb, uint32_t format)
        }
 }
 
+uint32_t rrdr_check_options(RRDR *r, uint32_t options, const char *dims)
+{
+       if(options & RRDR_OPTION_NONZERO) {
+               long i;
+
+               if(dims && *dims) {
+                       // the caller wants specific dimensions
+                       // disable NONZERO option
+                       // to make sure we don't accidentally prevent
+                       // the specific dimensions from being returned
+                       i = 0;
+               }
+               else {
+                       // find how many dimensions are not zero
+                       long c;
+                       RRDDIM *rd;
+                       for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ; c++, rd = rd->next) {
+                               if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
+                               if(unlikely(!(r->od[c] & RRDR_NONZERO))) continue;
+                               i++;
+                       }
+               }
+
+               // if with nonzero we get i = 0 (no dimensions will be returned)
+               // disable nonzero to show all dimensions
+               if(!i) options &= ~RRDR_OPTION_NONZERO;
+       }
+
+       return options;
+}
+
 void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t options, int string_value)
 {
+       long rows = rrdr_rows(r);
+       long c, i;
+       RRDDIM *rd;
+
        //info("JSONWRAPPER(): %s: BEGIN", r->st->id);
        char kq[2] = "",                                        // key quote
                sq[2] = "";                                             // string quote
@@ -441,36 +491,28 @@ void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t opti
        }
 
        buffer_sprintf(wb, "{\n"
+                       "       %sapi%s: 1,\n"
                        "       %sid%s: %s%s%s,\n"
                        "       %sname%s: %s%s%s,\n"
                        "       %sview_update_every%s: %d,\n"
                        "       %supdate_every%s: %d,\n"
-                       "       %sfirst_entry_t%s: %u, \n"
-                       "       %slast_entry_t%s: %u, \n"
-                       "       %smin%s: "
+                       "       %sfirst_entry%s: %u,\n"
+                       "       %slast_entry%s: %u,\n"
+                       "       %sbefore%s: %u,\n"
+                       "       %safter%s: %u,\n"
+                       "       %sdimension_names%s: ["
+                       , kq, kq
                        , kq, kq, sq, r->st->id, sq
                        , kq, kq, sq, r->st->name, sq
                        , kq, kq, r->update_every
                        , kq, kq, r->st->update_every
                        , kq, kq, rrdset_first_entry_t(r->st)
                        , kq, kq, rrdset_last_entry_t(r->st)
-                       , kq, kq);
-
-       buffer_rrd_value(wb, r->min);
-       buffer_sprintf(wb, ",\n %smax%s: ", kq, kq);
-       buffer_rrd_value(wb, r->max);
-       buffer_sprintf(wb, ",\n"
-                       "       %sbefore%s: %u,\n"
-                       "       %safter%s: %u,\n"
-                       "       %sdimension_names%s: ["
                        , kq, kq, r->before
                        , kq, kq, r->after
                        , kq, kq);
 
-
-       long c, i;
-       RRDDIM *rd;
-       for(c = 0, i = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
+       for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
                if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
@@ -480,11 +522,21 @@ void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t opti
                buffer_strcat(wb, sq);
                i++;
        }
+       if(!i) {
+#ifdef NETDATA_INTERNAL_CHECKS
+               error("RRDR is empty for %s (RRDR has %d dimensions, options is 0x%08x)", r->st->id, r->d, options);
+#endif
+               rows = 0;
+               buffer_strcat(wb, sq);
+               buffer_strcat(wb, "no data");
+               buffer_strcat(wb, sq);
+       }
+
        buffer_sprintf(wb, "],\n"
                        "       %sdimension_ids%s: ["
                        , kq, kq);
 
-       for(c = 0, i = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
+       for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
                if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
@@ -494,12 +546,69 @@ void rrdr_json_wrapper_begin(RRDR *r, BUFFER *wb, uint32_t format, uint32_t opti
                buffer_strcat(wb, sq);
                i++;
        }
+       if(!i) {
+               rows = 0;
+               buffer_strcat(wb, sq);
+               buffer_strcat(wb, "no data");
+               buffer_strcat(wb, sq);
+       }
+
+       buffer_sprintf(wb, "],\n"
+                       "       %slatest_values%s: ["
+                       , kq, kq);
+
+       for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
+               if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
+               if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
+
+               if(i) buffer_strcat(wb, ", ");
+               i++;
+
+               storage_number n = rd->values[rrdset_last_slot(r->st)];
+
+               if(!does_storage_number_exist(n))
+                       buffer_strcat(wb, "null");
+               else
+                       buffer_rrd_value(wb, unpack_storage_number(n));
+       }
+       if(!i) {
+               rows = 0;
+               buffer_strcat(wb, "null");
+       }
+
+       buffer_sprintf(wb, "],\n"
+                       "       %sview_latest_values%s: ["
+                       , kq, kq);
+
+       i = 0;
+       if(rows) {
+               for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
+                       if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
+                       if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
+
+                       if(i) buffer_strcat(wb, ", ");
+                       i++;
+
+                       calculated_number *cn = &r->v[ (0) * r->d ];
+                       uint8_t *co = &r->o[ (0) * r->d ];
+
+                       if(co[c] & RRDR_EMPTY)
+                               buffer_strcat(wb, "null");
+                       else
+                               buffer_rrd_value(wb, cn[c]);
+               }
+       }
+       if(!i) {
+               rows = 0;
+               buffer_strcat(wb, "null");
+       }
+
        buffer_sprintf(wb, "],\n"
                        "       %sdimensions%s: %d,\n"
                        "       %spoints%s: %d,\n"
                        "       %sformat%s: %s"
                        , kq, kq, i
-                       , kq, kq, rrdr_rows(r)
+                       , kq, kq, rows
                        , kq, kq, sq
                        );
 
@@ -520,14 +629,24 @@ void rrdr_json_wrapper_end(RRDR *r, BUFFER *wb, uint32_t format, uint32_t option
        if(r) {;}
        if(format) {;}
 
-       char sq[2] = "";                                                // string quote
+       char kq[2] = "",                                        // key quote
+               sq[2] = "";                                             // string quote
 
-       if( options & RRDR_OPTION_GOOGLE_JSON )
+       if( options & RRDR_OPTION_GOOGLE_JSON ) {
+               kq[0] = '\0';
                sq[0] = '\'';
-       else
+       }
+       else {
+               kq[0] = '"';
                sq[0] = '"';
+       }
 
        if(string_value) buffer_strcat(wb, sq);
+
+       buffer_sprintf(wb, ",\n %smin%s: ", kq, kq);
+       buffer_rrd_value(wb, r->min);
+       buffer_sprintf(wb, ",\n %smax%s: ", kq, kq);
+       buffer_rrd_value(wb, r->max);
        buffer_strcat(wb, "\n}\n");
 }
 
@@ -537,7 +656,7 @@ void rrdr_json_wrapper_end(RRDR *r, BUFFER *wb, uint32_t format, uint32_t option
 static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
 {
        //info("RRD2JSON(): %s: BEGIN", r->st->id);
-       int row_annotations = 0, dates = JSON_DATES_JS, dates_with_new = 0;
+       int row_annotations = 0, dates, dates_with_new = 0;
        char kq[2] = "",                                        // key quote
                sq[2] = "",                                             // string quote
                pre_label[101] = "",                    // before each label
@@ -563,18 +682,18 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
                        sq[0] = '"';
                }
                row_annotations = 1;
-               snprintf(pre_date,   100, "             {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
-               snprintf(post_date,  100, "%s}", sq);
-               snprintf(pre_label,  100, ",\n          {%sid%s:%s%s,%slabel%s:%s", kq, kq, sq, sq, kq, kq, sq);
-               snprintf(post_label, 100, "%s,%spattern%s:%s%s,%stype%s:%snumber%s}", sq, kq, kq, sq, sq, kq, kq, sq, sq);
-               snprintf(pre_value,  100, ",{%sv%s:", kq, kq);
-               snprintf(post_value, 100, "}");
-               snprintf(post_line,  100, "]}");
-               snprintf(data_begin, 100, "\n   ],\n    %srows%s:\n     [\n", kq, kq);
-               snprintf(finish,     100, "\n   ]\n}\n");
-
-               snprintf(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);
-               snprintf(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
+               snprintfz(pre_date,   100, "            {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
+               snprintfz(post_date,  100, "%s}", sq);
+               snprintfz(pre_label,  100, ",\n         {%sid%s:%s%s,%slabel%s:%s", kq, kq, sq, sq, kq, kq, sq);
+               snprintfz(post_label, 100, "%s,%spattern%s:%s%s,%stype%s:%snumber%s}", sq, kq, kq, sq, sq, kq, kq, sq, sq);
+               snprintfz(pre_value,  100, ",{%sv%s:", kq, kq);
+               strcpy(post_value,         "}");
+               strcpy(post_line,          "]}");
+               snprintfz(data_begin, 100, "\n  ],\n    %srows%s:\n     [\n", kq, kq);
+               strcpy(finish,             "\n  ]\n}");
+
+               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);
+               snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
 
                buffer_sprintf(wb, "{\n %scols%s:\n     [\n", kq, kq, kq, kq);
                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);
@@ -598,18 +717,18 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
                        dates_with_new = 1;
                }
                if( options & RRDR_OPTION_OBJECTSROWS )
-                       snprintf(pre_date,   100, "             { ");
+                       strcpy(pre_date, "              { ");
                else
-                       snprintf(pre_date,   100, "             [ ");
-               snprintf(pre_label,  100, ", \"");
-               snprintf(post_label, 100, "\"");
-               snprintf(pre_value,  100, ", ");
+                       strcpy(pre_date, "              [ ");
+               strcpy(pre_label,  ", \"");
+               strcpy(post_label, "\"");
+               strcpy(pre_value,  ", ");
                if( options & RRDR_OPTION_OBJECTSROWS )
-                       snprintf(post_line,  100, "}");
+                       strcpy(post_line, "}");
                else
-                       snprintf(post_line,  100, "]");
-               snprintf(data_begin, 100, "],\n %sdata%s:\n     [\n", kq, kq);
-               snprintf(finish,     100, "\n   ]\n}\n");
+                       strcpy(post_line, "]");
+               snprintfz(data_begin, 100, "],\n        %sdata%s:\n     [\n", kq, kq);
+               strcpy(finish,             "\n  ]\n}");
 
                buffer_sprintf(wb, "{\n %slabels%s: [", kq, kq);
                buffer_sprintf(wb, "%stime%s", sq, sq);
@@ -622,7 +741,7 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
        RRDDIM *rd;
 
        // print the header lines
-       for(c = 0, i = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
+       for(c = 0, i = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
                if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
@@ -654,6 +773,7 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
        }
 
        // for each line in the array
+       calculated_number total = 1;
        for(i = start; i != end ;i += step) {
                calculated_number *cn = &r->v[ i * r->d ];
                uint8_t *co = &r->o[ i * r->d ];
@@ -707,8 +827,22 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
                        buffer_strcat(wb, post_date);
                }
 
+               if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
+                       total = 0;
+                       for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
+                               calculated_number n = cn[c];
+
+                               if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                                       n = -n;
+
+                               total += n;
+                       }
+                       // prevent a division by zero
+                       if(total == 0) total = 1;
+               }
+
                // for each dimension
-               for(c = 0, rd = r->st->dimensions; rd ;c++, rd = rd->next) {
+               for(c = 0, rd = r->st->dimensions; rd && c < r->d ;c++, rd = rd->next) {
                        if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                        if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
@@ -725,10 +859,15 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
                                else
                                        buffer_strcat(wb, "null");
                        }
-                       else if((options & RRDR_OPTION_ABSOLUTE))
-                               buffer_rrd_value(wb, (n<0)?-n:n);
-                       else
+                       else {
+                               if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                                       n = -n;
+
+                               if(unlikely(options & RRDR_OPTION_PERCENTAGE))
+                                       n = n * 100 / total;
+
                                buffer_rrd_value(wb, n);
+                       }
 
                        buffer_strcat(wb, post_value);
                }
@@ -740,23 +879,27 @@ static void rrdr2json(RRDR *r, BUFFER *wb, uint32_t options, int datatable)
        //info("RRD2JSON(): %s: END", r->st->id);
 }
 
-static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startline, const char *separator, const char *endline)
+static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startline, const char *separator, const char *endline, const char *betweenlines)
 {
        //info("RRD2CSV(): %s: BEGIN", r->st->id);
        long c, i;
        RRDDIM *d;
 
        // print the csv header
-       for(c = 0, i = 0, d = r->st->dimensions; d ;c++, d = d->next) {
+       for(c = 0, i = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
                if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
                if(!i) {
                        buffer_strcat(wb, startline);
+                       if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
                        buffer_strcat(wb, "time");
+                       if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
                }
                buffer_strcat(wb, separator);
+               if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
                buffer_strcat(wb, d->name);
+               if(options & RRDR_OPTION_LABEL_QUOTES) buffer_strcat(wb, "\"");
                i++;
        }
        buffer_strcat(wb, endline);
@@ -774,10 +917,12 @@ static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startlin
        }
 
        // for each line in the array
+       calculated_number total = 1;
        for(i = start; i != end ;i += step) {
                calculated_number *cn = &r->v[ i * r->d ];
                uint8_t *co = &r->o[ i * r->d ];
 
+               buffer_strcat(wb, betweenlines);
                buffer_strcat(wb, startline);
 
                time_t now = r->t[i];
@@ -792,11 +937,25 @@ static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startlin
                        // generate the local date time
                        struct tm tmbuf, *tm = localtime_r(&now, &tmbuf);
                        if(!tm) { error("localtime() failed."); continue; }
-                       buffer_date(wb, tm->tm_year + 1900, tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
+                       buffer_date(wb, tm->tm_year + 1900, tm->tm_mon + 1, tm->tm_mday, tm->tm_hour, tm->tm_min, tm->tm_sec);
+               }
+
+               if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
+                       total = 0;
+                       for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
+                               calculated_number n = cn[c];
+
+                               if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                                       n = -n;
+
+                               total += n;
+                       }
+                       // prevent a division by zero
+                       if(total == 0) total = 1;
                }
 
                // for each dimension
-               for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
+               for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
                        if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
                        if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
 
@@ -810,10 +969,15 @@ static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startlin
                                else
                                        buffer_strcat(wb, "null");
                        }
-                       else if((options & RRDR_OPTION_ABSOLUTE))
-                               buffer_rrd_value(wb, (n<0)?-n:n);
-                       else
+                       else {
+                               if(unlikely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                                       n = -n;
+
+                               if(unlikely(options & RRDR_OPTION_PERCENTAGE))
+                                       n = n * 100 / total;
+
                                buffer_rrd_value(wb, n);
+                       }
                }
 
                buffer_strcat(wb, endline);
@@ -821,11 +985,87 @@ static void rrdr2csv(RRDR *r, BUFFER *wb, uint32_t options, const char *startlin
        //info("RRD2CSV(): %s: END", r->st->id);
 }
 
+inline static calculated_number rrdr2value(RRDR *r, long i, uint32_t options, int *all_values_are_null) {
+       long c;
+       RRDDIM *d;
+
+       calculated_number *cn = &r->v[ i * r->d ];
+       uint8_t *co = &r->o[ i * r->d ];
+
+       calculated_number sum = 0, min = 0, max = 0, v;
+       int all_null = 1, init = 1;
+
+       calculated_number total = 1;
+       if(unlikely(options & RRDR_OPTION_PERCENTAGE)) {
+               total = 0;
+               for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
+                       calculated_number n = cn[c];
+
+                       if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                               n = -n;
+
+                       total += n;
+               }
+               // prevent a division by zero
+               if(total == 0) total = 1;
+       }
+
+       // for each dimension
+       for(c = 0, d = r->st->dimensions; d && c < r->d ;c++, d = d->next) {
+               if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
+               if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
+
+               calculated_number n = cn[c];
+
+               if(likely((options & RRDR_OPTION_ABSOLUTE) && n < 0))
+                       n = -n;
+
+               if(unlikely(options & RRDR_OPTION_PERCENTAGE))
+                       n = n * 100 / total;
+
+               if(unlikely(init)) {
+                       if(n > 0) {
+                               min = 0;
+                               max = n;
+                       }
+                       else {
+                               min = n;
+                               max = 0;
+                       }
+                       init = 0;
+               }
+
+               if(likely(!(co[c] & RRDR_EMPTY))) {
+                       all_null = 0;
+                       sum += n;
+               }
+
+               if(n < min) min = n;
+               if(n > max) max = n;
+       }
+
+       if(unlikely(all_null)) {
+               if(likely(*all_values_are_null))
+                       *all_values_are_null = 1;
+               return 0;
+       }
+       else {
+               if(likely(*all_values_are_null))
+                       *all_values_are_null = 0;
+       }
+
+       if(options & RRDR_OPTION_MIN2MAX)
+               v = max - min;
+       else
+               v = sum;
+
+       return v;
+}
+
 static void rrdr2ssv(RRDR *r, BUFFER *wb, uint32_t options, const char *prefix, const char *separator, const char *suffix)
 {
        //info("RRD2SSV(): %s: BEGIN", r->st->id);
-       long c, i;
-       RRDDIM *d;
+       long i;
 
        buffer_strcat(wb, prefix);
        long start = 0, end = rrdr_rows(r), step = 1;
@@ -837,55 +1077,29 @@ static void rrdr2ssv(RRDR *r, BUFFER *wb, uint32_t options, const char *prefix,
 
        // for each line in the array
        for(i = start; i != end ;i += step) {
+               int all_values_are_null = 0;
+               calculated_number v = rrdr2value(r, i, options, &all_values_are_null);
 
-               calculated_number *cn = &r->v[ i * r->d ];
-               uint8_t *co = &r->o[ i * r->d ];
-
-               calculated_number sum = 0, min = 0, max = 0;
-               int all_null = 1, init = 1;
-
-               // for each dimension
-               for(c = 0, d = r->st->dimensions; d ;c++, d = d->next) {
-                       if(unlikely(r->od[c] & RRDR_HIDDEN)) continue;
-                       if(unlikely((options & RRDR_OPTION_NONZERO) && !(r->od[c] & RRDR_NONZERO))) continue;
-
-                       calculated_number n = cn[c];
-
-                       if(unlikely(init)) {
-                               if(n > 0) {
-                                       min = 0;
-                                       max = n;
-                               }
-                               else {
-                                       min = n;
-                                       max = 0;
-                               }
-                               init = 0;
-                       }
-
-                       if(likely(!(co[c] & RRDR_EMPTY))) {
-                               all_null = 0;
-                               if((options & RRDR_OPTION_ABSOLUTE) && n < 0) n = -n;
-                               sum += n;
-                       }
-
-                       if(n < min) min = n;
-                       if(n > max) max = n;
+               if(likely(i != start)) {
+                       if(r->min > v) r->min = v;
+                       if(r->max < v) r->max = v;
+               }
+               else {
+                       r->min = v;
+                       r->max = v;
                }
 
                if(likely(i != start))
                        buffer_strcat(wb, separator);
 
-               if(all_null) {
+               if(all_values_are_null) {
                        if(options & RRDR_OPTION_NULL2ZERO)
                                buffer_strcat(wb, "0");
                        else
                                buffer_strcat(wb, "null");
                }
-               else if(options & RRDR_OPTION_MIN2MAX)
-                       buffer_rrd_value(wb, max - min);
                else
-                       buffer_rrd_value(wb, sum);
+                       buffer_rrd_value(wb, v);
        }
        buffer_strcat(wb, suffix);
        //info("RRD2SSV(): %s: END", r->st->id);
@@ -959,7 +1173,7 @@ inline void rrdr_done(RRDR *r)
        r->c = 0;
 }
 
-static RRDR *rrdr_create(RRDSET *st, int n)
+static RRDR *rrdr_create(RRDSET *st, long n)
 {
        if(unlikely(!st)) {
                error("NULL value given!");
@@ -990,6 +1204,13 @@ static RRDR *rrdr_create(RRDSET *st, int n)
        r->od = malloc(r->d * sizeof(uint8_t));
        if(unlikely(!r->od)) goto cleanup;
 
+       // set the hidden flag on hidden dimensions
+       int c;
+       for(c = 0, rd = st->dimensions ; rd ; c++, rd = rd->next) {
+               if(unlikely(rd->flags & RRDDIM_FLAG_HIDDEN)) r->od[c] = RRDR_HIDDEN;
+               else r->od[c] = 0;
+       }
+
        r->c = -1;
 
        r->group = 1;
@@ -1006,6 +1227,7 @@ cleanup:
 RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int group_method)
 {
        int debug = st->debug;
+       int absolute_period_requested = -1;
 
        time_t first_entry_t = rrdset_first_entry_t(st);
        time_t last_entry_t = rrdset_last_entry_t(st);
@@ -1013,14 +1235,22 @@ RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int g
        if(before == 0 && after == 0) {
                before = last_entry_t;
                after = first_entry_t;
+               absolute_period_requested = 0;
        }
 
        // allow relative for before and after
-       if(before <= st->update_every * st->entries)
+       if(before <= st->update_every * st->entries) {
                before = last_entry_t + before;
+               absolute_period_requested = 0;
+       }
 
-       if(after <= st->update_every * st->entries)
+       if(after <= st->update_every * st->entries) {
                after = last_entry_t + after;
+               absolute_period_requested = 0;
+       }
+
+       if(absolute_period_requested == -1)
+               absolute_period_requested = 1;
 
        // make sure they are within our timeframe
        if(before > last_entry_t) before = last_entry_t;
@@ -1107,8 +1337,23 @@ RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int g
        // initialize our result set
 
        RRDR *r = rrdr_create(st, points);
-       if(!r) return NULL;
-       if(!r->d) return r;
+       if(!r) {
+#ifdef NETDATA_INTERNAL_CHECKS
+               error("Cannot create RRDR for %s, after=%u, before=%u, duration=%u, points=%d", st->id, after, before, duration, points);
+#endif
+               return NULL;
+       }
+       if(!r->d) {
+#ifdef NETDATA_INTERNAL_CHECKS
+               error("Returning empty RRDR (no dimensions in RRDSET) for %s, after=%u, before=%u, duration=%u, points=%d", st->id, after, before, duration, points);
+#endif
+               return r;
+       }
+
+       if(absolute_period_requested == 1)
+               r->result_options |= RRDR_RESULT_OPTION_ABSOLUTE;
+       else
+               r->result_options |= RRDR_RESULT_OPTION_RELATIVE;
 
        // find how many dimensions we have
        long dimensions = r->d;
@@ -1223,7 +1468,7 @@ RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int g
 
                        switch(group_method) {
                                case GROUP_MAX:
-                                       if(unlikely(abs(value) > abs(group_values[c])))
+                                       if(unlikely(fabsl(value) > fabsl(group_values[c])))
                                                group_values[c] = value;
                                        break;
 
@@ -1244,11 +1489,10 @@ RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int g
                        calculated_number *cn = rrdr_line_values(r);
                        uint8_t *co = rrdr_line_options(r);
 
-                       for(rd = st->dimensions, c = 0 ; likely(rd && c < dimensions) ; rd = rd->next, c++) {
+                       for(rd = st->dimensions, c = 0 ; rd && c < dimensions ; rd = rd->next, c++) {
 
                                // update the dimension options
                                if(likely(found_non_zero[c])) r->od[c] |= RRDR_NONZERO;
-                               if(unlikely(rd->flags & RRDDIM_FLAG_HIDDEN)) r->od[c] |= RRDR_HIDDEN;
 
                                // store the specific point options
                                co[c] = group_options[c];
@@ -1286,6 +1530,40 @@ RRDR *rrd2rrdr(RRDSET *st, long points, long long after, long long before, int g
        return r;
 }
 
+int rrd2value(RRDSET *st, BUFFER *wb, calculated_number *n, BUFFER *dimensions, long points, long long after, long long before, int group_method, uint32_t options, time_t *latest_timestamp, int *value_is_null)
+{
+       RRDR *r = rrd2rrdr(st, points, after, before, group_method);
+       if(!r) {
+               if(value_is_null) *value_is_null = 1;
+               return 500;
+       }
+
+       if(rrdr_rows(r) == 0) {
+               rrdr_free(r);
+               if(value_is_null) *value_is_null = 1;
+               return 400;
+       }
+
+       if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
+               wb->options |= WB_CONTENT_NO_CACHEABLE;
+       else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
+               wb->options |= WB_CONTENT_CACHEABLE;
+
+       options = rrdr_check_options(r, options, (dimensions)?buffer_tostring(dimensions):NULL);
+
+       if(dimensions)
+               rrdr_disable_not_selected_dimensions(r, buffer_tostring(dimensions));
+
+       if(latest_timestamp)
+               *latest_timestamp = r->before;
+
+       long i = (options & RRDR_OPTION_REVERSED)?rrdr_rows(r) - 1:0;
+       *n = rrdr2value(r, i, options, value_is_null);
+
+       rrdr_free(r);
+       return 200;
+}
+
 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)
 {
        RRDR *r = rrd2rrdr(st, points, after, before, group_method);
@@ -1294,6 +1572,13 @@ int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long
                return 500;
        }
 
+       if(r->result_options & RRDR_RESULT_OPTION_RELATIVE)
+               wb->options |= WB_CONTENT_NO_CACHEABLE;
+       else if(r->result_options & RRDR_RESULT_OPTION_ABSOLUTE)
+               wb->options |= WB_CONTENT_CACHEABLE;
+
+       options = rrdr_check_options(r, options, (dimensions)?buffer_tostring(dimensions):NULL);
+
        if(dimensions)
                rrdr_disable_not_selected_dimensions(r, buffer_tostring(dimensions));
 
@@ -1344,12 +1629,29 @@ int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long
                if(options & RRDR_OPTION_JSON_WRAP) {
                        wb->contenttype = CT_APPLICATION_JSON;
                        rrdr_json_wrapper_begin(r, wb, format, options, 1);
-                       rrdr2csv(r, wb, options, "", ",", "\\n");
+                       rrdr2csv(r, wb, options, "", ",", "\\n", "");
                        rrdr_json_wrapper_end(r, wb, format, options, 1);
                }
                else {
                        wb->contenttype = CT_TEXT_PLAIN;
-                       rrdr2csv(r, wb, options, "", ",", "\r\n");
+                       rrdr2csv(r, wb, options, "", ",", "\r\n", "");
+               }
+               break;
+
+       case DATASOURCE_CSV_JSON_ARRAY:
+               wb->contenttype = CT_APPLICATION_JSON;
+               if(options & RRDR_OPTION_JSON_WRAP) {
+                       rrdr_json_wrapper_begin(r, wb, format, options, 0);
+                       buffer_strcat(wb, "[\n");
+                       rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
+                       buffer_strcat(wb, "\n]");
+                       rrdr_json_wrapper_end(r, wb, format, options, 0);
+               }
+               else {
+                       wb->contenttype = CT_TEXT_PLAIN;
+                       buffer_strcat(wb, "[\n");
+                       rrdr2csv(r, wb, options + RRDR_OPTION_LABEL_QUOTES, "[", ",", "]", ",\n");
+                       buffer_strcat(wb, "\n]");
                }
                break;
 
@@ -1357,12 +1659,12 @@ int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long
                if(options & RRDR_OPTION_JSON_WRAP) {
                        wb->contenttype = CT_APPLICATION_JSON;
                        rrdr_json_wrapper_begin(r, wb, format, options, 1);
-                       rrdr2csv(r, wb, options, "", "\t", "\\n");
+                       rrdr2csv(r, wb, options, "", "\t", "\\n", "");
                        rrdr_json_wrapper_end(r, wb, format, options, 1);
                }
                else {
                        wb->contenttype = CT_TEXT_PLAIN;
-                       rrdr2csv(r, wb, options, "", "\t", "\r\n");
+                       rrdr2csv(r, wb, options, "", "\t", "\r\n", "");
                }
                break;
 
@@ -1371,14 +1673,14 @@ int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long
                        wb->contenttype = CT_APPLICATION_JSON;
                        rrdr_json_wrapper_begin(r, wb, format, options, 1);
                        buffer_strcat(wb, "<html>\\n<center>\\n<table border=\\\"0\\\" cellpadding=\\\"5\\\" cellspacing=\\\"5\\\">\\n");
-                       rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\\n");
+                       rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\\n", "");
                        buffer_strcat(wb, "</table>\\n</center>\\n</html>\\n");
                        rrdr_json_wrapper_end(r, wb, format, options, 1);
                }
                else {
                        wb->contenttype = CT_TEXT_HTML;
                        buffer_strcat(wb, "<html>\n<center>\n<table border=\"0\" cellpadding=\"5\" cellspacing=\"5\">\n");
-                       rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\n");
+                       rrdr2csv(r, wb, options, "<tr><td>", "</td><td>", "</td></tr>\n", "");
                        buffer_strcat(wb, "</table>\n</center>\n</html>\n");
                }
                break;
@@ -1436,7 +1738,7 @@ int rrd2format(RRDSET *st, BUFFER *wb, BUFFER *dimensions, uint32_t format, long
        return 200;
 }
 
-unsigned long rrd_stats_json(int type, RRDSET *st, BUFFER *wb, int points, int group, int group_method, time_t after, time_t before, int only_non_zero)
+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)
 {
        int c;
        pthread_rwlock_rdlock(&st->rwlock);
@@ -1492,12 +1794,12 @@ unsigned long rrd_stats_json(int type, RRDSET *st, BUFFER *wb, int points, int g
        // -------------------------------------------------------------------------
        // prepare various strings, to speed up the loop
 
-       char overflow_annotation[201]; snprintf(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);
-       char normal_annotation[201];   snprintf(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
-       char pre_date[51];             snprintf(pre_date,             50, "             {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
-       char post_date[21];            snprintf(post_date,            20, "%s}", sq);
-       char pre_value[21];            snprintf(pre_value,            20, ",{%sv%s:", kq, kq);
-       char post_value[21];           snprintf(post_value,           20, "}");
+       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);
+       char normal_annotation[201];   snprintfz(normal_annotation,   200, ",{%sv%s:null},{%sv%s:null}", kq, kq, kq, kq);
+       char pre_date[51];             snprintfz(pre_date,             50, "            {%sc%s:[{%sv%s:%s", kq, kq, kq, kq, sq);
+       char post_date[21];            snprintfz(post_date,            20, "%s}", sq);
+       char pre_value[21];            snprintfz(pre_value,            20, ",{%sv%s:", kq, kq);
+       char post_value[21];           strcpy(post_value,                  "}");
 
 
        // -------------------------------------------------------------------------