python readme update: web_log
Ilya committed
Mar 16, 2017 at 13:25 UTC
304cc52c82a5c70affdb086d5e61d9749ab0f64d
1 file changed
+65
python.d/README.md
+65
@@ -1430,3 +1430,68 @@ It produces:
1430
No configuration is needed.
1431
1432
---
1433
+
1434
+# web_log
1435
+
1436
+Tails the apache/nginx/lighttpd/gunicorn log files to collect real-time web-server statistics.
1437
+
1438
+It produces following charts:
1439
+
1440
+1. **Response by type** requests/s
1441
+ * success (1xx, 2xx, 304)
1442
+ * error (5xx)
1443
+ * redirect (3xx except 304)
1444
+ * bad (4xx)
1445
+ * other (all other responses)
1446
+
1447
+2. **Response by code family** requests/s
1448
+ * 1xx (informational)
1449
+ * 2xx (successful)
1450
+ * 3xx (redirect)
1451
+ * 4xx (bad)
1452
+ * 5xx (internal server errors)
1453
+ * other (non-standart responses)
1454
+ * unmatched (the lines in the log file that are not matched)
1455
+
1456
+3. **Detailed Response Codes** requests/s (number of responses for each response code family individually)
1457
+
1458
+4. **Bandwidth** KB/s
1459
+ * received (bandwidth of requests)
1460
+ * send (bandwidth of responses)
1461
+
1462
+5. **Timings** ms (request processing time)
1463
+ * min (bandwidth of requests)
1464
+ * max (bandwidth of responses)
1465
+ * average (bandwidth of responses)
1466
+
1467
+6. **Request per url** requests/s (configured by user)
1468
+
1469
+7. **Http Methods** requests/s (requests per http method)
1470
+
1471
+8. **Http Versions** requests/s (requests per http version)
1472
+
1473
+9. **IP protocols** requests/s (requests per ip protocol version)
1474
+
1475
+10. **Curent Poll Unique Client IPs** unique ips/s (unique client IPs per data collection iteration)
1476
+
1477
+11. **All Time Unique Client IPs** unique ips/s (unique client IPs since the last restart of netdata)
1478
+
1479
+
1480
+### configuration
1481
+
1482
+```yaml
1483
+nginx_log:
1484
+ name : 'nginx_log'
1485
+ path : '/var/log/nginx/access.log'
1486
+
1487
+apache_log:
1488
+ name : 'apache_log'
1489
+ path : '/var/log/apache/other_vhosts_access.log'
1490
+ categories:
1491
+ cacti : 'cacti.*'
1492
+ observium : 'observium'
1493
+```
1494
+
1495
+Module has preconfigured jobs for nginx, apache and gunicorn on various distros.
1496
+
1497
+---