Nginx Exporter: Kennzahlen für Traffic und Errors sammeln

Die Überwachung von Nginx ist entscheidend, um Traffic-Spitzen, Fehler und Performance-Probleme frühzeitig zu erkennen. Der Nginx Exporter für Prometheus ermöglicht das Sammeln relevanter Kennzahlen wie HTTP-Statuscodes, aktive Verbindungen oder Anfragen pro Sekunde. In diesem Artikel erklären wir Schritt für Schritt, wie man den Nginx Exporter installiert, konfiguriert und in ein Monitoring-System integriert.

Nginx Exporter installieren

Der Nginx Exporter liest die Statusinformationen von Nginx aus und stellt diese als Metriken für Prometheus bereit. Es gibt offizielle Docker-Images, die den Einstieg erleichtern.

Voraussetzungen

• Nginx mit aktiviertem Status-Modul (stub_status)
• Prometheus-Server für die Metriksammlung
• Optional Docker für die schnelle Bereitstellung

Nginx Status-Modul aktivieren

Die stub_status-Seite liefert die Basiskennzahlen für den Exporter.

server {
    listen 80;
    server_name localhost;
location /nginx_status {
    stub_status;
    allow 127.0.0.1;
    deny all;
}

}


Nach Reload von Nginx ist die URL http://localhost/nginx_status erreichbar.
Nginx Exporter starten
Mit Docker lässt sich der Exporter schnell starten:
docker run -d 
  --name nginx_exporter 
  -p 9113:9113 
  nginx/nginx-prometheus-exporter:latest 
  -nginx.scrape-uri http://host.docker.internal/nginx_status

Alternativ kann der Exporter auch nativ installiert werden, z.B. über ein Release-Binary.
Prometheus Konfiguration
Prometheus benötigt die URL des Exporters als Target, damit die Metriken regelmäßig abgefragt werden.
prometheus.yml anpassen
scrape_configs:
  - job_name: 'nginx'
    static_configs:
      - targets: ['localhost:9113']

Damit fragt Prometheus alle Metriken des Exporters ab und speichert sie zur Visualisierung und Alerting.
Wichtige Metriken verstehen
Der Nginx Exporter liefert verschiedene Kennzahlen:
HTTP Status Codes

• nginx_http_requests_total{status="2xx"} – Anzahl erfolgreicher Requests
• nginx_http_requests_total{status="4xx"} – Anzahl Client-Fehler
• nginx_http_requests_total{status="5xx"} – Anzahl Server-Fehler

Connections

• nginx_connections_active – aktuell aktive Verbindungen
• nginx_connections_reading – Verbindungen, die Requests lesen
• nginx_connections_writing – Verbindungen, die Antworten schreiben
• nginx_connections_waiting – Keep-Alive-Verbindungen

Request Rate

Die Rate der eingehenden Requests lässt sich über Prometheus-Funktionen wie rate(nginx_http_requests_total[1m]) abbilden.

Grafana Dashboards erstellen

Grafana visualisiert die Metriken und ermöglicht Alerts.

Beispiel-Dashboards

• Requests pro Sekunde nach Statuscode
• Active Connections Übersicht
• Top 5 Endpoints nach Anzahl Requests
• Fehlerquoten 4xx/5xx visualisieren

Alerts konfigurieren

Alerts helfen, bei Ausfällen oder hoher Last proaktiv zu reagieren.

ALERT High5xxErrors
  IF increase(nginx_http_requests_total{status="5xx"}[5m]) > 10
  FOR 1m
  LABELS { severity="critical" }
  ANNOTATIONS { summary = "Hohe 5xx Fehlerrate bei Nginx" }

Best Practices

• Exporter nur lokal oder über gesichertes Netzwerk zugänglich machen
• Regelmäßige Updates von Exporter und Nginx
• Dashboards auf relevante Metriken reduzieren, um Übersicht zu behalten
• Alerting nur für kritische Schwellenwerte nutzen, um Alarm-Müdigkeit zu vermeiden
• Optional weitere Exporter einbinden (PHP-FPM, DB) für vollständiges Stack-Monitoring

Fazit zur Nginx-Überwachung

Mit dem Nginx Exporter lassen sich Traffic, Fehler und Performance sauber überwachen. In Kombination mit Prometheus und Grafana erhalten Administratoren vollständige Sichtbarkeit auf den Webserver, können Engpässe identifizieren und die Stabilität des Web Stacks erhöhen.

Konfiguriere Cisco Router & Switches und liefere ein Packet-Tracer-Lab/GNS3

Ich biete professionelle Unterstützung im Bereich Netzwerkkonfiguration und Network Automation für private Anforderungen, Studienprojekte, Lernlabore, kleine Unternehmen sowie technische Projekte. Ich unterstütze Sie bei der Konfiguration von Routern und Switches, der Erstellung praxisnaher Topologien in Cisco Packet Tracer, dem Aufbau und Troubleshooting von GNS3- und EVE-NG-Labs sowie bei der Automatisierung von Netzwerkaufgaben mit Netmiko, Paramiko, NAPALM und Ansible. Kontaktieren Sie mich jetzt – klicken Sie hier.

Meine Leistungen umfassen:

• Professionelle Konfiguration von Routern und Switches

• Einrichtung von VLANs, Trunks, Routing, DHCP, NAT, ACLs und weiteren Netzwerkfunktionen

• Erstellung von Topologien und Simulationen in Cisco Packet Tracer

• Aufbau, Analyse und Fehlerbehebung von Netzwerk-Labs in GNS3 und EVE-NG

• Automatisierung von Netzwerkkonfigurationen mit Python, Netmiko, Paramiko, NAPALM und Ansible

• Erstellung von Skripten für wiederkehrende Netzwerkaufgaben

• Dokumentation der Konfigurationen und Bereitstellung nachvollziehbarer Lösungswege

• Konfigurations-Backups, Optimierung bestehender Setups und technisches Troubleshooting

Benötigen Sie Unterstützung bei Ihrem Netzwerkprojekt, Ihrer Simulation oder Ihrer Network-Automation-Lösung? Kontaktieren Sie mich jetzt – klicken Sie hier.