Protokollierung konfigurieren

Überblick

TaprNext protokolliert Betriebsereignisse, Fehler und Debugging-Informationen. Diese Einstellungen steuern, was protokolliert wird und in welchem Format.

Konfiguration

Navigieren Sie zu Tapr Settings > Tab Other > Abschnitt Logging.

Log Level

Einstellung	Standard	Optionen
Log Level	INFO	DEBUG, INFO, WARNING, ERROR

Jede Stufe enthält alle Meldungen der schwerwiegenderen Stufen:

Stufe	Enthält	Anwendungsfall
ERROR	Nur Fehler	Produktion, minimale Protokollierung
WARNING	Fehler + Warnungen	Produktion, bei Problemen alarmieren
INFO	Fehler + Warnungen + Info	Normalbetrieb (Standard)
DEBUG	Alle Meldungen	Troubleshooting, Entwicklung

Was jede Stufe protokolliert:

ERROR: Fehlgeschlagene API-Aufrufe, Extraktionsfehler, Datenbankfehler, Integrationsfehler

WARNING: Annäherung an Rate-Limits, langsame Operationen, Nutzung veralteter Features, behebbaren Fehler

INFO: Rechnungsverarbeitungsereignisse, erfolgreiche API-Aufrufe, Workflow-Statusänderungen, Benutzeraktionen

DEBUG: Detaillierte Request-/Response-Daten, interne Statusänderungen, Performance-Metriken, schrittweise Verarbeitungsdetails

Log Format

Einstellung	Standard	Optionen
Log Format	text	text, json

Text Format: Menschenlesbares Format für manuelle Prüfung

• Geeignet für: manuelle Log-Prüfung, Entwicklung und Tests, einfaches Troubleshooting

JSON Format: Strukturiertes Format für Log-Aggregationstools

• Geeignet für: Log-Aggregation (ELK, Splunk, Datadog), automatisiertes Alerting, Analytics, Produktionsumgebungen

Logs aufrufen

Frappe Logs

TaprNext-Logs werden an die Standard-Log-Orte von Frappe geschrieben:

~/frappe-bench/logs/
frappe.log        # Allgemeine Frappe-Logs
worker.log        # Background-Job-Logs
scheduler.log     # Logs geplanter Tasks

TaprNext-Logs filtern

# TaprNext-spezifische Logs anzeigen
grep "taprnext" ~/frappe-bench/logs/frappe.log

# Aktuelle Fehler anzeigen
grep "ERROR.*taprnext" ~/frappe-bench/logs/frappe.log | tail -50

# Logs in Echtzeit verfolgen
tail -f ~/frappe-bench/logs/frappe.log | grep "taprnext"

Log-Rotation

Frappe rotiert Logs automatisch. Rotation in common_site_config.json konfigurieren:

{
  "logging": {
    "max_bytes": 10485760,
    "backup_count": 5
  }
}

Troubleshooting mit Logs

Debug vorübergehend aktivieren

Zum Troubleshooting spezifischer Probleme:

1. Log Level auf DEBUG setzen
2. Problem reproduzieren
3. Logs auf Detailinformationen prüfen
4. Log Level wieder auf INFO setzen

Performance-Hinweis: DEBUG-Logging erhöht das Log-Volumen erheblich. In der Produktion nicht dauerhaft aktiviert lassen.

Häufige Log-Muster

• KI-Extraktionsprobleme: grep "taprnext.ai" ~/frappe-bench/logs/frappe.log
• Eingangskanal-Probleme: grep "taprnext.intake" ~/frappe-bench/logs/frappe.log
• ERP-Integrationsfehler: grep "taprnext.adapters" ~/frappe-bench/logs/frappe.log
• Freigabe-Workflow: grep "taprnext.workflow" ~/frappe-bench/logs/frappe.log

Konfigurationsreferenz

Feld	Typ	Standard	Beschreibung
log_level	Select	INFO	Minimale zu protokollierende Severity
log_format	Select	text	Ausgabeformat (text oder JSON)

Best Practices

Produktionseinstellungen

Einstellung	Wert	Begründung
Log Level	INFO oder WARNING	Balance aus Sichtbarkeit und Volumen
Log Format	json	Ermöglicht Log-Aggregation und Alerting

Entwicklungseinstellungen

Einstellung	Wert	Begründung
Log Level	DEBUG	Maximale Sichtbarkeit für die Entwicklung
Log Format	text	In der Entwicklung leichter lesbar

Log-Monitoring

Alerts einrichten für:

• Logs auf ERROR-Stufe (sofortige Aufmerksamkeit)
• Hohe Häufigkeit von WARNING-Logs (potenzielle Probleme)
• Spezifische Muster (Integrationsfehler, Rate-Limits)

Log-Aufbewahrung

Compliance-Anforderungen berücksichtigen:

• Finanzvorschriften können Log-Aufbewahrung verlangen
• Logs in Backup-Prozeduren einbeziehen
• Log-Aufbewahrungsrichtlinie definieren