Herakles

Linux-Monitoring, das auch bei großer Last schnell bleibt

Hochperformanter Prometheus Exporter mit erweiterten System- und Prozessmetriken.

Standard-Port: 9215
🩀 Built with Rust → Schnellstart

Erweiterte System- und Prozessmetriken

Metriken

  • CPU-Auslastung
  • Arbeitsspeicher (RSS, PSS, USS)
  • Dateisystem
  • Netzwerk
  • Prozess-Einblicke
  • Gruppen- und Untergruppen-Klassifizierung
  • Top-N Prozessanalyse

eBPF (Optional)

  • IO-Tracking pro Prozess
  • TCP-Status-Tracking
  • Kernel-Sichtbarkeit
  • Erfordert: root oder CAP_BPF + CAP_PERFMON

Produktionsinstallation

Empfohlene Installation:

sudo herakles-node-exporter install

Erstellt: systemd-Dienst, korrekte Verzeichnisstruktur, Root-AusfĂŒhrungskontext

ÜberprĂŒfen:

systemctl status herakles-node-exporter curl http://localhost:9215/metrics

Warum Herakles? – Konzepte & Diagnose-Endpunkte

Traditionelle Exporter zwingen dich zu wĂ€hlen: Entweder Millionen roher Metriken (Prometheus leidet) — oder grobe Aggregate ohne echten Einblick. Herakles löst das mit intelligenter Klassifizierung: Groups (db, java, web
) + Subgroups (postgres, redis
) = sinnvolle Aggregate + Top-N-Analyse + Leak-Erkennung — bei minimaler KardinalitĂ€t.

Groups & Subgroups – Prozesse sinnvoll bĂŒndeln

Herakles klassifiziert Prozesse in konfigurierbare Gruppen und Untergruppen. So lassen sich z. B. alle Datenbankprozesse einer Gruppe zuordnen und deren CPU-, Speicher- und IO-Nutzung aggregiert ĂŒberwachen – ohne dass jeder einzelne Prozess-PID als Label in den Metriken erscheint. Das hĂ€lt die KardinalitĂ€t niedrig und Prometheus performant.

Geladene Gruppen und ihre Prozesszuordnungen sind jederzeit ĂŒber /subgroups und /details einsehbar – bewusst außerhalb von /metrics, um keine hochkardinalen Zeitreihen zu erzeugen.

Endpunkte – Fehler schnell finden, direkt per curl

Alle Diagnose-Endpunkte sind von der Kommandozeile abrufbar:

Endpunkt Zweck Format
GET /metrics Prometheus-Scrape-Endpunkt mit allen Metriken Text (Prometheus)
GET /health Status des Exporters – lĂ€uft er, ist er bereit? Zeigt interne ZĂ€hler und Scrape-Statistiken Text / JSON
GET /config Die laufende Konfiguration – welche Gruppen, Schwellwerte und Einstellungen sind aktiv geladen HTML
GET /subgroups Die geladenen Untergruppen – welche Prozesse sind welcher Gruppe zugeordnet HTML
GET /doc Schnelle Hilfe: Dokumentation aller Metriken und Konfigurationsoptionen als Klartext – direkt im Terminal lesbar Klartext
GET /details Laufzeitdetails: Prozesszuordnungen, interne ZĂ€hler, temporĂ€re ZustĂ€nde – bewusst nicht in /metrics, da zu hohe KardinalitĂ€t HTML

curl-Befehle fĂŒr die Diagnose

# Exporter-Status prĂŒfen curl http://localhost:9215/health # Laufende Konfiguration anzeigen curl http://localhost:9215/config # Geladene Untergruppen anzeigen curl http://localhost:9215/subgroups # Schnelle Hilfe – Metriken und Optionen curl http://localhost:9215/doc # Laufzeitdetails (Gruppen, Prozesszuordnungen) curl http://localhost:9215/details # Alle Prometheus-Metriken curl http://localhost:9215/metrics

/health, /config, /subgroups und /details sind HTML-Seiten, die auch direkt im Browser aufrufbar sind. /doc liefert Dokumentation als Klartext – ideal fĂŒr schnelle Terminal-Hilfe mit curl 
 | less. Diese duale Schnittstelle macht Herakles geeignet fĂŒr automatisiertes Monitoring, Debugging, KonfigurationsprĂŒfung und Produktionsaudits.

Prometheus-Integration

scrape_configs: - job_name: herakles static_configs: - targets: ["your-host:9215"]

Kommerzieller Support

Monitoring-Umgebungs-Audit (Festpreis)

UnabhĂ€ngige technische PrĂŒfung Ihres gesamten Monitoring-Stacks. Festpreis, keine versteckten Kosten, herstellerneutral.

Deployment & Performance-Optimierung

Installation, Skalierung, ProduktionshÀrtung, KardinalitÀtsoptimierung, Performance-Troubleshooting.

Individuelle eBPF-Entwicklung

Eigene Metriken, maßgeschneidertes Tracing, spezialisiertes IO- oder Netzwerk-Tracking, produktionssichere Implementierungen.

Monitoring-Architektur-Beratung

Monitoring-Neugestaltung, hochskalierbare Umgebungen, Multi-Datacenter-Setups, VictoriaMetrics-Integration, Alert-Strategie-Verfeinerung, Kosten-Leistungs-Balance.

→ Alle Support-Leistungen ansehen