ipng/nginx-ipng-stats-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

PRE-RELEASE v0.8.2

Browse Source
This commit is contained in:
Pim van Pelt
2026-04-19 22:34:30 +02:00
parent 7ed77f5b22
commit 4b1b412fb7
7 changed files with 475 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
docs/user-guide.md
View File

@@ -249,6 +249,14 @@ nginx_ipng_bytes_in_total{source_tag="mg1",vip="192.0.2.10",code="2xx"} 9876543
# Histogram series (request_duration, upstream_response, bytes_in, bytes_out)
# do NOT carry a `code` label — they aggregate across classes per (source, vip).
nginx_ipng_request_duration_seconds_bucket{source_tag="mg1",vip="192.0.2.10",le="0.050"} 11200
# In-flight gauges per (source, vip). These are point-in-time request counts,
# not rates: `active` = requests observed at POST_READ that haven't finalized
# yet; `reading` = in pre-response phases (rewrite/access/content); `writing`
# = past header send. reading + writing = active at any instant.
nginx_ipng_active{source_tag="mg1",vip="192.0.2.10"} 3
nginx_ipng_reading{source_tag="mg1",vip="192.0.2.10"} 1
nginx_ipng_writing{source_tag="mg1",vip="192.0.2.10"} 2
```
For JSON output instead, set the `Accept` header:
@@ -300,6 +308,11 @@ sum by (vip) (rate(nginx_ipng_requests_total[5m]))
# p95 request duration per (source_tag, vip):
histogram_quantile(0.95,
sum by (source_tag, vip, le) (rate(nginx_ipng_request_duration_seconds_bucket[5m])))
# In-flight concurrency per (source_tag, vip). Gauges are exported as-is;
# use max_over_time for load-shedding alerts or avg_over_time for capacity
# planning:
max_over_time(nginx_ipng_active[5m])
```
## 6. Set up a global logtail access log