Trench

Trench est un système de suivi d'événements que vous hébergez vous-même et gardez sous votre propre compte. Il stocke ce que les gens font dans votre application, comme créer un compte, terminer un achat ou ouvrir une fonction, puis vous laisse interroger ces données en temps réel avec SQL ou un point de terminaison REST. En dessous, Apache Kafka absorbe le flux entrant et ClickHouse répond vite aux requêtes.

L'équipe de Frigade l'a construit pour faire tourner son propre pipeline d'événements à grande échelle, puis l'a publié en open source. Cela compte si vous avez déjà regardé la facture d'un outil d'analytique hébergé en vous demandant pourquoi suivre vos propres utilisateurs coûte si cher. Trench vise les développeurs qui veulent un suivi à la Segment sans envoyer chaque événement sur les serveurs d'une autre entreprise.

Deux points définissent ce que vous obtenez. D'abord, Trench suit l'API Segment, donc les appels track, identify et group que vous avez déjà écrits fonctionnent souvent en changeant seulement le point de terminaison. Ensuite, il arrive sous la forme d'une seule image Docker avec Kafka et ClickHouse à l'intérieur, ce qui raccourcit l'installation mais veut aussi dire que vous exploitez une vraie base de données. Prévoyez au moins 4 Go de RAM et 4 cœurs de CPU pour un nœud de production.

Getting Started

1. Clonez le dépôt FrigadeHQ/trench et ouvrez le dossier apps/trench.
2. Copiez le fichier d'environnement d'exemple, puis lancez la pile avec Docker Compose, qui démarre Trench avec Kafka et ClickHouse en local.
3. Ouvrez le serveur sur le port 4000 et trouvez vos clés publique et privée dans le fichier d'environnement.
4. Envoyez un événement au point de terminaison events avec un userId, un type comme track et un objet properties.
5. Relisez les données via le point de terminaison events, ou exécutez des requêtes SQL via celui des queries.