1 #ifndef NETDATA_HEALTH_H
2 #define NETDATA_HEALTH_H
4 extern int rrdvar_compare(void *a, void *b);
10 * There are 4 scopes: local (chart), context, host and global variables
12 * Standard global variables:
15 * Standard host variables:
18 * Standard context variables:
21 * Standard local variables:
23 * $last_collected_value
28 #define RRDVAR_TYPE_CALCULATED 1
29 #define RRDVAR_TYPE_TIME_T 2
30 #define RRDVAR_TYPE_COLLECTED 3
31 #define RRDVAR_TYPE_TOTAL 4
33 // the variables as stored in the variables indexes
34 // there are 3 indexes:
35 // 1. at each chart (RRDSET.variables_root_index)
36 // 2. at each context (RRDCONTEXT.variables_root_index)
37 // 3. at each host (RRDHOST.variables_root_index)
38 typedef struct rrdvar {
50 // variables linked to charts
51 // We link variables to point to the values that are already
52 // calculated / processed by the normal data collection process
53 // This means, there will be no speed penalty for using
55 typedef struct rrdsetvar {
56 char *fullid; // chart type.chart id.variable
59 char *fullname; // chart type.chart name.variable
60 uint32_t hash_fullname;
62 char *variable; // variable
63 uint32_t hash_variable;
76 struct rrdset *rrdset;
78 struct rrdsetvar *next;
82 // variables linked to individual dimensions
83 // We link variables to point the values that are already
84 // calculated / processed by the normal data collection process
85 // This means, there will be no speed penalty for using
87 typedef struct rrddimvar {
91 char *id; // dimension id
94 char *name; // dimension name
97 char *fullidid; // chart type.chart id.dimension id
98 uint32_t hash_fullidid;
100 char *fullidname; // chart type.chart id.dimension name
101 uint32_t hash_fullidname;
103 char *fullnameid; // chart type.chart name.dimension id
104 uint32_t hash_fullnameid;
106 char *fullnamename; // chart type.chart name.dimension name
107 uint32_t hash_fullnamename;
117 RRDVAR *context_fullidid;
118 RRDVAR *context_fullidname;
119 RRDVAR *context_fullnameid;
120 RRDVAR *context_fullnamename;
122 RRDVAR *host_fullidid;
123 RRDVAR *host_fullidname;
124 RRDVAR *host_fullnameid;
125 RRDVAR *host_fullnamename;
127 struct rrddim *rrddim;
129 struct rrddimvar *next;
132 // calculated variables (defined in health configuration)
133 // These aggregate time-series data at fixed intervals
134 // (defined in their update_every member below)
135 // These increase the overhead of netdata.
137 // These calculations are allocated and linked (->next)
139 // Then are also linked to RRDSET (of course only when the
140 // chart is found, via ->rrdset_next and ->rrdset_prev).
141 // This double-linked list is maintained sorted at all times
142 // having as RRDSET.calculations the RRDCALC to be processed
144 typedef struct rrdcalc {
150 char *chart; // the chart name
153 char *dimensions; // the chart dimensions
155 int group; // grouping method: average, max, etc.
156 int before; // ending point in time-series
157 int after; // starting point in time-series
158 uint32_t options; // calculation options
159 int update_every; // update frequency for the calculation
164 EVAL_EXPRESSION *warning;
165 EVAL_EXPRESSION *critical;
167 calculated_number value;
169 calculated_number green;
170 calculated_number red;
176 struct rrdset *rrdset;
177 struct rrdcalc *rrdset_next;
178 struct rrdcalc *rrdset_prev;
180 struct rrdcalc *next;
185 // these are to be applied to charts found dynamically
186 // based on their context.
187 typedef struct rrdcalctemplate {
194 uint32_t hash_context;
198 int group; // grouping method: average, max, etc.
199 int before; // ending point in time-series
200 int after; // starting point in time-series
201 uint32_t options; // calculation options
202 int update_every; // update frequency for the calculation
204 calculated_number green;
205 calculated_number red;
207 struct rrdcalctemplate *next;
213 extern void rrdsetvar_rename_all(RRDSET *st);
214 extern RRDSETVAR *rrdsetvar_create(RRDSET *st, const char *variable, int type, void *value, uint32_t options);
215 extern void rrdsetvar_free(RRDSETVAR *rs);
217 extern void rrddimvar_rename_all(RRDDIM *rd);
218 extern RRDDIMVAR *rrddimvar_create(RRDDIM *rd, int type, const char *prefix, const char *suffix, void *value, uint32_t options);
219 extern void rrddimvar_free(RRDDIMVAR *rs);
221 extern void rrdsetcalc_link_matching(RRDSET *st);
222 extern void rrdsetcalc_unlink(RRDCALC *rc);
224 extern void health_init(void);
226 #endif //NETDATA_HEALTH_H