14 #include <sys/types.h>
19 #include "appconfig.h"
24 #define RRD_DEFAULT_GAP_INTERPOLATIONS 1
26 // ----------------------------------------------------------------------------
29 // if not zero it gives the time (in seconds) to remove un-updated dimensions
31 // if dimensions are removed, the chart generation will have to run again
32 int rrd_delete_unupdated_dimensions = 0;
34 int rrd_update_every = UPDATE_EVERY;
35 int rrd_default_history_entries = RRD_DEFAULT_HISTORY_ENTRIES;
36 int rrd_memory_mode = RRD_MEMORY_MODE_SAVE;
38 static int rrdset_compare(void* a, void* b);
39 static int rrdset_compare_name(void* a, void* b);
42 .hostname = "localhost",
44 .rrdset_root_rwlock = PTHREAD_RWLOCK_INITIALIZER,
45 .rrdset_root_index = {
46 { NULL, rrdset_compare },
49 .rrdset_root_index_name = {
50 { NULL, rrdset_compare_name },
55 // ----------------------------------------------------------------------------
58 static int rrdset_compare(void* a, void* b) {
59 if(((RRDSET *)a)->hash < ((RRDSET *)b)->hash) return -1;
60 else if(((RRDSET *)a)->hash > ((RRDSET *)b)->hash) return 1;
61 else return strcmp(((RRDSET *)a)->id, ((RRDSET *)b)->id);
64 #define rrdset_index_add(host, st) avl_insert_lock(&((host)->rrdset_root_index), (avl *)(st))
65 #define rrdset_index_del(host, st) avl_remove_lock(&((host)->rrdset_root_index), (avl *)(st))
67 static RRDSET *rrdset_index_find(RRDHOST *host, const char *id, uint32_t hash) {
69 strncpyz(tmp.id, id, RRD_ID_LENGTH_MAX);
70 tmp.hash = (hash)?hash:simple_hash(tmp.id);
72 return (RRDSET *)avl_search_lock(&(host->rrdset_root_index), (avl *) &tmp);
75 // ----------------------------------------------------------------------------
78 #define rrdset_from_avlname(avlname_ptr) ((RRDSET *)((avlname_ptr) - offsetof(RRDSET, avlname)))
80 static int rrdset_compare_name(void* a, void* b) {
81 RRDSET *A = rrdset_from_avlname(a);
82 RRDSET *B = rrdset_from_avlname(b);
84 // fprintf(stderr, "COMPARING: %s with %s\n", A->name, B->name);
86 if(A->hash_name < B->hash_name) return -1;
87 else if(A->hash_name > B->hash_name) return 1;
88 else return strcmp(A->name, B->name);
91 RRDSET *rrdset_index_add_name(RRDHOST *host, RRDSET *st) {
92 // fprintf(stderr, "ADDING: %s (name: %s)\n", st->id, st->name);
93 return (RRDSET *)avl_insert_lock(&host->rrdset_root_index_name, (avl *) (&st->avlname));
96 #define rrdset_index_del_name(host, st) avl_remove_lock(&((host)->rrdset_root_index_name), (avl *)(&st->avlname))
98 static RRDSET *rrdset_index_find_name(RRDHOST *host, const char *name, uint32_t hash) {
102 tmp.hash_name = (hash)?hash:simple_hash(tmp.name);
104 // fprintf(stderr, "SEARCHING: %s\n", name);
105 result = avl_search_lock(&host->rrdset_root_index_name, (avl *) (&(tmp.avlname)));
107 RRDSET *st = rrdset_from_avlname(result);
108 if(strcmp(st->magic, RRDSET_MAGIC))
109 error("Search for RRDSET %s returned an invalid RRDSET %s (name %s)", name, st->id, st->name);
111 // fprintf(stderr, "FOUND: %s\n", name);
112 return rrdset_from_avlname(result);
114 // fprintf(stderr, "NOT FOUND: %s\n", name);
119 // ----------------------------------------------------------------------------
122 static int rrddim_compare(void* a, void* b) {
123 if(((RRDDIM *)a)->hash < ((RRDDIM *)b)->hash) return -1;
124 else if(((RRDDIM *)a)->hash > ((RRDDIM *)b)->hash) return 1;
125 else return strcmp(((RRDDIM *)a)->id, ((RRDDIM *)b)->id);
128 #define rrddim_index_add(st, rd) avl_insert_lock(&((st)->dimensions_index), (avl *)(rd))
129 #define rrddim_index_del(st,rd ) avl_remove_lock(&((st)->dimensions_index), (avl *)(rd))
131 static RRDDIM *rrddim_index_find(RRDSET *st, const char *id, uint32_t hash) {
133 strncpyz(tmp.id, id, RRD_ID_LENGTH_MAX);
134 tmp.hash = (hash)?hash:simple_hash(tmp.id);
136 return (RRDDIM *)avl_search_lock(&(st->dimensions_index), (avl *) &tmp);
139 // ----------------------------------------------------------------------------
142 int rrdset_type_id(const char *name)
144 if(unlikely(strcmp(name, RRDSET_TYPE_AREA_NAME) == 0)) return RRDSET_TYPE_AREA;
145 else if(unlikely(strcmp(name, RRDSET_TYPE_STACKED_NAME) == 0)) return RRDSET_TYPE_STACKED;
146 else if(unlikely(strcmp(name, RRDSET_TYPE_LINE_NAME) == 0)) return RRDSET_TYPE_LINE;
147 return RRDSET_TYPE_LINE;
150 const char *rrdset_type_name(int chart_type)
152 static char line[] = RRDSET_TYPE_LINE_NAME;
153 static char area[] = RRDSET_TYPE_AREA_NAME;
154 static char stacked[] = RRDSET_TYPE_STACKED_NAME;
157 case RRDSET_TYPE_LINE:
160 case RRDSET_TYPE_AREA:
163 case RRDSET_TYPE_STACKED:
169 // ----------------------------------------------------------------------------
172 const char *rrd_memory_mode_name(int id)
174 static const char ram[] = RRD_MEMORY_MODE_RAM_NAME;
175 static const char map[] = RRD_MEMORY_MODE_MAP_NAME;
176 static const char save[] = RRD_MEMORY_MODE_SAVE_NAME;
179 case RRD_MEMORY_MODE_RAM:
182 case RRD_MEMORY_MODE_MAP:
185 case RRD_MEMORY_MODE_SAVE:
193 int rrd_memory_mode_id(const char *name)
195 if(unlikely(!strcmp(name, RRD_MEMORY_MODE_RAM_NAME)))
196 return RRD_MEMORY_MODE_RAM;
197 else if(unlikely(!strcmp(name, RRD_MEMORY_MODE_MAP_NAME)))
198 return RRD_MEMORY_MODE_MAP;
200 return RRD_MEMORY_MODE_SAVE;
203 // ----------------------------------------------------------------------------
206 int rrddim_algorithm_id(const char *name)
208 if(strcmp(name, RRDDIM_INCREMENTAL_NAME) == 0) return RRDDIM_INCREMENTAL;
209 if(strcmp(name, RRDDIM_ABSOLUTE_NAME) == 0) return RRDDIM_ABSOLUTE;
210 if(strcmp(name, RRDDIM_PCENT_OVER_ROW_TOTAL_NAME) == 0) return RRDDIM_PCENT_OVER_ROW_TOTAL;
211 if(strcmp(name, RRDDIM_PCENT_OVER_DIFF_TOTAL_NAME) == 0) return RRDDIM_PCENT_OVER_DIFF_TOTAL;
212 return RRDDIM_ABSOLUTE;
215 const char *rrddim_algorithm_name(int chart_type)
217 static char absolute[] = RRDDIM_ABSOLUTE_NAME;
218 static char incremental[] = RRDDIM_INCREMENTAL_NAME;
219 static char percentage_of_absolute_row[] = RRDDIM_PCENT_OVER_ROW_TOTAL_NAME;
220 static char percentage_of_incremental_row[] = RRDDIM_PCENT_OVER_DIFF_TOTAL_NAME;
223 case RRDDIM_ABSOLUTE:
226 case RRDDIM_INCREMENTAL:
229 case RRDDIM_PCENT_OVER_ROW_TOTAL:
230 return percentage_of_absolute_row;
232 case RRDDIM_PCENT_OVER_DIFF_TOTAL:
233 return percentage_of_incremental_row;
238 // ----------------------------------------------------------------------------
241 char *rrdset_strncpyz_name(char *to, const char *from, size_t length)
245 while (length-- && (c = *from++)) {
246 if(c != '.' && !isalnum(c))
257 void rrdset_set_name(RRDSET *st, const char *name)
259 debug(D_RRD_CALLS, "rrdset_set_name() old: %s, new: %s", st->name, name);
261 if(st->name) rrdset_index_del_name(&localhost, st);
263 char b[CONFIG_MAX_VALUE + 1];
264 char n[RRD_ID_LENGTH_MAX + 1];
266 snprintfz(n, RRD_ID_LENGTH_MAX, "%s.%s", st->type, name);
267 rrdset_strncpyz_name(b, n, CONFIG_MAX_VALUE);
268 st->name = config_get(st->id, "name", b);
269 st->hash_name = simple_hash(st->name);
271 rrdset_index_add_name(&localhost, st);
274 // ----------------------------------------------------------------------------
277 char *rrdset_cache_dir(const char *id)
281 static char *cache_dir = NULL;
283 cache_dir = config_get("global", "cache directory", CACHE_DIR);
284 int r = mkdir(cache_dir, 0755);
285 if(r != 0 && errno != EEXIST)
286 error("Cannot create directory '%s'", cache_dir);
289 char b[FILENAME_MAX + 1];
290 char n[FILENAME_MAX + 1];
291 rrdset_strncpyz_name(b, id, FILENAME_MAX);
293 snprintfz(n, FILENAME_MAX, "%s/%s", cache_dir, b);
294 ret = config_get(id, "cache directory", n);
296 if(rrd_memory_mode == RRD_MEMORY_MODE_MAP || rrd_memory_mode == RRD_MEMORY_MODE_SAVE) {
297 int r = mkdir(ret, 0775);
298 if(r != 0 && errno != EEXIST)
299 error("Cannot create directory '%s'", ret);
305 // ----------------------------------------------------------------------------
308 void rrdset_reset(RRDSET *st)
310 debug(D_RRD_CALLS, "rrdset_reset() %s", st->name);
312 st->last_collected_time.tv_sec = 0;
313 st->last_collected_time.tv_usec = 0;
314 st->last_updated.tv_sec = 0;
315 st->last_updated.tv_usec = 0;
316 st->current_entry = 0;
318 st->counter_done = 0;
321 for(rd = st->dimensions; rd ; rd = rd->next) {
322 rd->last_collected_time.tv_sec = 0;
323 rd->last_collected_time.tv_usec = 0;
325 bzero(rd->values, rd->entries * sizeof(storage_number));
329 RRDSET *rrdset_create(const char *type, const char *id, const char *name, const char *family, const char *context, const char *title, const char *units, long priority, int update_every, int chart_type)
331 if(!type || !type[0]) {
332 fatal("Cannot create rrd stats without a type.");
337 fatal("Cannot create rrd stats without an id.");
341 char fullid[RRD_ID_LENGTH_MAX + 1];
342 char fullfilename[FILENAME_MAX + 1];
345 snprintfz(fullid, RRD_ID_LENGTH_MAX, "%s.%s", type, id);
347 st = rrdset_find(fullid);
349 error("Cannot create rrd stats for '%s', it already exists.", fullid);
353 long entries = config_get_number(fullid, "history", rrd_default_history_entries);
354 if(entries < 5) entries = config_set_number(fullid, "history", 5);
355 if(entries > RRD_HISTORY_ENTRIES_MAX) entries = config_set_number(fullid, "history", RRD_HISTORY_ENTRIES_MAX);
357 int enabled = config_get_boolean(fullid, "enabled", 1);
358 if(!enabled) entries = 5;
360 unsigned long size = sizeof(RRDSET);
361 char *cache_dir = rrdset_cache_dir(fullid);
363 debug(D_RRD_CALLS, "Creating RRD_STATS for '%s.%s'.", type, id);
365 snprintfz(fullfilename, FILENAME_MAX, "%s/main.db", cache_dir);
366 if(rrd_memory_mode != RRD_MEMORY_MODE_RAM) st = (RRDSET *)mymmap(fullfilename, size, ((rrd_memory_mode == RRD_MEMORY_MODE_MAP)?MAP_SHARED:MAP_PRIVATE), 0);
368 if(strcmp(st->magic, RRDSET_MAGIC) != 0) {
370 info("Initializing file %s.", fullfilename);
373 else if(strcmp(st->id, fullid) != 0) {
375 error("File %s contents are not for chart %s. Clearing it.", fullfilename, fullid);
380 else if(st->memsize != size || st->entries != entries) {
382 error("File %s does not have the desired size. Clearing it.", fullfilename);
385 else if(st->update_every != update_every) {
387 error("File %s does not have the desired update frequency. Clearing it.", fullfilename);
390 else if((time(NULL) - st->last_updated.tv_sec) > update_every * entries) {
392 error("File %s is too old. Clearing it.", fullfilename);
404 st->dimensions = NULL;
406 st->mapped = rrd_memory_mode;
409 st = calloc(1, size);
411 fatal("Cannot allocate memory for RRD_STATS %s.%s", type, id);
414 st->mapped = RRD_MEMORY_MODE_RAM;
417 st->entries = entries;
418 st->update_every = update_every;
420 if(st->current_entry >= st->entries) st->current_entry = 0;
422 strcpy(st->cache_filename, fullfilename);
423 strcpy(st->magic, RRDSET_MAGIC);
425 strcpy(st->id, fullid);
426 st->hash = simple_hash(st->id);
428 st->cache_dir = cache_dir;
430 st->chart_type = rrdset_type_id(config_get(st->id, "chart type", rrdset_type_name(chart_type)));
431 st->type = config_get(st->id, "type", type);
432 st->family = config_get(st->id, "family", family?family:st->type);
433 st->context = config_get(st->id, "context", context?context:st->id);
434 st->units = config_get(st->id, "units", units?units:"");
436 st->priority = config_get_number(st->id, "priority", priority);
437 st->enabled = enabled;
442 st->last_collected_time.tv_sec = 0;
443 st->last_collected_time.tv_usec = 0;
444 st->counter_done = 0;
446 st->gap_when_lost_iterations_above = (int) (
447 config_get_number(st->id, "gap when lost iterations above", RRD_DEFAULT_GAP_INTERPOLATIONS) + 2);
449 avl_init_lock(&st->dimensions_index, rrddim_compare);
451 pthread_rwlock_init(&st->rwlock, NULL);
452 pthread_rwlock_wrlock(&localhost.rrdset_root_rwlock);
454 if(name && *name) rrdset_set_name(st, name);
455 else rrdset_set_name(st, id);
458 char varvalue[CONFIG_MAX_VALUE + 1];
459 snprintfz(varvalue, CONFIG_MAX_VALUE, "%s (%s)", title?title:"", st->name);
460 st->title = config_get(st->id, "title", varvalue);
463 st->next = localhost.rrdset_root;
464 localhost.rrdset_root = st;
466 rrdset_index_add(&localhost, st);
468 pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
473 RRDDIM *rrddim_add(RRDSET *st, const char *id, const char *name, long multiplier, long divisor, int algorithm)
475 char filename[FILENAME_MAX + 1];
476 char fullfilename[FILENAME_MAX + 1];
478 char varname[CONFIG_MAX_NAME + 1];
480 unsigned long size = sizeof(RRDDIM) + (st->entries * sizeof(storage_number));
482 debug(D_RRD_CALLS, "Adding dimension '%s/%s'.", st->id, id);
484 rrdset_strncpyz_name(filename, id, FILENAME_MAX);
485 snprintfz(fullfilename, FILENAME_MAX, "%s/%s.db", st->cache_dir, filename);
486 if(rrd_memory_mode != RRD_MEMORY_MODE_RAM) rd = (RRDDIM *)mymmap(fullfilename, size, ((rrd_memory_mode == RRD_MEMORY_MODE_MAP)?MAP_SHARED:MAP_PRIVATE), 1);
489 gettimeofday(&now, NULL);
491 if(strcmp(rd->magic, RRDDIMENSION_MAGIC) != 0) {
493 info("Initializing file %s.", fullfilename);
496 else if(rd->memsize != size) {
498 error("File %s does not have the desired size. Clearing it.", fullfilename);
501 else if(rd->multiplier != multiplier) {
503 error("File %s does not have the same multiplier. Clearing it.", fullfilename);
506 else if(rd->divisor != divisor) {
508 error("File %s does not have the same divisor. Clearing it.", fullfilename);
511 else if(rd->algorithm != algorithm) {
513 error("File %s does not have the same algorithm. Clearing it.", fullfilename);
516 else if(rd->update_every != st->update_every) {
518 error("File %s does not have the same refresh frequency. Clearing it.", fullfilename);
521 else if(usecdiff(&now, &rd->last_collected_time) > (rd->entries * rd->update_every * 1000000ULL)) {
523 error("File %s is too old. Clearing it.", fullfilename);
526 else if(strcmp(rd->id, id) != 0) {
528 error("File %s contents are not for dimension %s. Clearing it.", fullfilename, id);
536 // we have a file mapped for rd
537 rd->mapped = rrd_memory_mode;
538 rd->flags = 0x00000000;
543 // if we didn't manage to get a mmap'd dimension, just create one
545 rd = calloc(1, size);
547 fatal("Cannot allocate RRD_DIMENSION %s/%s.", st->id, id);
551 rd->mapped = RRD_MEMORY_MODE_RAM;
555 strcpy(rd->magic, RRDDIMENSION_MAGIC);
556 strcpy(rd->cache_filename, fullfilename);
557 strncpyz(rd->id, id, RRD_ID_LENGTH_MAX);
558 rd->hash = simple_hash(rd->id);
560 snprintfz(varname, CONFIG_MAX_NAME, "dim %s name", rd->id);
561 rd->name = config_get(st->id, varname, (name && *name)?name:rd->id);
563 snprintfz(varname, CONFIG_MAX_NAME, "dim %s algorithm", rd->id);
564 rd->algorithm = rrddim_algorithm_id(config_get(st->id, varname, rrddim_algorithm_name(algorithm)));
566 snprintfz(varname, CONFIG_MAX_NAME, "dim %s multiplier", rd->id);
567 rd->multiplier = config_get_number(st->id, varname, multiplier);
569 snprintfz(varname, CONFIG_MAX_NAME, "dim %s divisor", rd->id);
570 rd->divisor = config_get_number(st->id, varname, divisor);
571 if(!rd->divisor) rd->divisor = 1;
573 rd->entries = st->entries;
574 rd->update_every = st->update_every;
576 // prevent incremental calculation spikes
579 rd->calculated_value = 0;
580 rd->last_calculated_value = 0;
581 rd->collected_value = 0;
582 rd->last_collected_value = 0;
583 rd->collected_volume = 0;
584 rd->stored_volume = 0;
585 rd->values[st->current_entry] = pack_storage_number(0, SN_NOT_EXISTS);
586 rd->last_collected_time.tv_sec = 0;
587 rd->last_collected_time.tv_usec = 0;
589 // append this dimension
590 pthread_rwlock_wrlock(&st->rwlock);
594 RRDDIM *td = st->dimensions;
595 for(; td->next; td = td->next) ;
598 pthread_rwlock_unlock(&st->rwlock);
600 rrddim_index_add(st, rd);
605 void rrddim_set_name(RRDSET *st, RRDDIM *rd, const char *name)
607 debug(D_RRD_CALLS, "rrddim_set_name() %s.%s", st->name, rd->name);
609 char varname[CONFIG_MAX_NAME + 1];
610 snprintfz(varname, CONFIG_MAX_NAME, "dim %s name", rd->id);
611 config_set_default(st->id, varname, name);
614 void rrddim_free(RRDSET *st, RRDDIM *rd)
616 debug(D_RRD_CALLS, "rrddim_free() %s.%s", st->name, rd->name);
618 RRDDIM *i, *last = NULL;
619 for(i = st->dimensions; i && i != rd ; i = i->next) last = i;
622 error("Request to free dimension %s.%s but it is not linked.", st->id, rd->name);
626 if(last) last->next = rd->next;
627 else st->dimensions = rd->next;
630 rrddim_index_del(st, rd);
632 // free(rd->annotations);
633 if(rd->mapped == RRD_MEMORY_MODE_SAVE) {
634 debug(D_RRD_CALLS, "Saving dimension '%s' to '%s'.", rd->name, rd->cache_filename);
635 savememory(rd->cache_filename, rd, rd->memsize);
637 debug(D_RRD_CALLS, "Unmapping dimension '%s'.", rd->name);
638 munmap(rd, rd->memsize);
640 else if(rd->mapped == RRD_MEMORY_MODE_MAP) {
641 debug(D_RRD_CALLS, "Unmapping dimension '%s'.", rd->name);
642 munmap(rd, rd->memsize);
645 debug(D_RRD_CALLS, "Removing dimension '%s'.", rd->name);
650 void rrdset_free_all(void)
652 info("Freeing all memory...");
655 for(st = localhost.rrdset_root; st ;) {
656 RRDSET *next = st->next;
658 while(st->dimensions)
659 rrddim_free(st, st->dimensions);
661 rrdset_index_del(&localhost, st);
663 if(st->mapped == RRD_MEMORY_MODE_SAVE) {
664 debug(D_RRD_CALLS, "Saving stats '%s' to '%s'.", st->name, st->cache_filename);
665 savememory(st->cache_filename, st, st->memsize);
667 debug(D_RRD_CALLS, "Unmapping stats '%s'.", st->name);
668 munmap(st, st->memsize);
670 else if(st->mapped == RRD_MEMORY_MODE_MAP) {
671 debug(D_RRD_CALLS, "Unmapping stats '%s'.", st->name);
672 munmap(st, st->memsize);
679 localhost.rrdset_root = NULL;
681 info("Memory cleanup completed...");
684 void rrdset_save_all(void) {
685 info("Saving database...");
690 pthread_rwlock_wrlock(&localhost.rrdset_root_rwlock);
691 for(st = localhost.rrdset_root; st ; st = st->next) {
692 pthread_rwlock_wrlock(&st->rwlock);
694 if(st->mapped == RRD_MEMORY_MODE_SAVE) {
695 debug(D_RRD_CALLS, "Saving stats '%s' to '%s'.", st->name, st->cache_filename);
696 savememory(st->cache_filename, st, st->memsize);
699 for(rd = st->dimensions; rd ; rd = rd->next) {
700 if(likely(rd->mapped == RRD_MEMORY_MODE_SAVE)) {
701 debug(D_RRD_CALLS, "Saving dimension '%s' to '%s'.", rd->name, rd->cache_filename);
702 savememory(rd->cache_filename, rd, rd->memsize);
706 pthread_rwlock_unlock(&st->rwlock);
708 pthread_rwlock_unlock(&localhost.rrdset_root_rwlock);
712 RRDSET *rrdset_find(const char *id)
714 debug(D_RRD_CALLS, "rrdset_find() for chart %s", id);
716 RRDSET *st = rrdset_index_find(&localhost, id, 0);
720 RRDSET *rrdset_find_bytype(const char *type, const char *id)
722 debug(D_RRD_CALLS, "rrdset_find_bytype() for chart %s.%s", type, id);
724 char buf[RRD_ID_LENGTH_MAX + 1];
726 strncpyz(buf, type, RRD_ID_LENGTH_MAX - 1);
728 int len = (int) strlen(buf);
729 strncpyz(&buf[len], id, (size_t) (RRD_ID_LENGTH_MAX - len));
731 return(rrdset_find(buf));
734 RRDSET *rrdset_find_byname(const char *name)
736 debug(D_RRD_CALLS, "rrdset_find_byname() for chart %s", name);
738 RRDSET *st = rrdset_index_find_name(&localhost, name, 0);
742 RRDDIM *rrddim_find(RRDSET *st, const char *id)
744 debug(D_RRD_CALLS, "rrddim_find() for chart %s, dimension %s", st->name, id);
746 return rrddim_index_find(st, id, 0);
749 int rrddim_hide(RRDSET *st, const char *id)
751 debug(D_RRD_CALLS, "rrddim_hide() for chart %s, dimension %s", st->name, id);
753 RRDDIM *rd = rrddim_find(st, id);
755 error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
759 rd->flags |= RRDDIM_FLAG_HIDDEN;
763 int rrddim_unhide(RRDSET *st, const char *id)
765 debug(D_RRD_CALLS, "rrddim_unhide() for chart %s, dimension %s", st->name, id);
767 RRDDIM *rd = rrddim_find(st, id);
769 error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
773 if(rd->flags & RRDDIM_FLAG_HIDDEN) rd->flags ^= RRDDIM_FLAG_HIDDEN;
777 collected_number rrddim_set_by_pointer(RRDSET *st, RRDDIM *rd, collected_number value)
779 debug(D_RRD_CALLS, "rrddim_set_by_pointer() for chart %s, dimension %s, value " COLLECTED_NUMBER_FORMAT, st->name, rd->name, value);
781 gettimeofday(&rd->last_collected_time, NULL);
782 rd->collected_value = value;
786 return rd->last_collected_value;
789 collected_number rrddim_set(RRDSET *st, const char *id, collected_number value)
791 RRDDIM *rd = rrddim_find(st, id);
793 error("Cannot find dimension with id '%s' on stats '%s' (%s).", id, st->name, st->id);
797 return rrddim_set_by_pointer(st, rd, value);
800 void rrdset_next_usec(RRDSET *st, unsigned long long microseconds)
802 if(!microseconds) rrdset_next(st);
804 debug(D_RRD_CALLS, "rrdset_next_usec() for chart %s with microseconds %llu", st->name, microseconds);
806 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: NEXT: %llu microseconds", st->name, microseconds);
807 st->usec_since_last_update = microseconds;
811 void rrdset_next(RRDSET *st)
813 unsigned long long microseconds = 0;
815 if(likely(st->last_collected_time.tv_sec)) {
817 gettimeofday(&now, NULL);
818 microseconds = usecdiff(&now, &st->last_collected_time);
820 // prevent infinite loop
821 else microseconds = st->update_every * 1000000ULL;
823 rrdset_next_usec(st, microseconds);
826 void rrdset_next_plugins(RRDSET *st)
831 unsigned long long rrdset_done(RRDSET *st)
833 if(unlikely(netdata_exit)) return 0;
835 debug(D_RRD_CALLS, "rrdset_done() for chart %s", st->name);
838 int oldstate, store_this_entry = 1, first_entry = 0;
839 unsigned long long last_ut, now_ut, next_ut, stored_entries = 0;
841 if(unlikely(pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, &oldstate) != 0))
842 error("Cannot set pthread cancel state to DISABLE.");
844 // a read lock is OK here
845 pthread_rwlock_rdlock(&st->rwlock);
847 // enable the chart, if it was disabled
848 if(unlikely(rrd_delete_unupdated_dimensions) && !st->enabled)
851 // check if the chart has a long time to be updated
852 if(unlikely(st->usec_since_last_update > st->entries * st->update_every * 1000000ULL)) {
853 info("%s: took too long to be updated (%0.3Lf secs). Reseting it.", st->name, (long double)(st->usec_since_last_update / 1000000.0));
855 st->usec_since_last_update = st->update_every * 1000000ULL;
858 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: microseconds since last update: %llu", st->name, st->usec_since_last_update);
860 // set last_collected_time
861 if(unlikely(!st->last_collected_time.tv_sec)) {
862 // it is the first entry
863 // set the last_collected_time to now
864 gettimeofday(&st->last_collected_time, NULL);
866 // the first entry should not be stored
867 store_this_entry = 0;
870 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: has not set last_collected_time. Setting it now. Will not store the next entry.", st->name);
873 // it is not the first entry
874 // calculate the proper last_collected_time, using usec_since_last_update
875 unsigned long long ut = st->last_collected_time.tv_sec * 1000000ULL + st->last_collected_time.tv_usec + st->usec_since_last_update;
876 st->last_collected_time.tv_sec = (time_t) (ut / 1000000ULL);
877 st->last_collected_time.tv_usec = (suseconds_t) (ut % 1000000ULL);
880 // if this set has not been updated in the past
881 // we fake the last_update time to be = now - usec_since_last_update
882 if(unlikely(!st->last_updated.tv_sec)) {
883 // it has never been updated before
884 // set a fake last_updated, in the past using usec_since_last_update
885 unsigned long long ut = st->last_collected_time.tv_sec * 1000000ULL + st->last_collected_time.tv_usec - st->usec_since_last_update;
886 st->last_updated.tv_sec = (time_t) (ut / 1000000ULL);
887 st->last_updated.tv_usec = (suseconds_t) (ut % 1000000ULL);
889 // the first entry should not be stored
890 store_this_entry = 0;
893 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: initializing last_updated to now - %llu microseconds (%0.3Lf). Will not store the next entry.", st->name, st->usec_since_last_update, (long double)ut/1000000.0);
896 // check if we will re-write the entire data set
897 if(unlikely(usecdiff(&st->last_collected_time, &st->last_updated) > st->update_every * st->entries * 1000000ULL)) {
898 info("%s: too old data (last updated at %ld.%ld, last collected at %ld.%ld). Reseting it. Will not store the next entry.", st->name, st->last_updated.tv_sec, st->last_updated.tv_usec, st->last_collected_time.tv_sec, st->last_collected_time.tv_usec);
901 st->usec_since_last_update = st->update_every * 1000000ULL;
903 gettimeofday(&st->last_collected_time, NULL);
905 unsigned long long ut = st->last_collected_time.tv_sec * 1000000ULL + st->last_collected_time.tv_usec - st->usec_since_last_update;
906 st->last_updated.tv_sec = (time_t) (ut / 1000000ULL);
907 st->last_updated.tv_usec = (suseconds_t) (ut % 1000000ULL);
909 // the first entry should not be stored
910 store_this_entry = 0;
914 // these are the 3 variables that will help us in interpolation
915 // last_ut = the last time we added a value to the storage
916 // now_ut = the time the current value is taken at
917 // next_ut = the time of the next interpolation point
918 last_ut = st->last_updated.tv_sec * 1000000ULL + st->last_updated.tv_usec;
919 now_ut = st->last_collected_time.tv_sec * 1000000ULL + st->last_collected_time.tv_usec;
920 next_ut = (st->last_updated.tv_sec + st->update_every) * 1000000ULL;
922 if(unlikely(!first_entry && now_ut < next_ut)) {
923 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: THIS IS IN THE SAME INTERPOLATION POINT", st->name);
926 if(unlikely(st->debug)) {
927 debug(D_RRD_STATS, "%s: last ut = %0.3Lf (last updated time)", st->name, (long double)last_ut/1000000.0);
928 debug(D_RRD_STATS, "%s: now ut = %0.3Lf (current update time)", st->name, (long double)now_ut/1000000.0);
929 debug(D_RRD_STATS, "%s: next ut = %0.3Lf (next interpolation point)", st->name, (long double)next_ut/1000000.0);
932 if(unlikely(!st->counter_done)) {
933 store_this_entry = 0;
934 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s: Will not store the next entry.", st->name);
938 // calculate totals and count the dimensions
940 st->collected_total = 0;
941 for( rd = st->dimensions, dimensions = 0 ; likely(rd) ; rd = rd->next, dimensions++ )
942 if(likely(rd->updated)) st->collected_total += rd->collected_value;
944 uint32_t storage_flags = SN_EXISTS;
946 // process all dimensions to calculate their values
947 // based on the collected figures only
948 // at this stage we do not interpolate anything
949 for( rd = st->dimensions ; likely(rd) ; rd = rd->next ) {
951 if(unlikely(!rd->updated)) {
952 rd->calculated_value = 0;
956 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: START "
957 " last_collected_value = " COLLECTED_NUMBER_FORMAT
958 " collected_value = " COLLECTED_NUMBER_FORMAT
959 " last_calculated_value = " CALCULATED_NUMBER_FORMAT
960 " calculated_value = " CALCULATED_NUMBER_FORMAT
962 , rd->last_collected_value
963 , rd->collected_value
964 , rd->last_calculated_value
965 , rd->calculated_value
968 switch(rd->algorithm) {
969 case RRDDIM_ABSOLUTE:
970 rd->calculated_value = (calculated_number)rd->collected_value
971 * (calculated_number)rd->multiplier
972 / (calculated_number)rd->divisor;
974 if(unlikely(st->debug))
975 debug(D_RRD_STATS, "%s/%s: CALC ABS/ABS-NO-IN "
976 CALCULATED_NUMBER_FORMAT " = "
977 COLLECTED_NUMBER_FORMAT
978 " * " CALCULATED_NUMBER_FORMAT
979 " / " CALCULATED_NUMBER_FORMAT
981 , rd->calculated_value
982 , rd->collected_value
983 , (calculated_number)rd->multiplier
984 , (calculated_number)rd->divisor
988 case RRDDIM_PCENT_OVER_ROW_TOTAL:
989 if(unlikely(!st->collected_total))
990 rd->calculated_value = 0;
992 // the percentage of the current value
993 // over the total of all dimensions
994 rd->calculated_value =
995 (calculated_number)100
996 * (calculated_number)rd->collected_value
997 / (calculated_number)st->collected_total;
999 if(unlikely(st->debug))
1000 debug(D_RRD_STATS, "%s/%s: CALC PCENT-ROW "
1001 CALCULATED_NUMBER_FORMAT " = 100"
1002 " * " COLLECTED_NUMBER_FORMAT
1003 " / " COLLECTED_NUMBER_FORMAT
1005 , rd->calculated_value
1006 , rd->collected_value
1007 , st->collected_total
1011 case RRDDIM_INCREMENTAL:
1012 if(unlikely(rd->counter <= 1)) {
1013 rd->calculated_value = 0;
1017 // if the new is smaller than the old (an overflow, or reset), set the old equal to the new
1018 // to reset the calculation (it will give zero as the calculation for this second)
1019 if(unlikely(rd->last_collected_value > rd->collected_value)) {
1020 debug(D_RRD_STATS, "%s.%s: RESET or OVERFLOW. Last collected value = " COLLECTED_NUMBER_FORMAT ", current = " COLLECTED_NUMBER_FORMAT
1021 , st->name, rd->name
1022 , rd->last_collected_value
1023 , rd->collected_value);
1024 if(!(rd->flags & RRDDIM_FLAG_DONT_DETECT_RESETS_OR_OVERFLOWS)) storage_flags = SN_EXISTS_RESET;
1025 rd->last_collected_value = rd->collected_value;
1028 rd->calculated_value =
1029 (calculated_number)(rd->collected_value - rd->last_collected_value)
1030 * (calculated_number)rd->multiplier
1031 / (calculated_number)rd->divisor;
1033 if(unlikely(st->debug))
1034 debug(D_RRD_STATS, "%s/%s: CALC INC PRE "
1035 CALCULATED_NUMBER_FORMAT " = ("
1036 COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT
1038 " * " CALCULATED_NUMBER_FORMAT
1039 " / " CALCULATED_NUMBER_FORMAT
1041 , rd->calculated_value
1042 , rd->collected_value, rd->last_collected_value
1043 , (calculated_number)rd->multiplier
1044 , (calculated_number)rd->divisor
1048 case RRDDIM_PCENT_OVER_DIFF_TOTAL:
1049 if(unlikely(rd->counter <= 1)) {
1050 rd->calculated_value = 0;
1054 // if the new is smaller than the old (an overflow, or reset), set the old equal to the new
1055 // to reset the calculation (it will give zero as the calculation for this second)
1056 if(unlikely(rd->last_collected_value > rd->collected_value)) {
1057 debug(D_RRD_STATS, "%s.%s: RESET or OVERFLOW. Last collected value = " COLLECTED_NUMBER_FORMAT ", current = " COLLECTED_NUMBER_FORMAT
1058 , st->name, rd->name
1059 , rd->last_collected_value
1060 , rd->collected_value);
1061 if(!(rd->flags & RRDDIM_FLAG_DONT_DETECT_RESETS_OR_OVERFLOWS)) storage_flags = SN_EXISTS_RESET;
1062 rd->last_collected_value = rd->collected_value;
1065 // the percentage of the current increment
1066 // over the increment of all dimensions together
1067 if(unlikely(st->collected_total == st->last_collected_total))
1068 rd->calculated_value = 0;
1070 rd->calculated_value =
1071 (calculated_number)100
1072 * (calculated_number)(rd->collected_value - rd->last_collected_value)
1073 / (calculated_number)(st->collected_total - st->last_collected_total);
1075 if(unlikely(st->debug))
1076 debug(D_RRD_STATS, "%s/%s: CALC PCENT-DIFF "
1077 CALCULATED_NUMBER_FORMAT " = 100"
1078 " * (" COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT ")"
1079 " / (" COLLECTED_NUMBER_FORMAT " - " COLLECTED_NUMBER_FORMAT ")"
1081 , rd->calculated_value
1082 , rd->collected_value, rd->last_collected_value
1083 , st->collected_total, st->last_collected_total
1088 // make the default zero, to make sure
1089 // it gets noticed when we add new types
1090 rd->calculated_value = 0;
1092 if(unlikely(st->debug))
1093 debug(D_RRD_STATS, "%s/%s: CALC "
1094 CALCULATED_NUMBER_FORMAT " = 0"
1096 , rd->calculated_value
1101 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: PHASE2 "
1102 " last_collected_value = " COLLECTED_NUMBER_FORMAT
1103 " collected_value = " COLLECTED_NUMBER_FORMAT
1104 " last_calculated_value = " CALCULATED_NUMBER_FORMAT
1105 " calculated_value = " CALCULATED_NUMBER_FORMAT
1107 , rd->last_collected_value
1108 , rd->collected_value
1109 , rd->last_calculated_value
1110 , rd->calculated_value
1115 // at this point we have all the calculated values ready
1116 // it is now time to interpolate values on a second boundary
1118 unsigned long long first_ut = last_ut;
1119 long long iterations = (now_ut - last_ut) / (st->update_every * 1000000ULL);
1120 if((now_ut % (st->update_every * 1000000ULL)) == 0) iterations++;
1122 for( ; likely(next_ut <= now_ut) ; next_ut += st->update_every * 1000000ULL, iterations-- ) {
1123 #ifdef NETDATA_INTERNAL_CHECKS
1124 if(iterations < 0) { error("%s: iterations calculation wrapped! first_ut = %llu, last_ut = %llu, next_ut = %llu, now_ut = %llu", st->name, first_ut, last_ut, next_ut, now_ut); }
1127 if(unlikely(st->debug)) {
1128 debug(D_RRD_STATS, "%s: last ut = %0.3Lf (last updated time)", st->name, (long double)last_ut/1000000.0);
1129 debug(D_RRD_STATS, "%s: next ut = %0.3Lf (next interpolation point)", st->name, (long double)next_ut/1000000.0);
1132 st->last_updated.tv_sec = (time_t) (next_ut / 1000000ULL);
1133 st->last_updated.tv_usec = 0;
1135 for( rd = st->dimensions ; likely(rd) ; rd = rd->next ) {
1136 calculated_number new_value;
1138 switch(rd->algorithm) {
1139 case RRDDIM_INCREMENTAL:
1140 new_value = (calculated_number)
1141 ( rd->calculated_value
1142 * (calculated_number)(next_ut - last_ut)
1143 / (calculated_number)(now_ut - last_ut)
1146 if(unlikely(st->debug))
1147 debug(D_RRD_STATS, "%s/%s: CALC2 INC "
1148 CALCULATED_NUMBER_FORMAT " = "
1149 CALCULATED_NUMBER_FORMAT
1154 , rd->calculated_value
1155 , (next_ut - last_ut)
1156 , (now_ut - last_ut)
1159 rd->calculated_value -= new_value;
1160 new_value += rd->last_calculated_value;
1161 rd->last_calculated_value = 0;
1162 new_value /= (calculated_number)st->update_every;
1165 case RRDDIM_ABSOLUTE:
1166 case RRDDIM_PCENT_OVER_ROW_TOTAL:
1167 case RRDDIM_PCENT_OVER_DIFF_TOTAL:
1169 if(iterations == 1) {
1170 // this is the last iteration
1171 // do not interpolate
1172 // just show the calculated value
1174 new_value = rd->calculated_value;
1177 // we have missed an update
1178 // interpolate in the middle values
1180 new_value = (calculated_number)
1181 ( ( (rd->calculated_value - rd->last_calculated_value)
1182 * (calculated_number)(next_ut - first_ut)
1183 / (calculated_number)(now_ut - first_ut)
1185 + rd->last_calculated_value
1188 if(unlikely(st->debug))
1189 debug(D_RRD_STATS, "%s/%s: CALC2 DEF "
1190 CALCULATED_NUMBER_FORMAT " = ((("
1191 "(" CALCULATED_NUMBER_FORMAT " - " CALCULATED_NUMBER_FORMAT ")"
1193 " / %llu) + " CALCULATED_NUMBER_FORMAT
1196 , rd->calculated_value, rd->last_calculated_value
1197 , (next_ut - first_ut)
1198 , (now_ut - first_ut), rd->last_calculated_value
1202 // it fades the value towards the target
1203 // while we know the calculated value is different
1204 // if(likely(next_ut + st->update_every * 1000000ULL > now_ut)) rd->calculated_value = new_value;
1209 if(unlikely(!store_this_entry)) {
1210 store_this_entry = 1;
1214 if(likely(rd->updated && rd->counter > 1 && iterations < st->gap_when_lost_iterations_above)) {
1215 rd->values[st->current_entry] = pack_storage_number(new_value, storage_flags );
1217 if(unlikely(st->debug))
1218 debug(D_RRD_STATS, "%s/%s: STORE[%ld] "
1219 CALCULATED_NUMBER_FORMAT " = " CALCULATED_NUMBER_FORMAT
1222 , unpack_storage_number(rd->values[st->current_entry]), new_value
1226 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: STORE[%ld] = NON EXISTING "
1230 rd->values[st->current_entry] = pack_storage_number(0, SN_NOT_EXISTS);
1235 if(unlikely(st->debug)) {
1236 calculated_number t1 = new_value * (calculated_number)rd->multiplier / (calculated_number)rd->divisor;
1237 calculated_number t2 = unpack_storage_number(rd->values[st->current_entry]);
1238 calculated_number accuracy = accuracy_loss(t1, t2);
1239 debug(D_RRD_STATS, "%s/%s: UNPACK[%ld] = " CALCULATED_NUMBER_FORMAT " FLAGS=0x%08x (original = " CALCULATED_NUMBER_FORMAT ", accuracy loss = " CALCULATED_NUMBER_FORMAT "%%%s)"
1243 , get_storage_number_flags(rd->values[st->current_entry])
1246 , (accuracy > ACCURACY_LOSS) ? " **TOO BIG** " : ""
1249 rd->collected_volume += t1;
1250 rd->stored_volume += t2;
1251 accuracy = accuracy_loss(rd->collected_volume, rd->stored_volume);
1252 debug(D_RRD_STATS, "%s/%s: VOLUME[%ld] = " CALCULATED_NUMBER_FORMAT ", calculated = " CALCULATED_NUMBER_FORMAT ", accuracy loss = " CALCULATED_NUMBER_FORMAT "%%%s"
1256 , rd->collected_volume
1258 , (accuracy > ACCURACY_LOSS) ? " **TOO BIG** " : ""
1263 // reset the storage flags for the next point, if any;
1264 storage_flags = SN_EXISTS;
1267 st->current_entry = ((st->current_entry + 1) >= st->entries) ? 0 : st->current_entry + 1;
1271 // align next interpolation to last collection point
1272 if(likely(stored_entries || !store_this_entry)) {
1273 st->last_updated.tv_sec = st->last_collected_time.tv_sec;
1274 st->last_updated.tv_usec = st->last_collected_time.tv_usec;
1275 st->last_collected_total = st->collected_total;
1278 for( rd = st->dimensions; likely(rd) ; rd = rd->next ) {
1279 if(unlikely(!rd->updated)) continue;
1281 if(likely(stored_entries || !store_this_entry)) {
1282 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: setting last_collected_value (old: " COLLECTED_NUMBER_FORMAT ") to last_collected_value (new: " COLLECTED_NUMBER_FORMAT ")", st->id, rd->name, rd->last_collected_value, rd->collected_value);
1283 rd->last_collected_value = rd->collected_value;
1285 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: setting last_calculated_value (old: " CALCULATED_NUMBER_FORMAT ") to last_calculated_value (new: " CALCULATED_NUMBER_FORMAT ")", st->id, rd->name, rd->last_calculated_value, rd->calculated_value);
1286 rd->last_calculated_value = rd->calculated_value;
1289 rd->calculated_value = 0;
1290 rd->collected_value = 0;
1293 if(unlikely(st->debug)) debug(D_RRD_STATS, "%s/%s: END "
1294 " last_collected_value = " COLLECTED_NUMBER_FORMAT
1295 " collected_value = " COLLECTED_NUMBER_FORMAT
1296 " last_calculated_value = " CALCULATED_NUMBER_FORMAT
1297 " calculated_value = " CALCULATED_NUMBER_FORMAT
1299 , rd->last_collected_value
1300 , rd->collected_value
1301 , rd->last_calculated_value
1302 , rd->calculated_value
1306 // ALL DONE ABOUT THE DATA UPDATE
1307 // --------------------------------------------------------------------
1309 // find if there are any obsolete dimensions (not updated recently)
1310 if(unlikely(rrd_delete_unupdated_dimensions)) {
1312 for( rd = st->dimensions; likely(rd) ; rd = rd->next )
1313 if((rd->last_collected_time.tv_sec + (rrd_delete_unupdated_dimensions * st->update_every)) < st->last_collected_time.tv_sec)
1317 // there is dimension to free
1318 // upgrade our read lock to a write lock
1319 pthread_rwlock_unlock(&st->rwlock);
1320 pthread_rwlock_wrlock(&st->rwlock);
1322 for( rd = st->dimensions, last = NULL ; likely(rd) ; ) {
1323 // remove it only it is not updated in rrd_delete_unupdated_dimensions seconds
1325 if(unlikely((rd->last_collected_time.tv_sec + (rrd_delete_unupdated_dimensions * st->update_every)) < st->last_collected_time.tv_sec)) {
1326 info("Removing obsolete dimension '%s' (%s) of '%s' (%s).", rd->name, rd->id, st->name, st->id);
1328 if(unlikely(!last)) {
1329 st->dimensions = rd->next;
1331 rrddim_free(st, rd);
1332 rd = st->dimensions;
1336 last->next = rd->next;
1338 rrddim_free(st, rd);
1348 if(unlikely(!st->dimensions)) {
1349 info("Disabling chart %s (%s) since it does not have any dimensions", st->name, st->id);
1355 pthread_rwlock_unlock(&st->rwlock);
1357 if(unlikely(pthread_setcancelstate(oldstate, NULL) != 0))
1358 error("Cannot set pthread cancel state to RESTORE (%d).", oldstate);
1360 return(st->usec_since_last_update);