Audit-Exportformat
Spalten des CSV-Exports und Felder des JSON-Exports des Audit-Logs, mit allen Ereignistypen und Ergebnissen.
Du kannst das Audit-Log deines Workspaces auf der Audit-Seite als CSV oder JSON exportieren: Audit, dann Als CSV exportieren oder Als JSON exportieren. Die Audit-Seite können nur Inhaber und Admins öffnen. Ein Export enthält genau die Einträge, die die Seite mit deinen Filtern zeigt (der Ereignisfilter steht neben Filter, darüber öffnen sich Team, Akteur, Run und Zeitraum; oder du fragst kanman, zum Beispiel “Zeig mir die Richtlinienentscheidungen im Audit-Log”, und die Seite öffnet sich gefiltert), ein Eintrag pro Zeile oder Objekt, neueste zuerst, höchstens 5.000 Einträge. Die Seite lädt jeweils 50 Einträge; solange ältere noch nicht geladen sind, steht das unter den Export-Schaltflächen, und Ältere Einträge laden holt sie dazu. Die Seite beschreibt Audit.
CSV
Die Kopfzeile lautet immer:
timestamp,actor,team,run,event,result,detail
| Spalte | Inhalt | Beispiel |
|---|---|---|
timestamp |
Zeitpunkt des Ereignisses, ISO 8601 mit Mikrosekunden und UTC-Versatz | 2026-10-01T09:00:00.000000+00:00 |
actor |
Anzeigename der Person, oder kanman, oder system |
Lena Weber |
team |
Team-Slug, leer bei Ereignissen auf Workspace-Ebene | sandbox-team |
run |
Run-Schlüssel, leer, wenn das Ereignis keinen Run hat | run-2m9q |
event |
Ereignistyp, siehe unten | policy_decision |
result |
Ergebnis, siehe unten | denied |
detail |
Worum es ging: die Story oder der Name, den der Eintrag betrifft, und bei einer Richtlinienentscheidung der geprüfte Pfad mit der Regel und der Richtlinie, die entschieden hat. Leer, wenn es nichts zu ergänzen gibt | infra/alarms.tf · rule infra/** · policy balanced |
Beispiel:
timestamp,actor,team,run,event,result,detail
2026-10-01T09:12:31.000000+00:00,Lena Weber,sandbox-team,run-2m9q,decision_resolved,rejected,SBX-214
2026-10-01T09:00:01.000000+00:00,kanman,sandbox-team,run-2m9q,decision_created,info,SBX-214
2026-10-01T09:00:00.000000+00:00,kanman,sandbox-team,run-2m9q,policy_decision,denied,infra/alarms.tf · rule infra/** · policy balanced
2026-10-01T08:58:30.000000+00:00,kanman,sandbox-team,run-2m9q,run_state_changed,info,
2026-10-01T08:41:07.000000+00:00,Lena Weber,sandbox-team,,story_written,info,SBX-214
Formatregeln:
- UTF-8, ein Eintrag pro Zeile, Zeilen enden mit einem Zeilenvorschub.
- Ein Feld mit Komma, Anführungszeichen oder Zeilenumbruch steht in Anführungszeichen; Anführungszeichen im Feld werden verdoppelt.
- Leere Felder bleiben leer (kein
null). - Ein Wert, der mit
=,+,-oder@beginnt, bekommt ein Apostroph (') vorangestellt, damit Tabellenprogramme ihn nie als Formel ausführen. - Die CSV enthält nur die sechs Spalten. Nutze den JSON-Export, wenn du Details brauchst, etwa den gesperrten Pfad oder alte und neue Richtlinienwerte.
JSON
Der JSON-Export ist ein Array von Objekten, eines pro Eintrag, in derselben Reihenfolge wie die Seite:
[
{
"timestamp": "2026-10-01T09:00:00.000000+00:00",
"actor": "kanman",
"actorType": "kanman",
"team": "sandbox-team",
"run": "run-2m9q",
"event": "policy_decision",
"result": "denied",
"entityType": "run",
"entityName": "SBX-14 Add health check alarm",
"details": {
"check": { "kind": "path", "subject": "infra/alarms.tf" },
"verdict": { "allowed": false, "reasonKey": "policy.path.denied" },
"policyVersion": 3
}
}
]
| Feld | Typ | Beschreibung |
|---|---|---|
timestamp |
String | ISO 8601 mit Mikrosekunden und UTC-Versatz. |
actor |
String | Anzeigename der Person; kanman oder system für diese Akteure. |
actorType |
String | human, kanman oder system. |
team |
String oder null | Team-Slug. |
run |
String oder null | Run-Schlüssel. |
event |
String | Ereignistyp. |
result |
String oder null | Ergebnis. |
entityType |
String | task (eine Story), run, decision, policy, convention oder team. |
entityName |
String oder null | Lesbarer Name zum Zeitpunkt des Ereignisses. |
details |
Objekt | Ereignisspezifische Details. Enthält nie geheime Werte oder Modell-Prompts. |
Ereignistypen
| Ereignis | Wird festgehalten, wenn | Typische Ergebnisse |
|---|---|---|
policy_decision |
kanman etwas gegen die Team-Richtlinie prüft (Pfad, Repo, Diff-Größe, Budget, Arbeitszeiten, Parallelität) | allowed, denied |
policy_changed |
Ein Admin die Team-Richtlinie ändert (alte und neue Werte in details) |
info |
decision_created |
Eine Entscheidung im Eingang landet | info |
decision_resolved |
Eine Person eine Entscheidung beantwortet (Option und Kanal in details) |
approved, rejected, info |
story_drafted |
Die Aufnahme aus einer Anforderung eine Story entwirft | info |
story_written |
Eine freigegebene Story in den Tracker geschrieben wird | info |
story_approved_open |
Inhaber oder Admins eine Story mit offenen Fragen freigeben; die Fragen stehen in details und bleiben als Notizen an der Story |
approved |
run_state_changed |
Ein Run Status oder Stufe wechselt | info, failed |
tracker_write |
kanman in den Tracker schreibt (Kommentar, Statuswechsel, Verknüpfung) | info |
budget_reserved |
Steht im Ereignisfilter, wird derzeit nicht festgehalten | keine |
budget_stop |
Ein Run gestoppt wird, weil sein Budget aufgebraucht ist | denied |
convention_changed |
Eine Konvention angeheftet, bearbeitet oder zurückgezogen wird | info |
merge |
Ein Pull Request gemergt wird | approved, info |
revert_opened |
kanman einen Revert-Pull-Request öffnet | info |
team_paused |
Ein Team pausiert wird | info |
team_resumed |
Ein Team fortgesetzt wird | info |
runs_stopped |
Ein Owner oder Admin alle Runs des Workspaces stoppt (angehaltene Runs und abgebrochene Runner-Schritte in details) |
allowed |
runs_resumed |
Ein Owner oder Admin die Runs fortsetzt (wieder startende Runs in details) |
allowed |
team_deleted |
Der Owner des Workspaces ein Team löscht (abgebrochene Runs und Entscheidungen in details) |
info |
workspace_deleted |
Der Owner den Workspace löscht | info |
team_purged |
Die Daten eines gelöschten Teams 30 Tage nach dem Löschen endgültig entfernt werden (Anzahl je Art in details) |
info |
audit_retention_applied |
Einträge, die älter als die Aufbewahrungsfrist waren, entfernt wurden (Anzahl und Stichtag in details) |
info |
runner_job |
Ein Self-hosted Runner einen Schritt für kanman erledigt (Schritt, Runner und Fehlercode in details; bei Modellschritten zusätzlich usage: Aufrufe, Eingabe-, Ausgabe- und Cache-Tokens, geschätzte Kosten in Cent und ob kanman sie erfasst, sowie modelSource: team_key, runner_assistant oder runner_coding) |
passed, failed |
Ergebnisse
| Ergebnis | Bedeutung |
|---|---|
allowed |
Eine Richtlinien- oder Budgetprüfung wurde bestanden. |
denied |
Eine Richtlinien- oder Budgetprüfung hat die Aktion blockiert. |
passed |
Eine Prüfung wurde bestanden. |
failed |
Eine Prüfung oder ein Run ist gescheitert. |
approved |
Eine Person hat zugestimmt. |
rejected |
Eine Person hat abgelehnt. |
info |
Für die Nachvollziehbarkeit festgehalten, ohne Urteil. |
Unveränderlichkeit und Aufbewahrung
- Das Audit-Log ist nur erweiterbar. Einträge lassen sich nicht bearbeiten, auch nicht von Admins.
- Einträge, die älter als dein Aufbewahrungszeitraum sind, werden automatisch gelöscht. Admins legen den Zeitraum unter Workspace-Einstellungen > Audit fest. Siehe Aufbewahrung und Löschung.
- kanman hält jeden Export fest: wer exportiert hat, wann, in welchem Format und für welchen Zeitraum.
Zuletzt aktualisiert: January 1, 0001
kanman öffnen