# Events und Kanäle

Event-Felder, Status und Organisation im Dashboard.

## Event-Aufbau

Ein Event benötigt `project`, `channel` und `event`. Weitere Felder ergänzen Kontext:

| Feld | Zweck |
| --- | --- |
| `description` | Lesbare Details zum Ereignis. |
| `tags` | Eigene JSON-Eigenschaften, etwa Version, Umgebung oder Bestellnummer. |
| `userId` | Verbindung zu einem Nutzerprofil im selben Projekt. |
| `badge` | Sichtbare Beschriftung mit einer festgelegten Farbe. |
| `logLevel` | Schweregrad für Darstellung und Benachrichtigungsstandard. |
| `logs` | Einträge zum Verlauf. |
| `actions` | Links, Buttons oder Formulare. |
| `steps` | Pipeline-Schritte und deren Abhängigkeiten. |

## Status und Schweregrad

`logLevel` erlaubt `info`, `warning`, `failed`, `critical`. Dieser Wert ist unabhängig vom Bearbeitungsstatus. Ein fehlgeschlagener Pipeline-Step erhöht den Schweregrad nicht automatisch.

Ein normales Event ohne ausführbare Actions wird als `completed` erstellt. Mit Button oder Formular beginnt es als `pending`. Der Server bestimmt den Erstellungsstatus auch dann, wenn du `status` mitsendest. Pipeline-Events erhalten einen abgeleiteten Status wie `waiting`, `running` oder `success`.

## Dashboard

Kanäle ordnen den Event-Verlauf. Nutze Suche und Filter für Status, Schweregrad und Badge. In den Event-Details findest du Tags, Logs, Nutzerbezug und Actions. Kanal-Lesezustände und Lesezeichen unterstützen die persönliche Übersicht; die Tabellenspalten lassen sich pro Kanal anpassen.

## Zeitstempel

`timestamp` ist beim Erstellen eine Zahl in Unix-Millisekunden, zum Beispiel `Date.now()` in JavaScript. Ohne Angabe verwendet Tracklytic den aktuellen Zeitpunkt. Zurückgegebene Zeitwerte sind Datumswerte im JSON-Format.

[Event erstellen](/api/create-event) · [Events lesen](/api/list-events)