puppet: added missing documentation & misc
Andrey Galkin committed
May 3, 2018 at 10:38 UTC
8527970b075ba78658aaffb7949fa3069454ebaa
4 files changed
+54
-2
conf.d/Makefile.am
+1
@@ -62,6 +62,7 @@ dist_pythonconfig_DATA = \
62
python.d/postfix.conf \
63
python.d/postgres.conf \
64
python.d/powerdns.conf \
65
+ python.d/puppet.conf \
66
python.d/rabbitmq.conf \
67
python.d/redis.conf \
68
python.d/retroshare.conf \
conf.d/python.d/puppet.conf
+3
-2
@@ -78,11 +78,12 @@
78
#
79
# Production configuration should look like below.
80
#
81
-# NOTE: Usually Puppet Server/DB startup time is VERY long. So, there should
81
+# NOTE: usually Puppet Server/DB startup time is VERY long. So, there should
82
# be quite reasonable retry count.
83
#
84
# NOTE: secure PuppetDB config may require client certificate.
85
-# Not applies by default though.
85
+# Not applies to default PuppetDB configuration though.
86
+#
87
# puppetdb:
88
# url: 'https://fqdn.example.com:8081'
89
# tls_cert_file: /path/to/client.crt
python.d/Makefile.am
+1
@@ -50,6 +50,7 @@ dist_python_DATA = \
50
postfix.chart.py \
51
postgres.chart.py \
52
powerdns.chart.py \
53
+ puppet.chart.py \
54
rabbitmq.chart.py \
55
redis.chart.py \
56
retroshare.chart.py \
python.d/README.md
+49
@@ -1847,6 +1847,55 @@ local:
1847
1848
---
1849
1850
+# puppet
1851
+
1852
+Monitor status of Puppet Server and Puppet DB.
1853
+
1854
+Following charts are drawn:
1855
+
1856
+1. **JVM Heap**
1857
+ * committed (allocated from OS)
1858
+ * used (actual use)
1859
+2. **JVM Non-Heap**
1860
+ * committed (allocated from OS)
1861
+ * used (actual use)
1862
+3. **CPU Usage**
1863
+ * execution
1864
+ * GC (taken by garbage collection)
1865
+4. **File Descriptors**
1866
+ * max
1867
+ * used
1868
+
1869
+
1870
+### configuration
1871
+
1872
+```yaml
1873
+puppetdb:
1874
+ url: 'https://fqdn.example.com:8081'
1875
+ tls_cert_file: /path/to/client.crt
1876
+ tls_key_file: /path/to/client.key
1877
+ autodetection_retry: 1
1878
+ retries: 3600
1879
+
1880
+puppetserver:
1881
+ url: 'https://fqdn.example.com:8140'
1882
+ autodetection_retry: 1
1883
+ retries: 3600
1884
+```
1885
+
1886
+When no configuration is given then `https://fqdn.example.com:8140` is
1887
+tried without any retries.
1888
+
1889
+### notes
1890
+
1891
+* Exact Fully Qualified Domain Name of the node should be used.
1892
+* Usually Puppet Server/DB startup time is VERY long. So, there should
1893
+ be quite reasonable retry count.
1894
+* Secure PuppetDB config may require client certificate. Not applies
1895
+ to default PuppetDB configuration though.
1896
+
1897
+---
1898
+
1899
# rabbitmq
1900
1901
Module monitor rabbitmq performance and health metrics.