write_graphite plugin: Adding LogSendErrors to docs, README, etc.
authorJ. Javier Maestro <jjmaestro@ieee.org>
Mon, 3 Jun 2013 17:31:48 +0000 (19:31 +0200)
committerJ. Javier Maestro <jjmaestro@ieee.org>
Mon, 3 Jun 2013 17:31:48 +0000 (19:31 +0200)
README
src/collectd.conf.in
src/collectd.conf.pod

diff --git a/README b/README
index 4a125bd..3f65963 100644 (file)
--- a/README
+++ b/README
@@ -387,7 +387,9 @@ Features
       done.
 
     - write_graphite
-      Sends data to Carbon, the storage layer of Graphite using TCP or UDP.
+      Sends data to Carbon, the storage layer of Graphite using TCP or UDP. It
+      can be configured to avoid logging send errors (especially useful when
+      using UDP).
 
     - write_http
       Sends the values collected by collectd to a web-server using HTTP POST
index 3788455..f4ac81a 100644 (file)
 #    Host "localhost"
 #    Port "2003"
 #    Protocol "udp"
+#    LogSendErrors true
 #    Prefix "collectd"
 #    Postfix "collectd"
 #    StoreRates true
index bce17bd..55b9643 100644 (file)
@@ -5848,6 +5848,7 @@ Synopsis:
      Host "localhost"
      Port "2003"
      Protocol "udp"
+     LogSendErrors true
      Prefix "collectd"
    </Node>
  </Plugin>
@@ -5869,6 +5870,13 @@ Service name or port number to connect to. Defaults to C<2003>.
 
 Protocol to use when connecting to I<Graphite>. Defaults to C<tcp>.
 
+=item B<LogSendErrors> B<false>|B<true>
+
+If set to B<true> (the default), logs errors when sending data to I<Graphite>.
+If set to B<false>, it will not log the errors. This is especially useful when
+using Protocol UDP since many times we want to use the "fire-and-forget"
+approach and logging errors fills syslog with unneeded messages.
+
 =item B<Prefix> I<String>
 
 When set, I<String> is added in front of the host name. Dots and whitespace are