From 3d392e7c2005ab64fc654ef8c4dfe3f9bcd651df Mon Sep 17 00:00:00 2001
From: Viacheslav <v.gletenko@vyos.io>
Date: Wed, 12 Jan 2022 14:29:41 +0200
Subject: Add service monitroting telegraf

---
 docs/configuration/service/index.rst      |  1 +
 docs/configuration/service/monitoring.rst | 45 +++++++++++++++++++++++++++++++
 2 files changed, 46 insertions(+)
 create mode 100644 docs/configuration/service/monitoring.rst

diff --git a/docs/configuration/service/index.rst b/docs/configuration/service/index.rst
index 96660e91..11a1a118 100644
--- a/docs/configuration/service/index.rst
+++ b/docs/configuration/service/index.rst
@@ -17,6 +17,7 @@ Service
    ipoe-server
    lldp
    mdns
+   monitoring
    pppoe-server
    router-advert
    salt-minion
diff --git a/docs/configuration/service/monitoring.rst b/docs/configuration/service/monitoring.rst
new file mode 100644
index 00000000..f3fb11ba
--- /dev/null
+++ b/docs/configuration/service/monitoring.rst
@@ -0,0 +1,45 @@
+Monitoring
+----------
+
+Monitoring functionality with ``telefgraf`` and ``InfluxDB 2`` is provided.
+
+Telegraf
+========
+Telegraf is the open source server agent to help you collect metrics, events
+and logs from your routers.
+
+.. cfgcmd:: set service monitoring telegraf authentication organization <organization>
+
+   Authentication organization name
+
+.. cfgcmd:: set service monitoring telegraf authentication token <token>
+
+   Authentication token
+
+.. cfgcmd:: set service monitoring telegraf bucket <bucket>
+
+   Remote ``InfluxDB`` bucket name
+
+.. cfgcmd:: set service monitoring port <port>
+
+   Remote port
+
+.. cfgcmd:: set service monitoring telegraf url <url>
+
+   Remote URL
+
+
+Example
+=======
+
+An example of a configuration that sends ``telegraf`` metrics to remote
+``InfluxDB 2``
+
+.. code-block:: none
+
+  set service monitoring telegraf authentication organization 'vyos'
+  set service monitoring telegraf authentication token 'ZAml9Uy5wrhA...=='
+  set service monitoring telegraf bucket 'bucket_vyos'
+  set service monitoring telegraf port '8086'
+  set service monitoring telegraf source 'all'
+  set service monitoring telegraf url 'http://r1.influxdb2.local'
-- 
cgit v1.2.3