From ce6320057752f7fe9c2c4c46fdddd4df077c1ea8 Mon Sep 17 00:00:00 2001
From: "J. Javier Maestro" <jjmaestro@ieee.org>
Date: Mon, 3 Jun 2013 19:31:48 +0200
Subject: [PATCH] write_graphite plugin: Adding LogSendErrors to docs, README,
 etc.

---
 README                | 4 +++-
 src/collectd.conf.in  | 1 +
 src/collectd.conf.pod | 8 ++++++++
 3 files changed, 12 insertions(+), 1 deletion(-)

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
-- 
2.30.2