2 #define NETDATA_RRD_H 1
5 #define UPDATE_EVERY_MAX 3600
7 #define RRD_DEFAULT_HISTORY_ENTRIES 3600
8 #define RRD_HISTORY_ENTRIES_MAX (86400*10)
10 extern int default_rrd_update_every;
11 extern int default_rrd_history_entries;
13 #define RRD_ID_LENGTH_MAX 200
15 #define RRDSET_MAGIC "NETDATA RRD SET FILE V019"
16 #define RRDDIMENSION_MAGIC "NETDATA RRD DIMENSION FILE V019"
18 typedef long long total_number;
19 #define TOTAL_NUMBER_FORMAT "%lld"
21 // ----------------------------------------------------------------------------
24 typedef enum rrdset_type {
27 RRDSET_TYPE_STACKED = 2
30 #define RRDSET_TYPE_LINE_NAME "line"
31 #define RRDSET_TYPE_AREA_NAME "area"
32 #define RRDSET_TYPE_STACKED_NAME "stacked"
34 RRDSET_TYPE rrdset_type_id(const char *name);
35 const char *rrdset_type_name(RRDSET_TYPE chart_type);
38 // ----------------------------------------------------------------------------
41 typedef enum rrd_memory_mode {
42 RRD_MEMORY_MODE_NONE = 0,
43 RRD_MEMORY_MODE_RAM = 1,
44 RRD_MEMORY_MODE_MAP = 2,
45 RRD_MEMORY_MODE_SAVE = 3
48 #define RRD_MEMORY_MODE_NONE_NAME "none"
49 #define RRD_MEMORY_MODE_RAM_NAME "ram"
50 #define RRD_MEMORY_MODE_MAP_NAME "map"
51 #define RRD_MEMORY_MODE_SAVE_NAME "save"
53 extern RRD_MEMORY_MODE default_rrd_memory_mode;
55 extern const char *rrd_memory_mode_name(RRD_MEMORY_MODE id);
56 extern RRD_MEMORY_MODE rrd_memory_mode_id(const char *name);
59 // ----------------------------------------------------------------------------
62 typedef enum rrd_algorithm {
63 RRD_ALGORITHM_ABSOLUTE = 0,
64 RRD_ALGORITHM_INCREMENTAL = 1,
65 RRD_ALGORITHM_PCENT_OVER_DIFF_TOTAL = 2,
66 RRD_ALGORITHM_PCENT_OVER_ROW_TOTAL = 3
69 #define RRD_ALGORITHM_ABSOLUTE_NAME "absolute"
70 #define RRD_ALGORITHM_INCREMENTAL_NAME "incremental"
71 #define RRD_ALGORITHM_PCENT_OVER_DIFF_TOTAL_NAME "percentage-of-incremental-row"
72 #define RRD_ALGORITHM_PCENT_OVER_ROW_TOTAL_NAME "percentage-of-absolute-row"
74 extern RRD_ALGORITHM rrd_algorithm_id(const char *name);
75 extern const char *rrd_algorithm_name(RRD_ALGORITHM algorithm);
77 // ----------------------------------------------------------------------------
88 avl_tree_lock variables_root_index;
90 typedef struct rrdfamily RRDFAMILY;
93 // ----------------------------------------------------------------------------
95 // use this for configuration flags, not for state control
96 // flags are set/unset in a manner that is not thread safe
97 // and may lead to missing information.
99 typedef enum rrddim_flags {
100 RRDDIM_FLAG_HIDDEN = 1 << 0, // this dimension will not be offered to callers
101 RRDDIM_FLAG_DONT_DETECT_RESETS_OR_OVERFLOWS = 1 << 1 // do not offer RESET or OVERFLOW info to callers
104 #define rrddim_flag_check(rd, flag) ((rd)->flags & flag)
105 #define rrddim_flag_set(rd, flag) (rd)->flags |= flag
106 #define rrddim_flag_clear(rd, flag) (rd)->flags &= ~flag
109 // ----------------------------------------------------------------------------
110 // RRD DIMENSION - this is a metric
113 // ------------------------------------------------------------------------
114 // binary indexing structures
116 avl avl; // the binary index - this has to be first member!
118 // ------------------------------------------------------------------------
119 // the dimension definition
121 const char *id; // the id of this dimension (for internal identification)
122 const char *name; // the name of this dimension (as presented to user)
123 // this is a pointer to the config structure
124 // since the config always has a higher priority
125 // (the user overwrites the name of the charts)
126 // DO NOT FREE THIS - IT IS ALLOCATED IN CONFIG
128 RRD_ALGORITHM algorithm; // the algorithm that is applied to add new collected values
129 RRD_MEMORY_MODE rrd_memory_mode; // the memory mode for this dimension
131 collected_number multiplier; // the multiplier of the collected values
132 collected_number divisor; // the divider of the collected values
134 uint32_t flags; // configuration flags for the dimension
136 // ------------------------------------------------------------------------
137 // members for temporary data we need for calculations
139 uint32_t hash; // a simple hash of the id, to speed up searching / indexing
140 // instead of strcmp() every item in the binary index
141 // we first compare the hashes
143 uint32_t hash_name; // a simple hash of the name
145 char *cache_filename; // the filename we load/save from/to this set
147 size_t collections_counter; // the number of times we added values to this rrdim
150 int updated:1; // 1 when the dimension has been updated since the last processing
151 int exposed:1; // 1 when set what have sent this dimension to the central netdata
153 struct timeval last_collected_time; // when was this dimension last updated
154 // this is actual date time we updated the last_collected_value
155 // THIS IS DIFFERENT FROM THE SAME MEMBER OF RRDSET
157 calculated_number calculated_value; // the current calculated value, after applying the algorithm - resets to zero after being used
158 calculated_number last_calculated_value; // the last calculated value processed
160 calculated_number last_stored_value; // the last value as stored in the database (after interpolation)
162 collected_number collected_value; // the current value, as collected - resets to 0 after being used
163 collected_number last_collected_value; // the last value that was collected, after being processed
165 // the *_volume members are used to calculate the accuracy of the rounding done by the
166 // storage number - they are printed to debug.log when debug is enabled for a set.
167 calculated_number collected_volume; // the sum of all collected values so far
168 calculated_number stored_volume; // the sum of all stored values so far
170 struct rrddim *next; // linking of dimensions within the same data set
171 struct rrdset *rrdset;
173 // ------------------------------------------------------------------------
174 // members for checking the data when loading from disk
176 long entries; // how many entries this dimension has in ram
177 // this is the same to the entries of the data set
178 // we set it here, to check the data when we load it from disk.
180 int update_every; // every how many seconds is this updated
182 size_t memsize; // the memory allocated for this dimension
184 char magic[sizeof(RRDDIMENSION_MAGIC) + 1]; // a string to be saved, used to identify our data file
186 struct rrddimvar *variables;
188 // ------------------------------------------------------------------------
189 // the values stored in this dimension, using our floating point numbers
191 storage_number values[]; // the array of values - THIS HAS TO BE THE LAST MEMBER
193 typedef struct rrddim RRDDIM;
195 // ----------------------------------------------------------------------------
196 // these loop macros make sure the linked list is accessed with the right lock
198 #define rrddim_foreach_read(rd, st) \
199 for(rd = st->dimensions, rrdset_check_rdlock(st); rd ; rd = rd->next)
201 #define rrddim_foreach_write(rd, st) \
202 for(rd = st->dimensions, rrdset_check_wrlock(st); rd ; rd = rd->next)
205 // ----------------------------------------------------------------------------
206 // RRDSET - this is a chart
208 // use this for configuration flags, not for state control
209 // flags are set/unset in a manner that is not thread safe
210 // and may lead to missing information.
212 typedef enum rrdset_flags {
213 RRDSET_FLAG_ENABLED = 1 << 0, // enables or disables a chart
214 RRDSET_FLAG_DETAIL = 1 << 1, // if set, the data set should be considered as a detail of another
215 // (the master data set should be the one that has the same family and is not detail)
216 RRDSET_FLAG_DEBUG = 1 << 2, // enables or disables debugging for a chart
217 RRDSET_FLAG_OBSOLETE = 1 << 3 // this is marked by the collector/module as obsolete
220 #define rrdset_flag_check(st, flag) ((st)->flags & flag)
221 #define rrdset_flag_set(st, flag) (st)->flags |= flag
222 #define rrdset_flag_clear(st, flag) (st)->flags &= ~flag
225 // ------------------------------------------------------------------------
226 // binary indexing structures
228 avl avl; // the index, with key the id - this has to be first!
229 avl avlname; // the index, with key the name
231 // ------------------------------------------------------------------------
232 // the set configuration
234 char id[RRD_ID_LENGTH_MAX + 1]; // id of the data set
236 const char *name; // the name of this dimension (as presented to user)
237 // this is a pointer to the config structure
238 // since the config always has a higher priority
239 // (the user overwrites the name of the charts)
241 char *config_section; // the config section for the chart
243 char *type; // the type of graph RRD_TYPE_* (a category, for determining graphing options)
244 char *family; // grouping sets under the same family
245 char *title; // title shown to user
246 char *units; // units of measurement
248 char *context; // the template of this data set
249 uint32_t hash_context;
251 RRDSET_TYPE chart_type;
253 int update_every; // every how many seconds is this updated?
255 long entries; // total number of entries in the data set
257 long current_entry; // the entry that is currently being updated
258 // it goes around in a round-robin fashion
260 uint32_t flags; // configuration flags
262 int gap_when_lost_iterations_above; // after how many lost iterations a gap should be stored
263 // netdata will interpolate values for gaps lower than this
268 // ------------------------------------------------------------------------
269 // members for temporary data we need for calculations
271 RRD_MEMORY_MODE rrd_memory_mode; // if set to 1, this is memory mapped
273 char *cache_dir; // the directory to store dimensions
274 char cache_filename[FILENAME_MAX+1]; // the filename to store this set
276 pthread_rwlock_t rrdset_rwlock; // protects dimensions linked list
278 size_t counter; // the number of times we added values to this database
279 size_t counter_done; // the number of times rrdset_done() has been called
281 time_t last_accessed_time; // the last time this RRDSET has been accessed
284 uint32_t hash; // a simple hash on the id, to speed up searching
285 // we first compare hashes, and only if the hashes are equal we do string comparisons
287 uint32_t hash_name; // a simple hash on the name
289 usec_t usec_since_last_update; // the time in microseconds since the last collection of data
291 struct timeval last_updated; // when this data set was last updated (updated every time the rrd_stats_done() function)
292 struct timeval last_collected_time; // when did this data set last collected values
294 total_number collected_total; // used internally to calculate percentages
295 total_number last_collected_total; // used internally to calculate percentages
297 RRDFAMILY *rrdfamily;
298 struct rrdhost *rrdhost;
300 struct rrdset *next; // linking of rrdsets
302 // ------------------------------------------------------------------------
305 calculated_number green;
306 calculated_number red;
308 avl_tree_lock variables_root_index;
309 RRDSETVAR *variables;
312 // ------------------------------------------------------------------------
313 // members for checking the data when loading from disk
315 unsigned long memsize; // how much mem we have allocated for this (without dimensions)
317 char magic[sizeof(RRDSET_MAGIC) + 1]; // our magic
319 // ------------------------------------------------------------------------
322 avl_tree_lock dimensions_index; // the root of the dimensions index
323 RRDDIM *dimensions; // the actual data for every dimension
326 typedef struct rrdset RRDSET;
328 // ----------------------------------------------------------------------------
329 // these loop macros make sure the linked list is accessed with the right lock
331 #define rrdset_foreach_read(st, host) \
332 for(st = host->rrdset_root, rrdhost_check_rdlock(host); st ; st = st->next)
334 #define rrdset_foreach_write(st, host) \
335 for(st = host->rrdset_root, rrdhost_check_wrlock(host); st ; st = st->next)
338 // ----------------------------------------------------------------------------
340 // use this for configuration flags, not for state control
341 // flags are set/unset in a manner that is not thread safe
342 // and may lead to missing information.
344 typedef enum rrdhost_flags {
345 RRDHOST_ORPHAN = 1 << 0, // this host is orphan
346 RRDHOST_DELETE_OBSOLETE_FILES = 1 << 1, // delete files of obsolete charts
347 RRDHOST_DELETE_ORPHAN_FILES = 1 << 2 // delete the entire host when orphan
350 #define rrdhost_flag_check(host, flag) ((host)->flags & flag)
351 #define rrdhost_flag_set(host, flag) (host)->flags |= flag
352 #define rrdhost_flag_clear(host, flag) (host)->flags &= ~flag
354 // ----------------------------------------------------------------------------
358 avl avl; // the index of hosts
360 // ------------------------------------------------------------------------
363 char *hostname; // the hostname of this host
364 uint32_t hash_hostname; // the hostname hash
366 char machine_guid[GUID_LEN + 1]; // the unique ID of this host
367 uint32_t hash_machine_guid; // the hash of the unique ID
369 char *os; // the O/S type of the host
371 uint32_t flags; // flags about this RRDHOST
373 int rrd_update_every; // the update frequency of the host
374 int rrd_history_entries; // the number of history entries for the host's charts
375 RRD_MEMORY_MODE rrd_memory_mode; // the memory more for the charts of this host
377 char *cache_dir; // the directory to save RRD cache files
378 char *varlib_dir; // the directory to save health log
381 // ------------------------------------------------------------------------
382 // streaming of data to remote hosts - rrdpush
384 int rrdpush_enabled:1; // 1 when this host sends metrics to another netdata
385 char *rrdpush_destination; // where to send metrics to
386 char *rrdpush_api_key; // the api key at the receiving netdata
387 volatile int rrdpush_connected:1; // 1 when the sender is ready to push metrics
388 volatile int rrdpush_spawn:1; // 1 when the sender thread has been spawn
389 volatile int rrdpush_error_shown:1; // 1 when we have logged a communication error
390 int rrdpush_socket; // the fd of the socket to the remote host, or -1
391 pthread_t rrdpush_thread; // the sender thread
392 pthread_mutex_t rrdpush_mutex; // exclusive access to rrdpush_buffer
393 int rrdpush_pipe[2]; // collector to sender thread communication
394 BUFFER *rrdpush_buffer; // collector fills it, sender sends them
397 // ------------------------------------------------------------------------
398 // streaming of data from remote hosts - rrdpush
400 volatile size_t connected_senders; // when remote hosts are streaming to this
401 // host, this is the counter of connected clients
403 time_t senders_disconnected_time; // the time the last sender was disconnected
405 // ------------------------------------------------------------------------
406 // health monitoring options
408 int health_enabled:1; // 1 when this host has health enabled
409 time_t health_delay_up_to; // a timestamp to delay alarms processing up to
410 char *health_default_exec; // the full path of the alarms notifications program
411 char *health_default_recipient; // the default recipient for all alarms
412 char *health_log_filename; // the alarms event log filename
413 size_t health_log_entries_written; // the number of alarm events writtern to the alarms event log
414 FILE *health_log_fp; // the FILE pointer to the open alarms event log file
416 // all RRDCALCs are primarily allocated and linked here
417 // RRDCALCs may be linked to charts at any point
418 // (charts may or may not exist when these are loaded)
421 ALARM_LOG health_log; // alarms historical events (event log)
423 // templates of alarms
424 // these are used to create alarms when charts
425 // are created or renamed, that match them
426 RRDCALCTEMPLATE *templates;
429 // ------------------------------------------------------------------------
430 // the charts of the host
432 RRDSET *rrdset_root; // the host charts
435 // ------------------------------------------------------------------------
438 pthread_rwlock_t rrdhost_rwlock; // lock for this RRDHOST (protects rrdset_root linked list)
440 avl_tree_lock rrdset_root_index; // the host's charts index (by id)
441 avl_tree_lock rrdset_root_index_name; // the host's charts index (by name)
443 avl_tree_lock rrdfamily_root_index; // the host's chart families index
444 avl_tree_lock variables_root_index; // the host's chart variables index
446 struct rrdhost *next;
448 typedef struct rrdhost RRDHOST;
449 extern RRDHOST *localhost;
451 static inline void rrdhost_rdlock(RRDHOST *host) {
452 if(unlikely(pthread_rwlock_rdlock(&host->rrdhost_rwlock) != 0))
453 error("Cannot obtain read lock on host '%s'", host->hostname);
456 static inline void rrdhost_wrlock(RRDHOST *host) {
457 if(unlikely(pthread_rwlock_wrlock(&host->rrdhost_rwlock) != 0))
458 error("Cannot obtain write lock on host '%s'", host->hostname);
461 static inline void rrdhost_unlock(RRDHOST *host) {
462 if(unlikely(pthread_rwlock_unlock(&host->rrdhost_rwlock) != 0))
463 error("Cannot unlock host '%s'", host->hostname);
467 // ----------------------------------------------------------------------------
468 // these loop macros make sure the linked list is accessed with the right lock
470 #define rrdhost_foreach_read(var) \
471 for(var = localhost, rrd_check_rdlock(); var ; var = var->next)
473 #define rrdhost_foreach_write(var) \
474 for(var = localhost, rrd_check_wrlock(); var ; var = var->next)
477 // ----------------------------------------------------------------------------
478 // global lock for all RRDHOSTs
480 extern pthread_rwlock_t rrd_rwlock;
482 static inline void rrd_rdlock() {
483 if(unlikely(pthread_rwlock_rdlock(&rrd_rwlock) != 0))
484 error("Cannot read lock the RRD database.");
487 static inline void rrd_wrlock() {
488 if(unlikely(pthread_rwlock_wrlock(&rrd_rwlock) != 0))
489 error("Cannot write lock the RRD database.");
492 static inline void rrd_unlock() {
493 if(unlikely(pthread_rwlock_unlock(&rrd_rwlock) != 0))
494 error("Cannot unlock the RRD database.");
497 static inline void rrdset_rdlock(RRDSET *st) {
498 if(unlikely(pthread_rwlock_rdlock(&st->rrdset_rwlock) != 0))
499 error("Cannot read lock RRDSET '%s' of host '%s'", st->id, st->rrdhost->hostname);
502 static inline void rrdset_wrlock(RRDSET *st) {
503 if(unlikely(pthread_rwlock_wrlock(&st->rrdset_rwlock) != 0))
504 error("Cannot write lock RRDSET '%s' of host '%s'", st->id, st->rrdhost->hostname);
507 static inline void rrdset_unlock(RRDSET *st) {
508 if(unlikely(pthread_rwlock_unlock(&st->rrdset_rwlock) != 0))
509 error("Cannot unlock RRDSET '%s' of host '%s'", st->id, st->rrdhost->hostname);
512 // ----------------------------------------------------------------------------
514 extern size_t rrd_hosts_available;
515 extern time_t rrdhost_free_orphan_time;
517 extern void rrd_init(char *hostname);
519 extern RRDHOST *rrdhost_find_by_hostname(const char *hostname, uint32_t hash);
520 extern RRDHOST *rrdhost_find_by_guid(const char *guid, uint32_t hash);
522 extern RRDHOST *rrdhost_find_or_create(
528 , RRD_MEMORY_MODE mode
530 , int rrdpush_enabled
531 , char *rrdpush_destination
532 , char *rrdpush_api_key
535 #ifdef NETDATA_INTERNAL_CHECKS
536 extern void rrdhost_check_wrlock_int(RRDHOST *host, const char *file, const char *function, const unsigned long line);
537 extern void rrdhost_check_rdlock_int(RRDHOST *host, const char *file, const char *function, const unsigned long line);
538 extern void rrdset_check_rdlock_int(RRDSET *st, const char *file, const char *function, const unsigned long line);
539 extern void rrdset_check_wrlock_int(RRDSET *st, const char *file, const char *function, const unsigned long line);
540 extern void rrd_check_rdlock_int(const char *file, const char *function, const unsigned long line);
541 extern void rrd_check_wrlock_int(const char *file, const char *function, const unsigned long line);
543 #define rrdhost_check_rdlock(host) rrdhost_check_rdlock_int(host, __FILE__, __FUNCTION__, __LINE__)
544 #define rrdhost_check_wrlock(host) rrdhost_check_wrlock_int(host, __FILE__, __FUNCTION__, __LINE__)
545 #define rrdset_check_rdlock(st) rrdset_check_rdlock_int(st, __FILE__, __FUNCTION__, __LINE__)
546 #define rrdset_check_wrlock(st) rrdset_check_wrlock_int(st, __FILE__, __FUNCTION__, __LINE__)
547 #define rrd_check_rdlock() rrd_check_rdlock_int(__FILE__, __FUNCTION__, __LINE__)
548 #define rrd_check_wrlock() rrd_check_wrlock_int(__FILE__, __FUNCTION__, __LINE__)
551 #define rrdhost_check_rdlock(host) (void)0
552 #define rrdhost_check_wrlock(host) (void)0
553 #define rrdset_check_rdlock(host) (void)0
554 #define rrdset_check_wrlock(host) (void)0
555 #define rrd_check_rdlock() (void)0
556 #define rrd_check_wrlock() (void)0
559 // ----------------------------------------------------------------------------
562 extern void rrdset_set_name(RRDSET *st, const char *name);
564 extern RRDSET *rrdset_create(RRDHOST *host
569 , const char *context
574 , RRDSET_TYPE chart_type);
576 #define rrdset_create_localhost(type, id, name, family, context, title, units, priority, update_every, chart_type) rrdset_create(localhost, type, id, name, family, context, title, units, priority, update_every, chart_type)
578 extern void rrdhost_free_all(void);
579 extern void rrdhost_save_all(void);
581 extern void rrdhost_cleanup_orphan(RRDHOST *protected);
582 extern void rrdhost_free(RRDHOST *host);
583 extern void rrdhost_save(RRDHOST *host);
584 extern void rrdhost_delete(RRDHOST *host);
586 extern RRDSET *rrdset_find(RRDHOST *host, const char *id);
587 #define rrdset_find_localhost(id) rrdset_find(localhost, id)
589 extern RRDSET *rrdset_find_bytype(RRDHOST *host, const char *type, const char *id);
590 #define rrdset_find_bytype_localhost(type, id) rrdset_find_bytype(localhost, type, id)
592 extern RRDSET *rrdset_find_byname(RRDHOST *host, const char *name);
593 #define rrdset_find_byname_localhost(name) rrdset_find_byname(localhost, name)
595 extern void rrdset_next_usec_unfiltered(RRDSET *st, usec_t microseconds);
596 extern void rrdset_next_usec(RRDSET *st, usec_t microseconds);
597 #define rrdset_next(st) rrdset_next_usec(st, 0ULL)
599 extern void rrdset_done(RRDSET *st);
601 // checks if the RRDSET should be offered to viewers
602 #define rrdset_is_available_for_viewers(st) (rrdset_flag_check(st, RRDSET_FLAG_ENABLED) && !rrdset_flag_check(st, RRDSET_FLAG_OBSOLETE) && (st)->dimensions)
604 // get the total duration in seconds of the round robin database
605 #define rrdset_duration(st) ((time_t)( (((st)->counter >= ((unsigned long)(st)->entries))?(unsigned long)(st)->entries:(st)->counter) * (st)->update_every ))
607 // get the timestamp of the last entry in the round robin database
608 #define rrdset_last_entry_t(st) ((time_t)(((st)->last_updated.tv_sec)))
610 // get the timestamp of first entry in the round robin database
611 #define rrdset_first_entry_t(st) ((time_t)(rrdset_last_entry_t(st) - rrdset_duration(st)))
613 // get the last slot updated in the round robin database
614 #define rrdset_last_slot(st) ((unsigned long)(((st)->current_entry == 0) ? (st)->entries - 1 : (st)->current_entry - 1))
616 // get the first / oldest slot updated in the round robin database
617 #define rrdset_first_slot(st) ((unsigned long)( (((st)->counter >= ((unsigned long)(st)->entries)) ? (unsigned long)( ((unsigned long)(st)->current_entry > 0) ? ((unsigned long)(st)->current_entry) : ((unsigned long)(st)->entries) ) - 1 : 0) ))
619 // get the slot of the round robin database, for the given timestamp (t)
620 // it always returns a valid slot, although may not be for the time requested if the time is outside the round robin database
621 #define rrdset_time2slot(st, t) ( \
622 ( (time_t)(t) >= rrdset_last_entry_t(st)) ? ( rrdset_last_slot(st) ) : \
623 ( ((time_t)(t) <= rrdset_first_entry_t(st)) ? rrdset_first_slot(st) : \
624 ( (rrdset_last_slot(st) >= (unsigned long)((rrdset_last_entry_t(st) - (time_t)(t)) / (unsigned long)((st)->update_every)) ) ? \
625 (rrdset_last_slot(st) - (unsigned long)((rrdset_last_entry_t(st) - (time_t)(t)) / (unsigned long)((st)->update_every)) ) : \
626 (rrdset_last_slot(st) - (unsigned long)((rrdset_last_entry_t(st) - (time_t)(t)) / (unsigned long)((st)->update_every)) + (unsigned long)(st)->entries ) \
629 // get the timestamp of a specific slot in the round robin database
630 #define rrdset_slot2time(st, slot) ( rrdset_last_entry_t(st) - \
631 ((unsigned long)(st)->update_every * ( \
632 ( (unsigned long)(slot) > rrdset_last_slot(st)) ? \
633 ( (rrdset_last_slot(st) - (unsigned long)(slot) + (unsigned long)(st)->entries) ) : \
634 ( (rrdset_last_slot(st) - (unsigned long)(slot)) )) \
637 // ----------------------------------------------------------------------------
638 // RRD DIMENSION functions
640 extern RRDDIM *rrddim_add(RRDSET *st, const char *id, const char *name, collected_number multiplier, collected_number divisor, RRD_ALGORITHM algorithm);
642 extern void rrddim_set_name(RRDSET *st, RRDDIM *rd, const char *name);
643 extern RRDDIM *rrddim_find(RRDSET *st, const char *id);
645 extern int rrddim_hide(RRDSET *st, const char *id);
646 extern int rrddim_unhide(RRDSET *st, const char *id);
648 extern collected_number rrddim_set_by_pointer(RRDSET *st, RRDDIM *rd, collected_number value);
649 extern collected_number rrddim_set(RRDSET *st, const char *id, collected_number value);
651 extern long align_entries_to_pagesize(RRD_MEMORY_MODE mode, long entries);
654 // ----------------------------------------------------------------------------
655 // RRD internal functions
657 #ifdef NETDATA_RRD_INTERNALS
659 extern avl_tree_lock rrdhost_root_index;
661 extern char *rrdset_strncpyz_name(char *to, const char *from, size_t length);
662 extern char *rrdset_cache_dir(RRDHOST *host, const char *id, const char *config_section);
664 extern void rrddim_free(RRDSET *st, RRDDIM *rd);
666 extern int rrddim_compare(void* a, void* b);
667 extern int rrdset_compare(void* a, void* b);
668 extern int rrdset_compare_name(void* a, void* b);
669 extern int rrdfamily_compare(void *a, void *b);
671 extern RRDFAMILY *rrdfamily_create(RRDHOST *host, const char *id);
672 extern void rrdfamily_free(RRDHOST *host, RRDFAMILY *rc);
674 #define rrdset_index_add(host, st) (RRDSET *)avl_insert_lock(&((host)->rrdset_root_index), (avl *)(st))
675 #define rrdset_index_del(host, st) (RRDSET *)avl_remove_lock(&((host)->rrdset_root_index), (avl *)(st))
676 extern RRDSET *rrdset_index_del_name(RRDHOST *host, RRDSET *st);
678 extern void rrdset_free(RRDSET *st);
679 extern void rrdset_reset(RRDSET *st);
680 extern void rrdset_save(RRDSET *st);
681 extern void rrdset_delete(RRDSET *st);
683 extern void rrdhost_cleanup_obsolete(RRDHOST *host);
685 #endif /* NETDATA_RRD_INTERNALS */
688 #endif /* NETDATA_RRD_H */