Was macht log-essence?
Intelligente Protokollanalyse für LLMs – Muster extrahieren, Geheimnisse schwärzen, komprimieren, CLI, Web-UI und MCP-Server.
Funktionen
- Mustererkennung: Identifiziert wiederkehrende Fehler, Ausnahmen und häufige Ereignisse in Logdateien.
- Geheimnisschwärzung: Erkennt und entfernt automatisch sensible Daten (API-Keys, Token, Passwörter).
- Komprimierung: Reduziert die Log-Größe durch Zusammenfassen redundanter Einträge.
- CLI: Einfache Nutzung über die Kommandozeile für schnelle Analysen.
- Web-UI: Interaktive Oberfläche zum Hochladen und Analysieren von Logs im Browser.
- MCP-Server: Integration in KI-Assistenten via Model Context Protocol für automatisierte Workflows.
Installation
npm install -g log-essence
Oder:
yarn global add log-essence
Verwendung
CLI
log-essence analyze pfad/zur/logdatei.log
log-essence watch pfad/zum/logverzeichnis
log-essence redact pfad/zur/logdatei.log --output sicher.log
Web-UI
log-essence server
Öffne dann http://localhost:3000 im Browser.
MCP-Server
log-essence mcp
Konfiguriere den MCP-Server in deinem AI-Client (z. B. Cursor, Claude Code) über die Standard-MCP-Port-Einstellungen.
Konfiguration
Erstelle eine log-essence.config.json im Projektstammverzeichnis:
{
"patterns": [".+"],
"redact": ["(?:api[_-]?key|token|password)=[^\s]+"],
"compress": true,
"output": "json"
}
Beispiele
Log analysieren
log-essence analyze server.log
Ausgabe:
{
"patterns": [
{"muster": "ERROR: Connection refused", "anzahl": 42},
{"muster": "WARN: Timeout", "anzahl": 13}
],
"secrets_redacted": 2,
"compressed_entries": 155
}
Unterstützte Plattformen
- Node.js (v18 oder höher)
- CLI-Terminals (macOS, Linux, Windows)
- Web-Browser (Chrome, Firefox, Edge, Safari)
- KI-Assistenten mit MCP-Unterstützung (Claude Code, Cursor, Codex)
Lizenz
MIT