Wie nutze ich das Betriebs-Journal?

Ab Tarif Pro

Kurzantwort

Das Journal liegt im Bereich Betrieb auf dem Reiter Journal und dokumentiert System- und Job-Ereignisse. Über „Journaleintrag hinzufügen” hältst du einen Vorgang fest: Quelle, Stufe, Ereignis und optional eine Nachricht. Typischerweise schreiben automatisierte Abläufe (cron, System) hierher. Du kannst Einträge aber auch manuell anlegen.

Voraussetzungen

Der Betrieb ist Teil des Moduls Operations und ab Tarif Pro verfügbar. Ohne diese Lizenz liefert der Server 403.

Betrieb → Journal öffnen. Wähle in der linken Navigation Betrieb und dann den Reiter Journal. Die Tabelle zeigt die Ereignisse mit Quelle, Stufe und Ereignis.

Screenshot ausstehend betrieb-journal-01 Bereich Betrieb mit aktivem Reiter Journal und einer Liste von Ereignissen

Der Reiter 'Journal' im Bereich Betrieb.
Eintrag anlegen. Klicke auf „Journaleintrag hinzufügen” und fülle den Dialog:
- Quelle (Pflicht): Herkunft, z. B. cron, system, backup.
- Stufe (Pflicht): Information, Warnung oder Fehler.
- Ereignis (Pflicht): kurzer Kennzeichner, z. B. backup.completed.
- Nachricht (optional): Freitext mit Details.
Screenshot ausstehend betrieb-journal-02 Dialog 'Journaleintrag hinzufügen' mit Quelle, Stufe, Ereignis und Nachricht

Ein Journaleintrag: Quelle, Stufe, Ereignis und optionale Nachricht.
Speichern. Der Eintrag erscheint sofort in der Journalliste.

Das Journal ist ein POST auf /api/v1/journal (Scope write). Pflicht sind source und event; level ist standardmäßig info.

curl -X POST https://demo.notory.io/api/v1/journal \
  -H "Authorization: Bearer inv_dein_token" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "cron",
    "level": "info",
    "event": "backup.completed",
    "message": "Nächtliche Sicherung erfolgreich (128 Assets)"
  }'

{
  "id": "e1a2…",
  "tenant_id": "3d9b0c12-…",
  "source": "cron",
  "level": "info",
  "event": "backup.completed",
  "message": "Nächtliche Sicherung erfolgreich (128 Assets)",
  "created_at": "2026-07-08T02:00:04Z",
  "updated_at": "2026-07-08T02:00:04Z"
}

Auflisten mit GET /api/v1/journal (neueste zuerst).

Mögliche Fehler: 401 (Token fehlt/ungültig), 403 (Modul Operations nicht im Tarif oder kein Schreibrecht), 422 (Validierung).

Was passiert dabei?

Mandantengebunden: Jeder Eintrag gehört deinem aktuellen Mandanten und ist für andere unsichtbar.
Aufbewahrung (Retention): Über Verwaltung → Konfiguration → Journal-Vorhaltezeit (Tage) legen Administratoren fest, nach wie vielen Tagen Journaleinträge automatisch gelöscht werden (0 = dauerhaft behalten).
Journal ≠ Audit-Log: Das Journal ist frei befüllbar (System-/Job-Ereignisse). Das Audit-Log dagegen protokolliert automatisch jede schreibende Benutzeraktion und ist nicht manuell beschreibbar.
Kein automatischer Versand: Ein Journaleintrag löst keine E-Mail aus. Für Zustellung an Empfänger nutzt du Benachrichtigungen.