Ziel: Nachvollziehbarkeit ohne Mehraufwand. Dieses Logging-Setup deckt Prüfungen und Audits ab und ist in 30 Minuten startklar.
Siehe Glossar: Logging/Protokollierung, KPI, Übersteuern.

1) Die 10 Pflichtfelder (minimal, aber auditfähig)

  1. log_id: eindeutige ID (z. B. LOG-2025-0001)
  2. timestamp: ISO-Zeit in UTC (2025-09-15T10:30:00Z)
  3. actor: wer hat gehandelt (User-ID/Rolle)
  4. system: Name, Modell/Version, Umgebung (prod/test)
  5. input_ref: Bezug auf den Vorgang (z. B. REQ-…)
  6. features: relevante Merkmale (Sprache, Dokumenttyp …)
  7. score: numerischer Output/Score
  8. decision: getroffene Entscheidung (z. B. manuelle_pruefung)
  9. override: Übersteuern, ja/nein plus Grund plus wer
  10. meta: optional, Dauer, Hinweise, Korrekturen

Praxis: Felder 1–9 reichen oft aus. meta hilft für Analysen (z. B. Leistung).

2) Minimal-JSON (Copy & Paste)

Kopieren Sie das Beispiel und passen Sie Werte an. Wichtig sind die Felder 1–9.

{ "log_id": "LOG-2025-0001", "timestamp": "2025-09-15T10:30:00Z", "actor": { "user_id": "u123", "role": "HR" }, "system": { "name": "RecruitAI", "model": "v1.4.2", "env": "prod" }, "input_ref": "REQ-2025-0001", "features": { "lang": "de", "doc_type": "CV" }, "score": 0.58, "decision": "manuelle_pruefung", "override": { "applied": true, "reason": "Grenzfall/Erfahrung", "by": "u123" }, "meta": { "latency_ms": 320, "notes": "Uneinheitliches PDF" } }

3) Typische Fehler (und wie Sie sie vermeiden)

  • Keine Version oder ID des Systems: Immer system.model und env mitschreiben.
  • Override ohne Grund: Kurzbegründung verpflichtend (ein Satz reicht).
  • Score ohne Entscheidung: Menschen treffen Entscheidungen, Score allein ist kein Ergebnis.
  • Freitext statt Referenz: Vorgänge mit input_ref referenzieren (besser durchsuchbar).
  • Kein Uhrzeit-Standard: ISO-8601 und UTC verwenden, lokale Zeit nur zusätzlich.

4) Mini-Checkliste (vor Go-Live)

  • [ ] Felder 1–9 sind implementiert
  • [ ] IDs: LOG-* und REQ-* sind eindeutig
  • [ ] Override-Pflichtbegründung aktiviert
  • [ ] Zeitstempel in UTC (ISO-Format)
  • [ ] Testfälle im Audit Proof Pack abgelegt

5) Nächste Schritte

Vorlage: Oversight-Regeln und Kurzprotokoll als Copy-Paste gibt es hier: Oversight & Schwellenwerte.