2 * collectd - src/ascent.c
3 * Copyright (C) 2008 Florian octo Forster
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:
12 * The above copyright notice and this permission notice shall be included in
13 * all copies or substantial portions of the Software.
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.
24 * Florian octo Forster <octo at collectd.org>
32 #include <curl/curl.h>
33 #include <libxml/parser.h>
35 static const char *races_list[] = /* {{{ */
50 #define RACES_LIST_LENGTH STATIC_ARRAY_SIZE (races_list)
52 static const char *classes_list[] = /* {{{ */
67 #define CLASSES_LIST_LENGTH STATIC_ARRAY_SIZE (classes_list)
69 static const char *genders_list[] = /* {{{ */
74 #define GENDERS_LIST_LENGTH STATIC_ARRAY_SIZE (genders_list)
78 int races[RACES_LIST_LENGTH];
79 int classes[CLASSES_LIST_LENGTH];
80 int genders[GENDERS_LIST_LENGTH];
86 typedef struct player_stats_s player_stats_t;
96 typedef struct player_info_s player_info_t;
97 #define PLAYER_INFO_STATIC_INIT { -1, -1, -1, -1, -1 }
99 static char *url = NULL;
100 static char *user = NULL;
101 static char *pass = NULL;
102 static char *verify_peer = NULL;
103 static char *verify_host = NULL;
104 static char *cacert = NULL;
105 static char *timeout = NULL;
107 static CURL *curl = NULL;
109 static char *ascent_buffer = NULL;
110 static size_t ascent_buffer_size = 0;
111 static size_t ascent_buffer_fill = 0;
112 static char ascent_curl_error[CURL_ERROR_SIZE];
114 static const char *config_keys[] =
124 static int config_keys_num = STATIC_ARRAY_SIZE (config_keys);
126 static int ascent_submit_gauge (const char *plugin_instance, /* {{{ */
127 const char *type, const char *type_instance, gauge_t value)
129 value_list_t vl = VALUE_LIST_INIT;
131 vl.values = &(value_t) { .gauge = value };
133 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
134 sstrncpy (vl.plugin, "ascent", sizeof (vl.plugin));
136 if (plugin_instance != NULL)
137 sstrncpy (vl.plugin_instance, plugin_instance,
138 sizeof (vl.plugin_instance));
140 sstrncpy (vl.type, type, sizeof (vl.type));
142 if (type_instance != NULL)
143 sstrncpy (vl.type_instance, type_instance, sizeof (vl.type_instance));
145 plugin_dispatch_values (&vl);
147 } /* }}} int ascent_submit_gauge */
149 static size_t ascent_curl_callback (void *buf, size_t size, size_t nmemb, /* {{{ */
150 void __attribute__((unused)) *stream)
152 size_t len = size * nmemb;
157 if ((ascent_buffer_fill + len) >= ascent_buffer_size)
161 temp = realloc (ascent_buffer,
162 ascent_buffer_fill + len + 1);
165 ERROR ("ascent plugin: realloc failed.");
168 ascent_buffer = temp;
169 ascent_buffer_size = ascent_buffer_fill + len + 1;
172 memcpy (ascent_buffer + ascent_buffer_fill, (char *) buf, len);
173 ascent_buffer_fill += len;
174 ascent_buffer[ascent_buffer_fill] = 0;
177 } /* }}} size_t ascent_curl_callback */
179 static int ascent_submit_players (player_stats_t *ps) /* {{{ */
183 for (size_t i = 0; i < RACES_LIST_LENGTH; i++)
184 if (races_list[i] != NULL)
185 ascent_submit_gauge ("by-race", "players", races_list[i],
186 (gauge_t) ps->races[i]);
188 for (size_t i = 0; i < CLASSES_LIST_LENGTH; i++)
189 if (classes_list[i] != NULL)
190 ascent_submit_gauge ("by-class", "players", classes_list[i],
191 (gauge_t) ps->classes[i]);
193 for (size_t i = 0; i < GENDERS_LIST_LENGTH; i++)
194 if (genders_list[i] != NULL)
195 ascent_submit_gauge ("by-gender", "players", genders_list[i],
196 (gauge_t) ps->genders[i]);
198 if (ps->level_num <= 0)
201 value = ((double) ps->level_sum) / ((double) ps->level_num);
202 ascent_submit_gauge (NULL, "gauge", "avg-level", value);
204 /* Latency is in ms, but we store seconds. */
205 if (ps->latency_num <= 0)
208 value = ((double) ps->latency_sum) / (1000.0 * ((double) ps->latency_num));
209 ascent_submit_gauge (NULL, "latency", "average", value);
212 } /* }}} int ascent_submit_players */
214 static int ascent_account_player (player_stats_t *ps, /* {{{ */
219 if (((size_t) pi->race >= RACES_LIST_LENGTH)
220 || (races_list[pi->race] == NULL))
221 ERROR ("ascent plugin: Ignoring invalid numeric race %i.", pi->race);
223 ps->races[pi->race]++;
228 if (((size_t) pi->class >= CLASSES_LIST_LENGTH)
229 || (classes_list[pi->class] == NULL))
230 ERROR ("ascent plugin: Ignoring invalid numeric class %i.", pi->class);
232 ps->classes[pi->class]++;
237 if (((size_t) pi->gender >= GENDERS_LIST_LENGTH)
238 || (genders_list[pi->gender] == NULL))
239 ERROR ("ascent plugin: Ignoring invalid numeric gender %i.",
242 ps->genders[pi->gender]++;
248 ps->level_sum += pi->level;
252 if (pi->latency >= 0)
254 ps->latency_sum += pi->latency;
259 } /* }}} int ascent_account_player */
261 static int ascent_xml_submit_gauge (xmlDoc *doc, xmlNode *node, /* {{{ */
262 const char *plugin_instance, const char *type, const char *type_instance)
267 str_ptr = (char *) xmlNodeListGetString (doc, node->xmlChildrenNode, 1);
270 ERROR ("ascent plugin: ascent_xml_submit_gauge: xmlNodeListGetString failed.");
274 if (strcasecmp ("N/A", str_ptr) == 0)
278 char *end_ptr = NULL;
279 value = strtod (str_ptr, &end_ptr);
280 if (str_ptr == end_ptr)
283 ERROR ("ascent plugin: ascent_xml_submit_gauge: strtod failed.");
289 return (ascent_submit_gauge (plugin_instance, type, type_instance, value));
290 } /* }}} int ascent_xml_submit_gauge */
292 static int ascent_xml_read_int (xmlDoc *doc, xmlNode *node, /* {{{ */
298 str_ptr = (char *) xmlNodeListGetString (doc, node->xmlChildrenNode, 1);
301 ERROR ("ascent plugin: ascent_xml_read_int: xmlNodeListGetString failed.");
305 if (strcasecmp ("N/A", str_ptr) == 0)
309 char *end_ptr = NULL;
310 value = strtol (str_ptr, &end_ptr, 0);
311 if (str_ptr == end_ptr)
314 ERROR ("ascent plugin: ascent_xml_read_int: strtol failed.");
322 } /* }}} int ascent_xml_read_int */
324 static int ascent_xml_sessions_plr (xmlDoc *doc, xmlNode *node, /* {{{ */
327 for (xmlNode *child = node->xmlChildrenNode; child != NULL; child = child->next)
329 if ((xmlStrcmp ((const xmlChar *) "comment", child->name) == 0)
330 || (xmlStrcmp ((const xmlChar *) "text", child->name) == 0))
332 else if (xmlStrcmp ((const xmlChar *) "race", child->name) == 0)
333 ascent_xml_read_int (doc, child, &pi->race);
334 else if (xmlStrcmp ((const xmlChar *) "class", child->name) == 0)
335 ascent_xml_read_int (doc, child, &pi->class);
336 else if (xmlStrcmp ((const xmlChar *) "gender", child->name) == 0)
337 ascent_xml_read_int (doc, child, &pi->gender);
338 else if (xmlStrcmp ((const xmlChar *) "level", child->name) == 0)
339 ascent_xml_read_int (doc, child, &pi->level);
340 else if (xmlStrcmp ((const xmlChar *) "latency", child->name) == 0)
341 ascent_xml_read_int (doc, child, &pi->latency);
342 else if ((xmlStrcmp ((const xmlChar *) "name", child->name) == 0)
343 || (xmlStrcmp ((const xmlChar *) "pvprank", child->name) == 0)
344 || (xmlStrcmp ((const xmlChar *) "map", child->name) == 0)
345 || (xmlStrcmp ((const xmlChar *) "areaid", child->name) == 0)
346 || (xmlStrcmp ((const xmlChar *) "xpos", child->name) == 0)
347 || (xmlStrcmp ((const xmlChar *) "ypos", child->name) == 0)
348 || (xmlStrcmp ((const xmlChar *) "onime", child->name) == 0))
352 WARNING ("ascent plugin: ascent_xml_status: Unknown tag: %s", child->name);
357 } /* }}} int ascent_xml_sessions_plr */
359 static int ascent_xml_sessions (xmlDoc *doc, xmlNode *node) /* {{{ */
361 player_stats_t ps = {
365 for (xmlNode *child = node->xmlChildrenNode; child != NULL; child = child->next)
367 if ((xmlStrcmp ((const xmlChar *) "comment", child->name) == 0)
368 || (xmlStrcmp ((const xmlChar *) "text", child->name) == 0))
370 else if (xmlStrcmp ((const xmlChar *) "plr", child->name) == 0)
373 player_info_t pi = PLAYER_INFO_STATIC_INIT;
375 status = ascent_xml_sessions_plr (doc, child, &pi);
377 ascent_account_player (&ps, &pi);
381 WARNING ("ascent plugin: ascent_xml_status: Unknown tag: %s", child->name);
385 ascent_submit_players (&ps);
388 } /* }}} int ascent_xml_sessions */
390 static int ascent_xml_status (xmlDoc *doc, xmlNode *node) /* {{{ */
392 for (xmlNode *child = node->xmlChildrenNode; child != NULL; child = child->next)
394 if ((xmlStrcmp ((const xmlChar *) "comment", child->name) == 0)
395 || (xmlStrcmp ((const xmlChar *) "text", child->name) == 0))
397 else if (xmlStrcmp ((const xmlChar *) "alliance", child->name) == 0)
398 ascent_xml_submit_gauge (doc, child, NULL, "players", "alliance");
399 else if (xmlStrcmp ((const xmlChar *) "horde", child->name) == 0)
400 ascent_xml_submit_gauge (doc, child, NULL, "players", "horde");
401 else if (xmlStrcmp ((const xmlChar *) "qplayers", child->name) == 0)
402 ascent_xml_submit_gauge (doc, child, NULL, "players", "queued");
403 else if ((xmlStrcmp ((const xmlChar *) "acceptedconns", child->name) == 0)
404 || (xmlStrcmp ((const xmlChar *) "avglat", child->name) == 0)
405 || (xmlStrcmp ((const xmlChar *) "cdbquerysize", child->name) == 0)
406 || (xmlStrcmp ((const xmlChar *) "cpu", child->name) == 0)
407 || (xmlStrcmp ((const xmlChar *) "fthreads", child->name) == 0)
408 || (xmlStrcmp ((const xmlChar *) "gmcount", child->name) == 0)
409 || (xmlStrcmp ((const xmlChar *) "lastupdate", child->name) == 0)
410 || (xmlStrcmp ((const xmlChar *) "ontime", child->name) == 0)
411 || (xmlStrcmp ((const xmlChar *) "oplayers", child->name) == 0)
412 || (xmlStrcmp ((const xmlChar *) "peakcount", child->name) == 0)
413 || (xmlStrcmp ((const xmlChar *) "platform", child->name) == 0)
414 || (xmlStrcmp ((const xmlChar *) "ram", child->name) == 0)
415 || (xmlStrcmp ((const xmlChar *) "threads", child->name) == 0)
416 || (xmlStrcmp ((const xmlChar *) "uptime", child->name) == 0)
417 || (xmlStrcmp ((const xmlChar *) "wdbquerysize", child->name) == 0))
421 WARNING ("ascent plugin: ascent_xml_status: Unknown tag: %s", child->name);
426 } /* }}} int ascent_xml_status */
428 static int ascent_xml (const char *data) /* {{{ */
434 doc = xmlParseMemory (data, strlen (data),
435 /* URL = */ "ascent.xml",
436 /* encoding = */ NULL,
439 doc = xmlParseMemory (data, strlen (data));
443 ERROR ("ascent plugin: xmlParseMemory failed.");
447 cur = xmlDocGetRootElement (doc);
450 ERROR ("ascent plugin: XML document is empty.");
455 if (xmlStrcmp ((const xmlChar *) "serverpage", cur->name) != 0)
457 ERROR ("ascent plugin: XML root element is not \"serverpage\".");
462 for (xmlNode *child = cur->xmlChildrenNode; child != NULL; child = child->next)
464 if ((xmlStrcmp ((const xmlChar *) "comment", child->name) == 0)
465 || (xmlStrcmp ((const xmlChar *) "text", child->name) == 0))
467 else if (xmlStrcmp ((const xmlChar *) "status", child->name) == 0)
468 ascent_xml_status (doc, child);
469 else if (xmlStrcmp ((const xmlChar *) "instances", child->name) == 0)
470 /* ignore for now */;
471 else if (xmlStrcmp ((const xmlChar *) "gms", child->name) == 0)
472 /* ignore for now */;
473 else if (xmlStrcmp ((const xmlChar *) "sessions", child->name) == 0)
474 ascent_xml_sessions (doc, child);
477 WARNING ("ascent plugin: ascent_xml: Unknown tag: %s", child->name);
483 } /* }}} int ascent_xml */
485 static int config_set (char **var, const char *value) /* {{{ */
493 if ((*var = strdup (value)) == NULL)
497 } /* }}} int config_set */
499 static int ascent_config (const char *key, const char *value) /* {{{ */
501 if (strcasecmp (key, "URL") == 0)
502 return (config_set (&url, value));
503 else if (strcasecmp (key, "User") == 0)
504 return (config_set (&user, value));
505 else if (strcasecmp (key, "Password") == 0)
506 return (config_set (&pass, value));
507 else if (strcasecmp (key, "VerifyPeer") == 0)
508 return (config_set (&verify_peer, value));
509 else if (strcasecmp (key, "VerifyHost") == 0)
510 return (config_set (&verify_host, value));
511 else if (strcasecmp (key, "CACert") == 0)
512 return (config_set (&cacert, value));
513 else if (strcasecmp (key, "Timeout") == 0)
514 return (config_set (&timeout, value));
517 } /* }}} int ascent_config */
519 static int ascent_init (void) /* {{{ */
523 WARNING ("ascent plugin: ascent_init: No URL configured, "
524 "returning an error.");
530 curl_easy_cleanup (curl);
533 if ((curl = curl_easy_init ()) == NULL)
535 ERROR ("ascent plugin: ascent_init: curl_easy_init failed.");
539 curl_easy_setopt (curl, CURLOPT_NOSIGNAL, 1L);
540 curl_easy_setopt (curl, CURLOPT_WRITEFUNCTION, ascent_curl_callback);
541 curl_easy_setopt (curl, CURLOPT_USERAGENT, COLLECTD_USERAGENT);
542 curl_easy_setopt (curl, CURLOPT_ERRORBUFFER, ascent_curl_error);
546 #ifdef HAVE_CURLOPT_USERNAME
547 curl_easy_setopt (curl, CURLOPT_USERNAME, user);
548 curl_easy_setopt (curl, CURLOPT_PASSWORD, (pass == NULL) ? "" : pass);
550 static char credentials[1024];
553 status = ssnprintf (credentials, sizeof (credentials), "%s:%s",
554 user, (pass == NULL) ? "" : pass);
555 if ((status < 0) || ((size_t) status >= sizeof (credentials)))
557 ERROR ("ascent plugin: ascent_init: Returning an error because the "
558 "credentials have been truncated.");
562 curl_easy_setopt (curl, CURLOPT_USERPWD, credentials);
566 curl_easy_setopt (curl, CURLOPT_URL, url);
567 curl_easy_setopt (curl, CURLOPT_FOLLOWLOCATION, 1L);
568 curl_easy_setopt (curl, CURLOPT_MAXREDIRS, 50L);
570 if ((verify_peer == NULL) || IS_TRUE (verify_peer))
571 curl_easy_setopt (curl, CURLOPT_SSL_VERIFYPEER, 1L);
573 curl_easy_setopt (curl, CURLOPT_SSL_VERIFYPEER, 0L);
575 if ((verify_host == NULL) || IS_TRUE (verify_host))
576 curl_easy_setopt (curl, CURLOPT_SSL_VERIFYHOST, 2L);
578 curl_easy_setopt (curl, CURLOPT_SSL_VERIFYHOST, 0L);
581 curl_easy_setopt (curl, CURLOPT_CAINFO, cacert);
583 #ifdef HAVE_CURLOPT_TIMEOUT_MS
585 curl_easy_setopt (curl, CURLOPT_TIMEOUT_MS, atol(timeout));
587 curl_easy_setopt (curl, CURLOPT_TIMEOUT_MS, (long) CDTIME_T_TO_MS(plugin_get_interval()));
591 } /* }}} int ascent_init */
593 static int ascent_read (void) /* {{{ */
599 ERROR ("ascent plugin: I don't have a CURL object.");
605 ERROR ("ascent plugin: No URL has been configured.");
609 ascent_buffer_fill = 0;
610 if (curl_easy_perform (curl) != CURLE_OK)
612 ERROR ("ascent plugin: curl_easy_perform failed: %s",
617 status = ascent_xml (ascent_buffer);
622 } /* }}} int ascent_read */
624 void module_register (void)
626 plugin_register_config ("ascent", ascent_config, config_keys, config_keys_num);
627 plugin_register_init ("ascent", ascent_init);
628 plugin_register_read ("ascent", ascent_read);
629 } /* void module_register */
631 /* vim: set sw=2 sts=2 ts=8 et fdm=marker : */