improve prometheus exporter docs

docs/prometheus/_index.md

@@ -19,29 +19,15 @@ There are several prometheus integrations in SNClient+.
 
 ## Windows Exporter
 
-When SNClient+ on windows there is a builtin windows exporter which can be
-enabled by:
+When running SNClient+ on windows there is a builtin windows exporter.
 
-    [/modules]
-    WindowsExporterServer = enabled
-
-    [/settings/WindowsExporter/server]
-    ; adjust further settings here
-
-You can then scrape windows metrics from `http://<ip>:8443/node/metrics`.
+[Read more about the windows exporter](windows).
 
 ## Node Exporter
 
-When SNClient+ on linux there is a builtin node exporter which can be
-enabled by:
-
-    [/modules]
-    NodeExporterServer = enabled
-
-    [/settings/NodeExporter/server]
-    ; adjust further settings here
+When running SNClient+ on linux there is a builtin node exporter.
 
-You can then scrape windows metrics from `http://<ip>:8443/node/metrics`.
+[Read more about the windows exporter](linux).
 
 ## Managed Exporters
 

docs/prometheus/exporter.md

@@ -1,7 +1,7 @@
 ---
 title: ExporterExporter
 linkTitle: ExpExp
-weight: 400
+weight: 360
 tags:
   - prometheus
   - exporter

docs/prometheus/linux.md

@@ -0,0 +1,49 @@
+---
+title: Linux
+linkTitle: Linux
+weight: 340
+tags:
+  - prometheus
+  - linux
+  - node_exporter
+  - exporter
+---
+
+## Node Exporter
+
+When running SNClient+ on linux there is a builtin node exporter which can be
+enabled by:
+
+    [/modules]
+    NodeExporterServer = enabled
+
+    [/settings/NodeExporter/server]
+    ; use same port as the web server
+    port = ${/settings/WEB/server/port}
+
+    ; disable password protection
+    password =
+
+You can then scrape linux metrics from `http://<ip>:8443/node/metrics`.
+
+The node exporter will run as user `nobody` unless you set `agent user` otherwise.
+
+The prometheus scrape config might look like this:
+
+    - job_name: 'linux'
+        # Override the global default and scrape targets from this job every 5 seconds.
+        scrape_interval: 5s
+
+        # metrics_path defaults to '/metrics', but here we use the snclient-prefix
+        metrics_path: /node/metrics
+
+        # scheme defaults to 'http'.
+        scheme: https
+        tls_config:
+            insecure_skip_verify: true
+
+        static_configs:
+        - targets: ['<ip>:8443']
+
+SNClient will monitor the node exporter memory usage and restart the exporter if
+it exceeds the `agent max memory`. The default is 256MB.

docs/prometheus/managed.md

@@ -1,7 +1,7 @@
 ---
 title: ManagedExporter
 linkTitle: Managed
-weight: 400
+weight: 350
 tags:
   - prometheus
   - exporter

docs/prometheus/windows.md

@@ -0,0 +1,47 @@
+---
+title: Windows
+linkTitle: Windows
+weight: 330
+tags:
+  - prometheus
+  - windows
+  - exporter
+  - windows_exporter
+---
+
+## Windows Exporter
+
+When running SNClient+ on windows there is a builtin windows exporter which can be
+enabled by:
+
+    [/modules]
+    WindowsExporterServer = enabled
+
+    [/settings/WindowsExporter/server]
+    ; use same port as the web server
+    port = ${/settings/WEB/server/port}
+
+    ; disable password protection
+    password =
+
+You can then scrape windows metrics from `http://<ip>:8443/node/metrics`.
+
+The prometheus scrape config might look like this:
+
+    - job_name: 'windows'
+        # Override the global default and scrape targets from this job every 5 seconds.
+        scrape_interval: 5s
+
+        # metrics_path defaults to '/metrics', but here we use the snclient-prefix
+        metrics_path: /node/metrics
+
+        # scheme defaults to 'http'.
+        scheme: https
+        tls_config:
+            insecure_skip_verify: true
+
+        static_configs:
+        - targets: ['<ip>:8443']
+
+SNClient will monitor the windows exporter memory usage and restart the exporter if
+it exceeds the `agent max memory`. The default is 256MB.