2 * collectd - src/pinba.c (based on code from pinba_engine 0.0.5)
3 * Copyright (c) 2007-2009 Antony Dovgal
4 * Copyright (C) 2010 Phoenix Kayo
5 * Copyright (C) 2010 Florian Forster
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation; only version 2 of the License is applicable.
11 * This program is distributed in the hope that it will be useful, but
12 * WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
21 * Antony Dovgal <tony at daylessday.org>
22 * Phoenix Kayo <kayo.k11.4 at gmail.com>
23 * Florian Forster <octo at collectd.org>
29 #include "configfile.h"
35 #include "pinba.pb-c.h"
37 /* AIX doesn't have MSG_DONTWAIT */
39 # define MSG_DONTWAIT MSG_NONBLOCK
45 #ifndef PINBA_UDP_BUFFER_SIZE
46 # define PINBA_UDP_BUFFER_SIZE 65536
49 #ifndef PINBA_DEFAULT_NODE
50 # define PINBA_DEFAULT_NODE "::0"
53 #ifndef PINBA_DEFAULT_SERVICE
54 # define PINBA_DEFAULT_SERVICE "30002"
57 #ifndef PINBA_MAX_SOCKETS
58 # define PINBA_MAX_SOCKETS 16
62 * Private data structures
67 struct pollfd fd[PINBA_MAX_SOCKETS];
70 typedef struct pinba_socket_s pinba_socket_t;
72 /* Fixed point counter value. n is the decimal part multiplied by 10^9. */
73 struct float_counter_s
76 uint64_t n; /* nanos */
78 typedef struct float_counter_s float_counter_t;
80 struct pinba_statnode_s
82 /* collector name, used as plugin instance */
92 float_counter_t req_time;
93 float_counter_t ru_utime;
94 float_counter_t ru_stime;
99 typedef struct pinba_statnode_s pinba_statnode_t;
103 * Module global variables
106 static pinba_statnode_t *stat_nodes = NULL;
107 static unsigned int stat_nodes_num = 0;
108 static pthread_mutex_t stat_nodes_lock;
110 static char *conf_node = NULL;
111 static char *conf_service = NULL;
113 static _Bool collector_thread_running = 0;
114 static _Bool collector_thread_do_shutdown = 0;
115 static pthread_t collector_thread_id;
121 static void float_counter_add (float_counter_t *fc, float val) /* {{{ */
128 tmp = (uint64_t) val;
132 fc->n += (uint64_t) ((val * 1000000000.0) + .5);
134 if (fc->n >= 1000000000)
138 assert (fc->n < 1000000000);
140 } /* }}} void float_counter_add */
142 static derive_t float_counter_get (const float_counter_t *fc, /* {{{ */
147 ret = (derive_t) (fc->i * factor);
148 ret += (derive_t) (fc->n / (1000000000 / factor));
151 } /* }}} derive_t float_counter_get */
153 static void strset (char **str, const char *new) /* {{{ */
166 } /* }}} void strset */
168 static void service_statnode_add(const char *name, /* {{{ */
173 pinba_statnode_t *node;
175 node = realloc (stat_nodes,
176 sizeof (*stat_nodes) * (stat_nodes_num + 1));
179 ERROR ("pinba plugin: realloc failed");
184 node = stat_nodes + stat_nodes_num;
185 memset (node, 0, sizeof (*node));
193 node->mem_peak = NAN;
195 /* fill query data */
196 strset (&node->name, name);
197 strset (&node->host, host);
198 strset (&node->server, server);
199 strset (&node->script, script);
201 /* increment counter */
203 } /* }}} void service_statnode_add */
205 /* Copy the data from the global "stat_nodes" list into the buffer pointed to
206 * by "res", doing the derivation in the process. Returns the next index or
207 * zero if the end of the list has been reached. */
208 static unsigned int service_statnode_collect (pinba_statnode_t *res, /* {{{ */
211 pinba_statnode_t *node;
213 if (stat_nodes_num == 0)
216 /* begin collecting */
218 pthread_mutex_lock (&stat_nodes_lock);
221 if (index >= stat_nodes_num)
223 pthread_mutex_unlock (&stat_nodes_lock);
227 node = stat_nodes + index;
228 memcpy (res, node, sizeof (*res));
231 node->mem_peak = NAN;
234 } /* }}} unsigned int service_statnode_collect */
236 static void service_statnode_process (pinba_statnode_t *node, /* {{{ */
237 Pinba__Request* request)
241 float_counter_add (&node->req_time, request->request_time);
242 float_counter_add (&node->ru_utime, request->ru_utime);
243 float_counter_add (&node->ru_stime, request->ru_stime);
245 node->doc_size += request->document_size;
247 if (isnan (node->mem_peak)
248 || (node->mem_peak < ((gauge_t) request->memory_peak)))
249 node->mem_peak = (gauge_t) request->memory_peak;
251 } /* }}} void service_statnode_process */
253 static void service_process_request (Pinba__Request *request) /* {{{ */
257 pthread_mutex_lock (&stat_nodes_lock);
259 for (i = 0; i < stat_nodes_num; i++)
261 if ((stat_nodes[i].host != NULL)
262 && (strcmp (request->hostname, stat_nodes[i].host) != 0))
265 if ((stat_nodes[i].server != NULL)
266 && (strcmp (request->server_name, stat_nodes[i].server) != 0))
269 if ((stat_nodes[i].script != NULL)
270 && (strcmp (request->script_name, stat_nodes[i].script) != 0))
273 service_statnode_process(&stat_nodes[i], request);
276 pthread_mutex_unlock(&stat_nodes_lock);
277 } /* }}} void service_process_request */
279 static int pb_del_socket (pinba_socket_t *s, /* {{{ */
282 if (index >= s->fd_num)
285 close (s->fd[index].fd);
286 s->fd[index].fd = -1;
288 /* When deleting the last element in the list, no memmove is necessary. */
289 if (index < (s->fd_num - 1))
291 memmove (&s->fd[index], &s->fd[index + 1],
292 sizeof (s->fd[0]) * (s->fd_num - (index + 1)));
297 } /* }}} int pb_del_socket */
299 static int pb_add_socket (pinba_socket_t *s, /* {{{ */
300 const struct addrinfo *ai)
306 if (s->fd_num == PINBA_MAX_SOCKETS)
308 WARNING ("pinba plugin: Sorry, you have hit the built-in limit of "
309 "%i sockets. Please complain to the collectd developers so we can "
310 "raise the limit.", PINBA_MAX_SOCKETS);
314 fd = socket (ai->ai_family, ai->ai_socktype, ai->ai_protocol);
318 ERROR ("pinba plugin: socket(2) failed: %s",
319 sstrerror (errno, errbuf, sizeof (errbuf)));
324 status = setsockopt (fd, SOL_SOCKET, SO_REUSEADDR, &tmp, sizeof (tmp));
328 WARNING ("pinba plugin: setsockopt(SO_REUSEADDR) failed: %s",
329 sstrerror (errno, errbuf, sizeof (errbuf)));
332 status = bind (fd, ai->ai_addr, ai->ai_addrlen);
336 ERROR ("pinba plugin: bind(2) failed: %s",
337 sstrerror (errno, errbuf, sizeof (errbuf)));
341 s->fd[s->fd_num].fd = fd;
342 s->fd[s->fd_num].events = POLLIN | POLLPRI;
343 s->fd[s->fd_num].revents = 0;
347 } /* }}} int pb_add_socket */
349 static pinba_socket_t *pinba_socket_open (const char *node, /* {{{ */
353 struct addrinfo *ai_list;
354 struct addrinfo *ai_ptr;
355 struct addrinfo ai_hints;
358 memset (&ai_hints, 0, sizeof (ai_hints));
359 ai_hints.ai_flags = AI_PASSIVE;
360 ai_hints.ai_family = AF_UNSPEC;
361 ai_hints.ai_socktype = SOCK_DGRAM;
362 ai_hints.ai_addr = NULL;
363 ai_hints.ai_canonname = NULL;
364 ai_hints.ai_next = NULL;
367 node = PINBA_DEFAULT_NODE;
370 service = PINBA_DEFAULT_SERVICE;
373 status = getaddrinfo (node, service,
374 &ai_hints, &ai_list);
377 ERROR ("pinba plugin: getaddrinfo(3) failed: %s",
378 gai_strerror (status));
381 assert (ai_list != NULL);
383 s = malloc (sizeof (*s));
386 freeaddrinfo (ai_list);
387 ERROR ("pinba plugin: malloc failed.");
390 memset (s, 0, sizeof (*s));
392 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next)
394 status = pb_add_socket (s, ai_ptr);
397 } /* for (ai_list) */
399 freeaddrinfo (ai_list);
403 WARNING ("pinba plugin: Unable to open socket for address %s.", node);
409 } /* }}} pinba_socket_open */
411 static void pinba_socket_free (pinba_socket_t *socket) /* {{{ */
418 for (i = 0; i < socket->fd_num; i++)
420 if (socket->fd[i].fd < 0)
422 close (socket->fd[i].fd);
423 socket->fd[i].fd = -1;
427 } /* }}} void pinba_socket_free */
429 static int pinba_process_stats_packet (const uint8_t *buffer, /* {{{ */
432 Pinba__Request *request;
434 request = pinba__request__unpack (NULL, buffer_size, buffer);
439 service_process_request(request);
440 pinba__request__free_unpacked (request, NULL);
443 } /* }}} int pinba_process_stats_packet */
445 static int pinba_udp_read_callback_fn (int sock) /* {{{ */
447 uint8_t buffer[PINBA_UDP_BUFFER_SIZE];
453 buffer_size = sizeof (buffer);
454 status = recvfrom (sock, buffer, buffer_size - 1, MSG_DONTWAIT, /* from = */ NULL, /* from len = */ 0);
461 || (errno == EWOULDBLOCK)
463 || (errno == EAGAIN))
468 WARNING("pinba plugin: recvfrom(2) failed: %s",
469 sstrerror (errno, errbuf, sizeof (errbuf)));
472 else if (status == 0)
474 DEBUG ("pinba plugin: recvfrom(2) returned unexpected status zero.");
477 else /* if (status > 0) */
479 assert (((size_t) status) < buffer_size);
480 buffer_size = (size_t) status;
481 buffer[buffer_size] = 0;
483 status = pinba_process_stats_packet (buffer, buffer_size);
485 DEBUG("pinba plugin: Parsing packet failed.");
493 } /* }}} void pinba_udp_read_callback_fn */
495 static int receive_loop (void) /* {{{ */
499 s = pinba_socket_open (conf_node, conf_service);
502 ERROR ("pinba plugin: Collector thread is exiting prematurely.");
506 while (!collector_thread_do_shutdown)
514 status = poll (s->fd, s->fd_num, /* timeout = */ 1000);
515 if (status == 0) /* timeout */
523 if ((errno == EINTR) || (errno == EAGAIN))
526 ERROR ("pinba plugin: poll(2) failed: %s",
527 sstrerror (errno, errbuf, sizeof (errbuf)));
528 pinba_socket_free (s);
532 for (i = 0; i < s->fd_num; i++)
534 if (s->fd[i].revents & (POLLERR | POLLHUP | POLLNVAL))
536 pb_del_socket (s, i);
539 else if (s->fd[i].revents & (POLLIN | POLLPRI))
541 pinba_udp_read_callback_fn (s->fd[i].fd);
544 } /* while (!collector_thread_do_shutdown) */
546 pinba_socket_free (s);
550 } /* }}} int receive_loop */
552 static void *collector_thread (void *arg) /* {{{ */
556 memset (&collector_thread_id, 0, sizeof (collector_thread_id));
557 collector_thread_running = 0;
560 } /* }}} void *collector_thread */
563 * Plugin declaration section
565 static int pinba_config_view (const oconfig_item_t *ci) /* {{{ */
574 status = cf_util_get_string (ci, &name);
578 for (i = 0; i < ci->children_num; i++)
580 oconfig_item_t *child = ci->children + i;
582 if (strcasecmp ("Host", child->key) == 0)
583 status = cf_util_get_string (child, &host);
584 else if (strcasecmp ("Server", child->key) == 0)
585 status = cf_util_get_string (child, &server);
586 else if (strcasecmp ("Script", child->key) == 0)
587 status = cf_util_get_string (child, &script);
590 WARNING ("pinba plugin: Unknown config option: %s", child->key);
599 service_statnode_add (name, host, server, script);
607 } /* }}} int pinba_config_view */
609 static int plugin_config (oconfig_item_t *ci) /* {{{ */
613 /* The lock should not be necessary in the config callback, but let's be
615 pthread_mutex_lock (&stat_nodes_lock);
617 for (i = 0; i < ci->children_num; i++)
619 oconfig_item_t *child = ci->children + i;
621 if (strcasecmp ("Address", child->key) == 0)
622 cf_util_get_string (child, &conf_node);
623 else if (strcasecmp ("Port", child->key) == 0)
624 cf_util_get_service (child, &conf_service);
625 else if (strcasecmp ("View", child->key) == 0)
626 pinba_config_view (child);
628 WARNING ("pinba plugin: Unknown config option: %s", child->key);
631 pthread_mutex_unlock(&stat_nodes_lock);
634 } /* }}} int pinba_config */
636 static int plugin_init (void) /* {{{ */
640 if (stat_nodes == NULL)
642 /* Collect the "total" data by default. */
643 service_statnode_add ("total",
646 /* script = */ NULL);
649 if (collector_thread_running)
652 status = plugin_thread_create (&collector_thread_id,
659 ERROR ("pinba plugin: pthread_create(3) failed: %s",
660 sstrerror (errno, errbuf, sizeof (errbuf)));
663 collector_thread_running = 1;
668 static int plugin_shutdown (void) /* {{{ */
670 if (collector_thread_running)
674 DEBUG ("pinba plugin: Shutting down collector thread.");
675 collector_thread_do_shutdown = 1;
677 status = pthread_join (collector_thread_id, /* retval = */ NULL);
681 ERROR ("pinba plugin: pthread_join(3) failed: %s",
682 sstrerror (status, errbuf, sizeof (errbuf)));
685 collector_thread_running = 0;
686 collector_thread_do_shutdown = 0;
687 } /* if (collector_thread_running) */
690 } /* }}} int plugin_shutdown */
692 static int plugin_submit (const pinba_statnode_t *res) /* {{{ */
695 value_list_t vl = VALUE_LIST_INIT;
699 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
700 sstrncpy (vl.plugin, "pinba", sizeof (vl.plugin));
701 sstrncpy (vl.plugin_instance, res->name, sizeof (vl.plugin_instance));
703 value.derive = res->req_count;
704 sstrncpy (vl.type, "total_requests", sizeof (vl.type));
705 plugin_dispatch_values (&vl);
707 value.derive = float_counter_get (&res->req_time, /* factor = */ 1000);
708 sstrncpy (vl.type, "total_time_in_ms", sizeof (vl.type));
709 plugin_dispatch_values (&vl);
711 value.derive = res->doc_size;
712 sstrncpy (vl.type, "total_bytes", sizeof (vl.type));
713 plugin_dispatch_values (&vl);
715 value.derive = float_counter_get (&res->ru_utime, /* factor = */ 100);
716 sstrncpy (vl.type, "cpu", sizeof (vl.type));
717 sstrncpy (vl.type_instance, "user", sizeof (vl.type_instance));
718 plugin_dispatch_values (&vl);
720 value.derive = float_counter_get (&res->ru_stime, /* factor = */ 100);
721 sstrncpy (vl.type, "cpu", sizeof (vl.type));
722 sstrncpy (vl.type_instance, "system", sizeof (vl.type_instance));
723 plugin_dispatch_values (&vl);
725 value.gauge = res->mem_peak;
726 sstrncpy (vl.type, "memory", sizeof (vl.type));
727 sstrncpy (vl.type_instance, "peak", sizeof (vl.type_instance));
728 plugin_dispatch_values (&vl);
731 } /* }}} int plugin_submit */
733 static int plugin_read (void) /* {{{ */
736 pinba_statnode_t data;
738 while ((i = service_statnode_collect (&data, i)) != 0)
740 plugin_submit (&data);
744 } /* }}} int plugin_read */
746 void module_register (void) /* {{{ */
748 plugin_register_complex_config ("pinba", plugin_config);
749 plugin_register_init ("pinba", plugin_init);
750 plugin_register_read ("pinba", plugin_read);
751 plugin_register_shutdown ("pinba", plugin_shutdown);
752 } /* }}} void module_register */
754 /* vim: set sw=2 sts=2 et fdm=marker : */