1. Choisir un mode #
Instance unique, distribué, cloud ou hybride.
Les modes #
Pour apprendre et tester, une instance unique suffit : elle reçoit, traite et envoie les données. En production, on passe en distribué (un Leader et des Workers, voir le chapitre dédié), ou l'on utilise Cribl.Cloud, éventuellement avec des Workers hybrides installés près des sources.
2. Installer #
Docker ou Linux.
Docker #
docker run -d --name cribl --restart unless-stopped \
-p 9000:9000 -p 9514:9514 -p 9514:9514/udp -p 8088:8088 \
-e CRIBL_VOLUME_DIR=/opt/cribl/config-volume \
-v "$HOME/cribl-config:/opt/cribl/config-volume" \
cribl/cribl:latest
docker logs -f criblCRIBL_VOLUME_DIR place la configuration et l'état sur un volume persistant. Publiez les ports des sources que vous créerez (ici 9514 pour syslog et 8088 pour HEC). Fixez une version précise en production (cribl/cribl:4.20.0) plutôt que latest.
Linux #
sudo useradd -r -m -d /opt/cribl cribl
curl -Lso - https://cdn.cribl.io/dl/latest-x64 | sudo tar -xz -C /opt
sudo chown -R cribl:cribl /opt/cribl
sudo /opt/cribl/bin/cribl boot-start enable -m systemd -u cribl
sudo systemctl start cribl && systemctl status criblAttention : Vérifiez l'URL de téléchargement et la somme de contrôle sur la page de téléchargement officielle avant d'exécuter une installation en production.
3. Comprendre $CRIBL_HOME #
Où vivent configuration et état.
Arborescence #
| Dossier | Contenu |
|---|---|
bin/ | binaire cribl (start, stop, status, version, boot-start) |
default/ | configuration livrée par Cribl : ne pas modifier, remplacée à chaque mise à jour |
local/ | vos réglages, prioritaires sur default : inputs.yml, outputs.yml, routes.yml, pipelines/ |
state/ | état d'exécution : files persistantes, curseurs des collecteurs |
log/ | journaux internes (cribl.log) |
data/ | données de référence : tables de correspondance, échantillons |
Bonne Pratique : Sauvegardez local/ (ou mieux, utilisez le Git intégré) : c'est toute votre configuration. Ne modifiez les YAML à la main que Cribl arrêté, ou passez par l'interface et l'API.4. Premiers pas dans l'interface #
Connexion, réglages, sécurité.
Première connexion #
- Ouvrez
http://localhost:9000et connectez-vous avecadmin/admin: Cribl impose de changer le mot de passe. - Acceptez la licence gratuite (ou chargez une licence) dans Settings › Licensing.
- Repérez les menus : Data (Sources, Destinations), Routing (Data Routes, QuickConnect), Processing (Pipelines, Packs, Knowledge), Monitoring.
- Activez le TLS de l'interface (Settings › General › API Server) et créez des comptes nominatifs ; l'authentification LDAP, OIDC ou SAML et le RBAC fin dépendent de la licence.
Ports courants #
| Port | Usage |
|---|---|
| 9000 | interface et API REST |
| 4200 | communication Leader ↔ Workers (mode distribué) |
| 9514 | source syslog (TCP/UDP), valeur courante |
| 8088 | source Splunk HEC |
| 10080 | source HTTP de Cribl |
| 4317 / 4318 | source OpenTelemetry (gRPC / HTTP) |
À savoir : Les ports des sources se choisissent à la création de chaque source ; ceux-ci sont des valeurs habituelles, pas des obligations.
Mettre à jour #
- Lisez les notes de version (fonctions dépréciées, changements de comportement).
- En distribué : mettez d'abord à jour le Leader, puis les Workers par groupe ; le Leader peut piloter la mise à jour des Workers.
- En Docker : changez le tag de l'image et recréez le conteneur, le volume garde la configuration.
Commandes à connaître #
Commandes à connaître
/opt/cribl/bin/cribl start|stop|restart|status: piloter le service/opt/cribl/bin/cribl version: version installéesudo /opt/cribl/bin/cribl boot-start enable -m systemd -u cribl: démarrage automatiquetail -f /opt/cribl/log/cribl.log: journal internedocker run -d -p 9000:9000 -e CRIBL_VOLUME_DIR=/opt/cribl/config-volume cribl/cribl: Docker avec configuration persistante
Sources #
Vérifié en novembre 2026 (Cribl 4.20) : Cribl publie une version mineure environ tous les deux mois, consultez les notes de version avant de vous appuyer sur un détail.
