src/target_set.c

   1 /**
   2  * collectd - src/target_set.c
   3  * Copyright (C) 2008       Florian Forster
   4  *
   5  * Permission is hereby granted, free of charge, to any person obtaining a
   6  * copy of this software and associated documentation files (the "Software"),
   7  * to deal in the Software without restriction, including without limitation
   8  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
   9  * and/or sell copies of the Software, and to permit persons to whom the
  10  * Software is furnished to do so, subject to the following conditions:
  11  *
  12  * The above copyright notice and this permission notice shall be included in
  13  * all copies or substantial portions of the Software.
  14  *
  15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18  * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  20  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  21  * DEALINGS IN THE SOFTWARE.
  22  *
  23  * Authors:
  24  *   Florian Forster <octo at collectd.org>
  25  **/
  26
  27 #include "collectd.h"
  28
  29 #include "common.h"
  30 #include "filter_chain.h"
  31 #include "meta_data.h"
  32 #include "utils_subst.h"
  33
  34 struct ts_key_list_s {
  35   char *key;
  36   struct ts_key_list_s *next;
  37 };
  38 typedef struct ts_key_list_s ts_key_list_t;
  39
  40 static void ts_key_list_free(ts_key_list_t *l) /* {{{ */
  41 {
  42   if (l == NULL)
  43     return;
  44
  45   sfree(l->key);
  46
  47   if (l->next != NULL)
  48     ts_key_list_free(l->next);
  49
  50   sfree(l);
  51 } /* }}} void ts_name_list_free */
  52
  53 struct ts_data_s {
  54   char *host;
  55   char *plugin;
  56   char *plugin_instance;
  57   /* char *type; */
  58   char *type_instance;
  59   meta_data_t *meta;
  60   ts_key_list_t *meta_delete;
  61 };
  62 typedef struct ts_data_s ts_data_t;
  63
  64 static int ts_util_get_key_and_string_wo_strdup(const oconfig_item_t *ci,
  65                                                 char **ret_key,
  66                                                 char **ret_string) /* {{{ */
  67 {
  68   if ((ci->values_num != 2) || (ci->values[0].type != OCONFIG_TYPE_STRING) ||
  69       (ci->values[1].type != OCONFIG_TYPE_STRING)) {
  70     ERROR("ts_util_get_key_and_string_wo_strdup: The %s option requires "
  71           "exactly two string arguments.",
  72           ci->key);
  73     return (-1);
  74   }
  75
  76   *ret_key = ci->values[0].value.string;
  77   *ret_string = ci->values[1].value.string;
  78
  79   return (0);
  80 } /* }}} int ts_util_get_key_and_string_wo_strdup */
  81
  82 static int ts_config_add_string(char **dest, /* {{{ */
  83                                 const oconfig_item_t *ci, int may_be_empty) {
  84   char *tmp = NULL;
  85   int status;
  86
  87   status = cf_util_get_string(ci, &tmp);
  88   if (status != 0)
  89     return (status);
  90
  91   if (!may_be_empty && (strlen(tmp) == 0)) {
  92     ERROR("Target `set': The `%s' option does not accept empty strings.",
  93           ci->key);
  94     sfree(tmp);
  95     return (-1);
  96   }
  97
  98   *dest = tmp;
  99   return (0);
 100 } /* }}} int ts_config_add_string */
 101
 102 static int ts_config_add_meta(meta_data_t **dest, /* {{{ */
 103                               const oconfig_item_t *ci, int may_be_empty) {
 104   char *key = NULL;
 105   char *string = NULL;
 106   int status;
 107
 108   status = ts_util_get_key_and_string_wo_strdup(ci, &key, &string);
 109   if (status != 0)
 110     return (status);
 111
 112   if (strlen(key) == 0) {
 113     ERROR("Target `set': The `%s' option does not accept empty string as "
 114           "first argument.",
 115           ci->key);
 116     return (-1);
 117   }
 118
 119   if (!may_be_empty && (strlen(string) == 0)) {
 120     ERROR("Target `set': The `%s' option does not accept empty string as "
 121           "second argument.",
 122           ci->key);
 123     return (-1);
 124   }
 125
 126   if ((*dest) == NULL) {
 127     /* Create a new meta_data_t */
 128     if ((*dest = meta_data_create()) == NULL) {
 129       ERROR("Target `set': failed to create a meta data for `%s'.", ci->key);
 130       return (-ENOMEM);
 131     }
 132   }
 133
 134   return (meta_data_add_string(*dest, key, string));
 135 } /* }}} int ts_config_add_meta */
 136
 137 static int ts_config_add_meta_delete(ts_key_list_t **dest, /* {{{ */
 138                                      const oconfig_item_t *ci) {
 139   ts_key_list_t *entry = NULL;
 140
 141   entry = calloc(1, sizeof(*entry));
 142   if (entry == NULL) {
 143     ERROR("ts_config_add_meta_delete: calloc failed.");
 144     return (-ENOMEM);
 145   }
 146
 147   if (cf_util_get_string(ci, &entry->key) != 0) {
 148     ts_key_list_free(entry);
 149     return (-1); /* An error has already been reported. */
 150   }
 151
 152   if (strlen(entry->key) == 0) {
 153     ERROR("Target `set': The `%s' option does not accept empty string as "
 154           "first argument.",
 155           ci->key);
 156     ts_key_list_free(entry);
 157     return (-1);
 158   }
 159
 160   entry->next = *dest;
 161   *dest = entry;
 162
 163   return (0);
 164 } /* }}} int ts_config_add_meta_delete */
 165
 166 static void ts_subst(char *dest, size_t size, const char *string, /* {{{ */
 167                      const value_list_t *vl) {
 168   char temp[DATA_MAX_NAME_LEN];
 169
 170   /* Initialize the field with the template. */
 171   sstrncpy(dest, string, size);
 172
 173   if (strchr(dest, '%') == NULL)
 174     return;
 175
 176 #define REPLACE_FIELD(t, v)                                                    \
 177   if (subst_string(temp, sizeof(temp), dest, t, v) != NULL)                    \
 178     sstrncpy(dest, temp, size);
 179   REPLACE_FIELD("%{host}", vl->host);
 180   REPLACE_FIELD("%{plugin}", vl->plugin);
 181   REPLACE_FIELD("%{plugin_instance}", vl->plugin_instance);
 182   REPLACE_FIELD("%{type}", vl->type);
 183   REPLACE_FIELD("%{type_instance}", vl->type_instance);
 184
 185   if (vl->meta != NULL) {
 186     char **meta_toc = NULL;
 187     int meta_entries = meta_data_toc(vl->meta, &meta_toc);
 188     if (meta_entries <= 0)
 189       return;
 190
 191     for (int i = 0; i < meta_entries; i++) {
 192       char meta_name[DATA_MAX_NAME_LEN];
 193       char *value_str;
 194       const char *key = meta_toc[i];
 195
 196       ssnprintf(meta_name, sizeof(meta_name), "%%{meta:%s}", key);
 197       if (meta_data_as_string(vl->meta, key, &value_str) != 0)
 198         continue;
 199
 200       REPLACE_FIELD(meta_name, value_str);
 201       sfree(value_str);
 202     }
 203
 204     strarray_free(meta_toc, (size_t)meta_entries);
 205   }
 206 } /* }}} int ts_subst */
 207
 208 static int ts_destroy(void **user_data) /* {{{ */
 209 {
 210   ts_data_t *data;
 211
 212   if (user_data == NULL)
 213     return (-EINVAL);
 214
 215   data = *user_data;
 216   if (data == NULL)
 217     return (0);
 218
 219   free(data->host);
 220   free(data->plugin);
 221   free(data->plugin_instance);
 222   /* free (data->type); */
 223   free(data->type_instance);
 224   meta_data_destroy(data->meta);
 225   ts_key_list_free(data->meta_delete);
 226   free(data);
 227
 228   return (0);
 229 } /* }}} int ts_destroy */
 230
 231 static int ts_create(const oconfig_item_t *ci, void **user_data) /* {{{ */
 232 {
 233   ts_data_t *data;
 234   int status;
 235
 236   data = calloc(1, sizeof(*data));
 237   if (data == NULL) {
 238     ERROR("ts_create: calloc failed.");
 239     return (-ENOMEM);
 240   }
 241
 242   data->host = NULL;
 243   data->plugin = NULL;
 244   data->plugin_instance = NULL;
 245   /* data->type = NULL; */
 246   data->type_instance = NULL;
 247   data->meta = NULL;
 248   data->meta_delete = NULL;
 249
 250   status = 0;
 251   for (int i = 0; i < ci->children_num; i++) {
 252     oconfig_item_t *child = ci->children + i;
 253
 254     if ((strcasecmp("Host", child->key) == 0) ||
 255         (strcasecmp("Hostname", child->key) == 0))
 256       status = ts_config_add_string(&data->host, child,
 257                                     /* may be empty = */ 0);
 258     else if (strcasecmp("Plugin", child->key) == 0)
 259       status = ts_config_add_string(&data->plugin, child,
 260                                     /* may be empty = */ 0);
 261     else if (strcasecmp("PluginInstance", child->key) == 0)
 262       status = ts_config_add_string(&data->plugin_instance, child,
 263                                     /* may be empty = */ 1);
 264 #if 0
 265     else if (strcasecmp ("Type", child->key) == 0)
 266       status = ts_config_add_string (&data->type, child,
 267           /* may be empty = */ 0);
 268 #endif
 269     else if (strcasecmp("TypeInstance", child->key) == 0)
 270       status = ts_config_add_string(&data->type_instance, child,
 271                                     /* may be empty = */ 1);
 272     else if (strcasecmp("MetaData", child->key) == 0)
 273       status = ts_config_add_meta(&data->meta, child,
 274                                   /* may be empty = */ 1);
 275     else if (strcasecmp("DeleteMetaData", child->key) == 0)
 276       status = ts_config_add_meta_delete(&data->meta_delete, child);
 277     else {
 278       ERROR("Target `set': The `%s' configuration option is not understood "
 279             "and will be ignored.",
 280             child->key);
 281       status = 0;
 282     }
 283
 284     if (status != 0)
 285       break;
 286   }
 287
 288   /* Additional sanity-checking */
 289   while (status == 0) {
 290     if ((data->host == NULL) && (data->plugin == NULL) &&
 291         (data->plugin_instance == NULL)
 292         /* && (data->type == NULL) */
 293         && (data->type_instance == NULL) && (data->meta == NULL) &&
 294         (data->meta_delete == NULL)) {
 295       ERROR("Target `set': You need to set at least one of `Host', "
 296             "`Plugin', `PluginInstance', `TypeInstance', "
 297             "`MetaData', or `DeleteMetaData'.");
 298       status = -1;
 299     }
 300
 301     if (data->meta != NULL) {
 302       /* If data->meta_delete is NULL, this loop is a no-op. */
 303       for (ts_key_list_t *l = data->meta_delete; l != NULL; l = l->next) {
 304         if (meta_data_type(data->meta, l->key) != 0) {
 305           /* MetaData and DeleteMetaData for the same key. */
 306           ERROR("Target `set': Can only have one of `MetaData' or "
 307                 "`DeleteMetaData' for any given key.");
 308           status = -1;
 309         }
 310       }
 311     }
 312
 313     break;
 314   }
 315
 316   if (status != 0) {
 317     ts_destroy((void *)&data);
 318     return (status);
 319   }
 320
 321   *user_data = data;
 322   return (0);
 323 } /* }}} int ts_create */
 324
 325 static int ts_invoke(const data_set_t *ds, value_list_t *vl, /* {{{ */
 326                      notification_meta_t __attribute__((unused)) * *meta,
 327                      void **user_data) {
 328   ts_data_t *data;
 329   value_list_t orig;
 330   meta_data_t *new_meta = NULL;
 331
 332   if ((ds == NULL) || (vl == NULL) || (user_data == NULL))
 333     return (-EINVAL);
 334
 335   data = *user_data;
 336   if (data == NULL) {
 337     ERROR("Target `set': Invoke: `data' is NULL.");
 338     return (-EINVAL);
 339   }
 340
 341   orig = *vl;
 342
 343   if (data->meta != NULL) {
 344     char temp[DATA_MAX_NAME_LEN * 2];
 345     int meta_entries;
 346     char **meta_toc;
 347
 348     if ((new_meta = meta_data_create()) == NULL) {
 349       ERROR("Target `set': failed to create replacement metadata.");
 350       return (-ENOMEM);
 351     }
 352
 353     meta_entries = meta_data_toc(data->meta, &meta_toc);
 354     for (int i = 0; i < meta_entries; i++) {
 355       const char *key = meta_toc[i];
 356       char *string;
 357       int status;
 358
 359       status = meta_data_get_string(data->meta, key, &string);
 360       if (status) {
 361         ERROR("Target `set': Unable to get replacement metadata value `%s'.",
 362               key);
 363         strarray_free(meta_toc, (size_t)meta_entries);
 364         meta_data_destroy(new_meta);
 365         return (status);
 366       }
 367
 368       ts_subst(temp, sizeof(temp), string, &orig);
 369
 370       DEBUG("target_set: ts_invoke: setting metadata value for key `%s': "
 371             "`%s'.",
 372             key, temp);
 373
 374       sfree(string);
 375
 376       status = meta_data_add_string(new_meta, key, temp);
 377       if (status) {
 378         ERROR("Target `set': Unable to set metadata value `%s'.", key);
 379         strarray_free(meta_toc, (size_t)meta_entries);
 380         meta_data_destroy(new_meta);
 381         return (status);
 382       }
 383     }
 384
 385     strarray_free(meta_toc, (size_t)meta_entries);
 386   }
 387
 388 #define SUBST_FIELD(f)                                                         \
 389   if (data->f != NULL) {                                                       \
 390     ts_subst(vl->f, sizeof(vl->f), data->f, &orig);                            \
 391     DEBUG("target_set: ts_invoke: setting " #f ": `%s'.", vl->f);              \
 392   }
 393   SUBST_FIELD(host);
 394   SUBST_FIELD(plugin);
 395   SUBST_FIELD(plugin_instance);
 396   /* SUBST_FIELD (type); */
 397   SUBST_FIELD(type_instance);
 398
 399   /* Need to merge the metadata in now, because of the shallow copy. */
 400   if (new_meta != NULL) {
 401     meta_data_clone_merge(&(vl->meta), new_meta);
 402     meta_data_destroy(new_meta);
 403   }
 404
 405   /* If data->meta_delete is NULL, this loop is a no-op. */
 406   for (ts_key_list_t *l = data->meta_delete; l != NULL; l = l->next) {
 407     DEBUG("target_set: ts_invoke: deleting metadata value for key `%s'.",
 408           l->key);
 409     meta_data_delete(vl->meta, l->key);
 410   }
 411
 412   return (FC_TARGET_CONTINUE);
 413 } /* }}} int ts_invoke */
 414
 415 void module_register(void) {
 416   target_proc_t tproc = {0};
 417
 418   tproc.create = ts_create;
 419   tproc.destroy = ts_destroy;
 420   tproc.invoke = ts_invoke;
 421   fc_register_target("set", tproc);
 422 } /* module_register */