# Tracklytic

Events, Nutzerprofile, Insights und Pipelines im Überblick.

Tracklytic erfasst Ereignisse aus Anwendungen und Diensten. Events werden in Projekten und Kanälen gespeichert und im Dashboard angezeigt.

## Begriffe

| Begriff | Verwendung |
| --- | --- |
| Projekt | Trennt Anwendungen, Teams oder Umgebungen. API-Tokens sind an ein Projekt gebunden. |
| Kanal | Gruppiert Events innerhalb eines Projekts, etwa `deployments`, `payments` oder `errors`. |
| Event | Ein Ereignis mit Name, Beschreibung, Tags, Schweregrad und optionalen Aktionen. |
| Nutzerprofil | Eigenschaften eines Nutzers, identifiziert durch `userId` im Projekt. |
| Insight | Eine benannte Kennzahl oder ein Textwert, der aktualisiert werden kann. |
| Pipeline | Steps eines Events mit Abhängigkeiten und gemeinsamem Status. |

## Integration

1. Projekt im Dashboard anlegen und Projekt-Slug notieren.
2. API-Token für dieses Projekt erstellen.
3. Event von deinem Server an `POST /v1/event` senden.
4. Das Event im Kanal öffnen und bei Bedarf Profil oder Insight ergänzen.

[Quickstart](/docs/getting-started/quickstart) · [API-Referenz](/api/introduction) · [Event-Generator](/docs/guides/event-builder)

## Referenzen in Requests

`project` und `channel` verwenden Slugs, keine Datenbank-IDs. Zulässig sind Kleinbuchstaben und Zahlen, getrennt durch `-` oder `_`, maximal 100 Zeichen. Beispiele: `my-project`, `production_api`. Ein Kanal wird beim ersten Event automatisch angelegt, wenn er noch nicht existiert. Ein bestehender inaktiver Kanal nimmt keine neuen Events an.

Einzelne Events werden über ihre vom Server erzeugte `eventId` adressiert. Step-IDs legst du innerhalb der Pipeline selbst fest.