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

diff --git a/README b/README
index 4a125bd7aa71ac7d856900e2403d459ca3f86c97..3f65963ae353a7e4dc3294acb27801025f895f94 100644 (file)
--- a/README
+++ b/README
@@ -387,7 +387,9 @@ Features
       done.
 
     - write_graphite
       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
 
     - 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 3788455f34cf5cd400c61731c3debec43a5549d1..f4ac81a0f4d77577f4adc7a1ff12dfc4fa598ffd 100644 (file)
--- a/src/collectd.conf.in
+++ b/src/collectd.conf.in
@@ -1092,6 +1092,7 @@
 #    Host "localhost"
 #    Port "2003"
 #    Protocol "udp"
 #    Host "localhost"
 #    Port "2003"
 #    Protocol "udp"

+#    LogSendErrors true

 #    Prefix "collectd"
 #    Postfix "collectd"
 #    StoreRates true
 #    Prefix "collectd"
 #    Postfix "collectd"
 #    StoreRates true

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index bce17bd73a32c2e5ce33cc365743ed27248d880e..55b964330b41600337cd67e6ed8fa950096cbbbb 100644 (file)
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -5848,6 +5848,7 @@ Synopsis:
      Host "localhost"
      Port "2003"
      Protocol "udp"
      Host "localhost"
      Port "2003"
      Protocol "udp"

+     LogSendErrors true

      Prefix "collectd"
    </Node>
  </Plugin>
      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>.
 
 
 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
 =item B<Prefix> I<String>
 
 When set, I<String> is added in front of the host name. Dots and whitespace are