Categorica usa Nginx como reverse proxy y para servir contenido web, y Prometheus y Grafana para recoger y mostrar estadísticas. La única opción habitual es NGINX Prometheus Exporter, que ejecuta su propio servidor web, normalmente como contenedor sidecar en Docker. A la empresa le parecía una complejidad innecesaria, y además deja la recogida de métricas fuera de la propia monitorización. De ahí salió este módulo, que ahora comparten.
Para usarlo hay que compilar el módulo contra las fuentes de Nginx. Si Nginx no se compila desde el código fuente, debe haberse construido con --with-compat y --with-http_stub_status_module. Hacen falta un compilador C99, y las bibliotecas y cabeceras de PCRE, OpenSSL y zlib. El Makefile detecta la versión instalada con nginx -v y descarga las fuentes correspondientes, o se puede indicar la ruta con NGINX_SRC. Después se carga con load_module y se declara un location con la directiva prometheus_metrics, por ejemplo en el puerto 9100 y la ruta /metrics.
Entre las métricas globales figuran nginx_up, peticiones totales, respuestas por clase de estado, peticiones por método, bytes de entrada y salida, versión de HTTP, un histograma de duración de las peticiones y contadores de conexiones. Además hay métricas básicas por cada directiva server o upstream, que aparecen tras la primera petición. El límite es de 512 directivas, se ignoran los prefijos de más de 255 caracteres y la memoria compartida por defecto es de 1 MB (configurable con prometheus_metrics_shm_size). Si se agota, la recogida se omite sin avisar.
Los autores advierten de que no es un sustituto directo de nginx-prometheus-exporter: recoge bastantes menos estadísticas, está ligado a la versión de Nginx con la que se compila (al actualizar Nginx hay que recompilar el módulo) y está mucho menos probado. Se publica con licencia MIT y acepta pull requests, siempre que una persona haya revisado antes el parche. No ofrece soporte.
Esta noticia la ha redactado una inteligencia artificial a partir de las fuentes citadas, con el criterio editorial de El Autómata (equilibrio, atribución y solo hechos publicados). Puede contener errores: consulta las fuentes originales. Modelo: claude-sonnet-5.5.