From 7b550c11cb2aee6ec91bce50c32ebff41e25a737 Mon Sep 17 00:00:00 2001
From: Kostas Botsas <kostas@influxdb.com>
Date: Thu, 14 Jul 2016 18:06:00 +0300
Subject: [PATCH] Documentation for load balancing on graphite output servers
 (#1469)

* Added documentation for load balancing on graphite output servers

* clarifications

* updates1

* updates2

* updates3
---
 etc/telegraf.conf                    | 2 ++
 plugins/outputs/graphite/README.md   | 2 ++
 plugins/outputs/graphite/graphite.go | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/etc/telegraf.conf b/etc/telegraf.conf
index c9011536a1560..10e949302c32b 100644
--- a/etc/telegraf.conf
+++ b/etc/telegraf.conf
@@ -197,6 +197,8 @@
 # # Configuration for Graphite server to send metrics to
 # [[outputs.graphite]]
 #   ## TCP endpoint for your graphite instance.
+#   ## If multiple endpoints are configured, the output will be load balanced.
+#   ## Only one of the endpoints will be written to with each iteration.
 #   servers = ["localhost:2003"]
 #   ## Prefix metrics name
 #   prefix = ""
diff --git a/plugins/outputs/graphite/README.md b/plugins/outputs/graphite/README.md
index 2de699dea2948..3e2369e214be7 100644
--- a/plugins/outputs/graphite/README.md
+++ b/plugins/outputs/graphite/README.md
@@ -9,6 +9,8 @@ via raw TCP.
 # Configuration for Graphite server to send metrics to
 [[outputs.graphite]]
   ## TCP endpoint for your graphite instance.
+  ## If multiple endpoints are configured, the output will be load balanced.
+  ## Only one of the endpoints will be written to with each iteration.
   servers = ["localhost:2003"]
   ## Prefix metrics name
   prefix = ""
diff --git a/plugins/outputs/graphite/graphite.go b/plugins/outputs/graphite/graphite.go
index 30aee0eb618a2..4e127ed7c4935 100644
--- a/plugins/outputs/graphite/graphite.go
+++ b/plugins/outputs/graphite/graphite.go
@@ -25,6 +25,8 @@ type Graphite struct {
 
 var sampleConfig = `
   ## TCP endpoint for your graphite instance.
+  ## If multiple endpoints are configured, output will be load balanced.
+  ## Only one of the endpoints will be written to with each iteration.
   servers = ["localhost:2003"]
   ## Prefix metrics name
   prefix = ""