From: J. Javier Maestro <jjmaestro@ieee.org>
Date: Mon, 3 Jun 2013 17:31:48 +0000 (+0200)
Subject: write_graphite plugin: Adding LogSendErrors to docs, README, etc.
X-Git-Tag: collectd-5.4.0~27^2~3
X-Git-Url: https://git.tokkee.org/?p=collectd.git;a=commitdiff_plain;h=ce6320057752f7fe9c2c4c46fdddd4df077c1ea8

write_graphite plugin: Adding LogSendErrors to docs, README, etc.
---

diff --git a/README b/README
index 4a125bd7..3f65963a 100644
--- 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
diff --git a/src/collectd.conf.in b/src/collectd.conf.in
index 3788455f..f4ac81a0 100644
--- a/src/collectd.conf.in
+++ b/src/collectd.conf.in
@@ -1092,6 +1092,7 @@
 #    Host "localhost"
 #    Port "2003"
 #    Protocol "udp"
+#    LogSendErrors true
 #    Prefix "collectd"
 #    Postfix "collectd"
 #    StoreRates true
diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index bce17bd7..55b96433 100644
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -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