2 * collectd - src/memcached.c, based on src/hddtemp.c
3 * Copyright (C) 2007 Antony Dovgal
4 * Copyright (C) 2005,2006 Vincent Stehlé
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms of the GNU General Public License as published by the
8 * Free Software Foundation; either version 2 of the License, or (at your
9 * option) any later version.
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 dot org>
22 * Vincent Stehlé <vincent.stehle at free.fr>
23 * Florian octo Forster <octo at verplant.org>
29 #include "configfile.h"
33 # include <sys/socket.h>
34 # include <netinet/in.h>
35 # include <netinet/tcp.h>
37 #define MEMCACHED_DEF_HOST "127.0.0.1"
38 #define MEMCACHED_DEF_PORT "11211"
40 #define MEMCACHED_RETRY_COUNT 100
42 static const char *config_keys[] =
47 static int config_keys_num = STATIC_ARRAY_SIZE (config_keys);
49 static char *memcached_host = NULL;
50 static char memcached_port[16];
52 static int memcached_query_daemon (char *buffer, int buffer_size) /* {{{ */
61 struct addrinfo ai_hints;
62 struct addrinfo *ai_list, *ai_ptr;
65 memset (&ai_hints, '\0', sizeof (ai_hints));
66 ai_hints.ai_flags = 0;
68 /* ai_hints.ai_flags |= AI_ADDRCONFIG; */
70 ai_hints.ai_family = AF_INET;
71 ai_hints.ai_socktype = SOCK_STREAM;
72 ai_hints.ai_protocol = 0;
74 host = memcached_host;
76 host = MEMCACHED_DEF_HOST;
79 port = memcached_port;
80 if (strlen (port) == 0) {
81 port = MEMCACHED_DEF_PORT;
84 if ((ai_return = getaddrinfo (host, port, NULL, &ai_list)) != 0) {
86 ERROR ("memcached: getaddrinfo (%s, %s): %s",
88 (ai_return == EAI_SYSTEM)
89 ? sstrerror (errno, errbuf, sizeof (errbuf))
90 : gai_strerror (ai_return));
95 for (ai_ptr = ai_list; ai_ptr != NULL; ai_ptr = ai_ptr->ai_next) {
96 /* create our socket descriptor */
97 if ((fd = socket (ai_ptr->ai_family, ai_ptr->ai_socktype, ai_ptr->ai_protocol)) < 0) {
99 ERROR ("memcached: socket: %s", sstrerror (errno, errbuf, sizeof (errbuf)));
103 /* connect to the memcached daemon */
104 if (connect (fd, (struct sockaddr *) ai_ptr->ai_addr, ai_ptr->ai_addrlen)) {
105 shutdown(fd, SHUT_RDWR);
111 /* A socket could be opened and connecting succeeded. We're
116 freeaddrinfo (ai_list);
119 ERROR ("memcached: Could not connect to daemon.");
123 if (send(fd, "stats\r\n", sizeof("stats\r\n") - 1, MSG_DONTWAIT) != (sizeof("stats\r\n") - 1)) {
124 ERROR ("memcached: Could not send command to the memcached daemon.");
133 memset (&p, 0, sizeof (p));
135 p.events = POLLIN | POLLERR | POLLHUP;
138 status = poll (&p, /* nfds = */ 1, /* timeout = */ interval_g);
143 ERROR ("memcached: poll(2) timed out after %i seconds.", interval_g);
148 ERROR ("memcached: poll(2) failed: %s",
149 sstrerror (errno, errbuf, sizeof (errbuf)));
151 shutdown (fd, SHUT_RDWR);
157 /* receive data from the memcached daemon */
158 memset (buffer, '\0', buffer_size);
161 while ((status = recv (fd, buffer + buffer_fill, buffer_size - buffer_fill, MSG_DONTWAIT)) != 0) {
162 if (i > MEMCACHED_RETRY_COUNT) {
163 ERROR("recv() timed out");
171 if (errno == EAGAIN) {
175 ERROR ("memcached: Error reading from socket: %s",
176 sstrerror (errno, errbuf, sizeof (errbuf)));
177 shutdown(fd, SHUT_RDWR);
181 buffer_fill += status;
183 if (buffer_fill > 3 && buffer[buffer_fill-5] == 'E' && buffer[buffer_fill-4] == 'N' && buffer[buffer_fill-3] == 'D') {
184 /* we got all the data */
189 if (buffer_fill >= buffer_size) {
190 buffer[buffer_size - 1] = '\0';
191 WARNING ("memcached: Message from memcached has been truncated.");
192 } else if (buffer_fill == 0) {
193 WARNING ("memcached: Peer has unexpectedly shut down the socket. "
194 "Buffer: `%s'", buffer);
195 shutdown(fd, SHUT_RDWR);
200 shutdown(fd, SHUT_RDWR);
206 static int memcached_config (const char *key, const char *value) /* {{{ */
208 if (strcasecmp (key, "Host") == 0) {
209 if (memcached_host != NULL) {
210 free (memcached_host);
212 memcached_host = strdup (value);
213 } else if (strcasecmp (key, "Port") == 0) {
214 int port = (int) (atof (value));
215 if ((port > 0) && (port <= 65535)) {
216 snprintf (memcached_port, sizeof (memcached_port), "%i", port);
218 strncpy (memcached_port, value, sizeof (memcached_port));
220 memcached_port[sizeof (memcached_port) - 1] = '\0';
229 static void submit_counter (const char *type, const char *type_inst,
230 counter_t value) /* {{{ */
233 value_list_t vl = VALUE_LIST_INIT;
235 values[0].counter = value;
239 vl.time = time (NULL);
240 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
241 sstrncpy (vl.plugin, "memcached", sizeof (vl.plugin));
242 if (type_inst != NULL)
244 strncpy (vl.type_instance, type_inst, sizeof (vl.type_instance));
245 vl.type_instance[sizeof (vl.type_instance) - 1] = '\0';
248 plugin_dispatch_values (type, &vl);
249 } /* void memcached_submit_cmd */
252 static void submit_counter2 (const char *type, const char *type_inst,
253 counter_t value0, counter_t value1) /* {{{ */
256 value_list_t vl = VALUE_LIST_INIT;
258 values[0].counter = value0;
259 values[1].counter = value1;
263 vl.time = time (NULL);
264 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
265 sstrncpy (vl.plugin, "memcached", sizeof (vl.plugin));
266 if (type_inst != NULL)
268 strncpy (vl.type_instance, type_inst, sizeof (vl.type_instance));
269 vl.type_instance[sizeof (vl.type_instance) - 1] = '\0';
272 plugin_dispatch_values (type, &vl);
273 } /* void memcached_submit_cmd */
276 static void submit_gauge (const char *type, const char *type_inst,
277 gauge_t value) /* {{{ */
280 value_list_t vl = VALUE_LIST_INIT;
282 values[0].gauge = value;
286 vl.time = time (NULL);
287 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
288 sstrncpy (vl.plugin, "memcached", sizeof (vl.plugin));
289 if (type_inst != NULL)
291 strncpy (vl.type_instance, type_inst, sizeof (vl.type_instance));
292 vl.type_instance[sizeof (vl.type_instance) - 1] = '\0';
295 plugin_dispatch_values (type, &vl);
299 static void submit_gauge2 (const char *type, const char *type_inst,
300 gauge_t value0, gauge_t value1) /* {{{ */
303 value_list_t vl = VALUE_LIST_INIT;
305 values[0].gauge = value0;
306 values[1].gauge = value1;
310 vl.time = time (NULL);
311 sstrncpy (vl.host, hostname_g, sizeof (vl.host));
312 sstrncpy (vl.plugin, "memcached", sizeof (vl.plugin));
313 if (type_inst != NULL)
315 strncpy (vl.type_instance, type_inst, sizeof (vl.type_instance));
316 vl.type_instance[sizeof (vl.type_instance) - 1] = '\0';
319 plugin_dispatch_values (type, &vl);
323 static int memcached_read (void) /* {{{ */
332 gauge_t bytes_used = NAN;
333 gauge_t bytes_total = NAN;
334 counter_t rusage_user = 0;
335 counter_t rusage_syst = 0;
336 counter_t octets_rx = 0;
337 counter_t octets_tx = 0;
339 /* get data from daemon */
340 if (memcached_query_daemon (buf, sizeof (buf)) < 0) {
344 #define FIELD_IS(cnst) \
345 (((sizeof(cnst) - 1) == name_len) && (strcmp (cnst, fields[1]) == 0))
349 while ((line = strtok_r (ptr, "\n\r", &saveptr)) != NULL)
355 fields_num = strsplit(line, fields, 3);
359 name_len = strlen(fields[1]);
364 * For an explanation on these fields please refer to
365 * <http://code.sixapart.com/svn/memcached/trunk/server/doc/protocol.txt>
369 * CPU time consumed by the memcached process
371 if (FIELD_IS ("rusage_user"))
373 rusage_user = atoll (fields[2]);
375 else if (FIELD_IS ("rusage_system"))
377 rusage_syst = atoll(fields[2]);
381 * Number of threads of this instance
383 else if (FIELD_IS ("threads"))
385 submit_gauge2 ("ps_count", NULL, NAN, atof (fields[2]));
389 * Number of items stored
391 else if (FIELD_IS ("curr_items"))
393 submit_gauge ("memcached_items", "current", atof (fields[2]));
396 else if (FIELD_IS ("total_items"))
398 total_items = atoll(fields[2]);
403 * Number of bytes used and available (total - used)
405 else if (FIELD_IS ("bytes"))
407 bytes_used = atof (fields[2]);
409 else if (FIELD_IS ("limit_maxbytes"))
411 bytes_total = atof(fields[2]);
417 else if (FIELD_IS ("curr_connections"))
419 submit_gauge ("memcached_connections", "current", atof (fields[2]));
422 else if (FIELD_IS("total_connections"))
424 total_connections = atoll(fields[2]);
429 * ``Number of connection structures allocated by the server''
430 else if (FIELD_IS ("connection_structures"))
432 connection_structures = atof(fields[2]);
439 else if ((name_len > 4) && (strncmp (fields[1], "cmd_", 4) == 0))
441 const char *name = fields[1] + 4;
442 submit_counter ("memcached_command", name, atoll (fields[2]));
446 * Operations on the cache, i. e. cache hits, cache misses and evictions of items
448 else if (FIELD_IS ("get_hits"))
450 submit_counter ("memcached_ops", "hits", atoll (fields[2]));
452 else if (FIELD_IS ("get_misses"))
454 submit_counter ("memcached_ops", "misses", atoll (fields[2]));
456 else if (FIELD_IS ("evictions"))
458 submit_counter ("memcached_ops", "evictions", atoll (fields[2]));
464 else if (FIELD_IS ("bytes_read"))
466 octets_rx = atoll (fields[2]);
468 else if (FIELD_IS ("bytes_written"))
470 octets_tx = atoll (fields[2]);
472 } /* while ((line = strtok_r (ptr, "\n\r", &saveptr)) != NULL) */
474 if (!isnan (bytes_used) && !isnan (bytes_total) && (bytes_used <= bytes_total))
475 submit_gauge2 ("df", "cache", bytes_used, bytes_total - bytes_used);
477 if ((rusage_user != 0) || (rusage_syst != 0))
478 submit_counter2 ("ps_cputime", NULL, rusage_user, rusage_syst);
480 if ((octets_rx != 0) || (octets_tx != 0))
481 submit_counter2 ("memcached_octets", NULL, octets_rx, octets_tx);
487 void module_register (void) /* {{{ */
489 plugin_register_config ("memcached", memcached_config, config_keys, config_keys_num);
490 plugin_register_read ("memcached", memcached_read);
499 * vim600: sw=4 ts=4 fdm=marker