python readme update: nginx_log removed, postgres added
Ilya committed
Mar 16, 2017 at 10:19 UTC
63db946b4d02307ba9246d79cab38ef28d888426
1 file changed
+69
-33
python.d/README.md
+69
-33
@@ -307,12 +307,6 @@ If no configuration is given, module will attempt to connect to dovecot using un
307
308
Module monitor elasticsearch performance and health metrics
309
310
-**Requirements:**
311
- * python `requests` package.
312
-
313
-You need to install it manually. (python-requests or python3-requests depending on the version of python).
314
-
315
-
310
It produces:
311
312
1. **Search performance** charts:
@@ -990,33 +984,6 @@ Without configuration, module attempts to connect to `http://localhost/stub_stat
984
985
---
986
993
-# nginx_log
994
-
995
-Module monitors nginx access log and produces only one chart:
996
-
997
-1. **nginx status codes** in requests/s
998
- * 2xx
999
- * 3xx
1000
- * 4xx
1001
- * 5xx
1002
-
1003
-### configuration
1004
-
1005
-Sample for two vhosts:
1006
-
1007
-```yaml
1008
-site_A:
1009
- path: '/var/log/nginx/access-A.log'
1010
-
1011
-site_B:
1012
- name: 'local'
1013
- path: '/var/log/nginx/access-B.log'
1014
-```
1015
-
1016
-When no configuration file is found, module tries to parse `/var/log/nginx/access.log` file.
1017
-
1018
----
1019
-
987
# nsd
988
989
Module uses the `nsd-control stats_noreset` command to provide `nsd` statistics.
@@ -1162,6 +1129,75 @@ Configuration is not needed.
1129
1130
---
1131
1132
+# postgres
1133
+
1134
+Module monitors one or more postgres servers.
1135
+
1136
+**Requirements:**
1137
+
1138
+ * `python-psycopg2` package. You have to install to manually.
1139
+
1140
+Following charts are drawn:
1141
+
1142
+1. **Database size** MB
1143
+ * size
1144
+
1145
+2. **Current Backend Processes** processes
1146
+ * active
1147
+
1148
+3. **Write-Ahead Logging Statistics** files/s
1149
+ * total
1150
+ * ready
1151
+ * done
1152
+
1153
+4. **Checkpoints** writes/s
1154
+ * scheduled
1155
+ * requested
1156
+
1157
+5. **Current connections to db** count
1158
+ * connections
1159
+
1160
+6. **Tuples returned from db** tuples/s
1161
+ * sequential
1162
+ * bitmap
1163
+
1164
+7. **Tuple reads from db** reads/s
1165
+ * disk
1166
+ * cache
1167
+
1168
+8. **Transactions on db** transactions/s
1169
+ * commited
1170
+ * rolled back
1171
+
1172
+9. **Tuples written to db** writes/s
1173
+ * inserted
1174
+ * updated
1175
+ * deleted
1176
+ * conflicts
1177
+
1178
+10. **Locks on db** count per type
1179
+ * locks
1180
+
1181
+### configuration
1182
+
1183
+```yaml
1184
+socket:
1185
+ name : 'socket'
1186
+ user : 'postgres'
1187
+ database : 'postgres'
1188
+
1189
+tcp:
1190
+ name : 'tcp'
1191
+ user : 'postgres'
1192
+ database : 'postgres'
1193
+ host : 'localhost'
1194
+ port : 5432
1195
+```
1196
+
1197
+When no configuration file is found, module tries to connect to TCP/IP socket: `localhost:5432`.
1198
+
1199
+---
1200
+
1201
# redis
1202
1203
Get INFO data from redis instance.