knyar/nginx-lua-prometheus

Health v2 · maintenance only

Flags: no_releases

Adoption not part of the score

1562 stars · 236 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Lua library for Nginx (via ngx_lua/OpenResty) that tracks metrics like counters, gauges, and histograms and exposes them on a /metrics endpoint for Prometheus scraping. It lets you instrument request counts, latencies, and connection states directly in nginx.conf.

Use cases

• expose nginx metrics to prometheus
• track http request latency by server name
• count requests by status code in nginx
• monitor nginx connections with prometheus
• instrument openresty applications with prometheus metrics
• scrape nginx metrics endpoint

When to choose

• you run nginx or OpenResty with ngx_lua and want native Prometheus metrics without an exporter sidecar
• you need low-overhead per-request instrumentation inside nginx itself
• you want counters, gauges, and histograms with custom labels exposed on a scrape endpoint

When to avoid

• your nginx build lacks the ngx_lua module and you cannot add it
• you need metrics from non-Lua parts of your stack or other services
• you use a metrics backend other than Prometheus without conversion support

Facets

library · maturity stable

monitoring logging monitoring web-development backend lua self-hosted prometheus metrics nginx-lua observability instrumentation devops nginx openresty linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="knyar/nginx-lua-prometheus")