Este artículo está disponible en francés.
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.
Mi seguimiento
Inicia sesión para seguir tu progreso y tomar notas. Iniciar sesión
💬 Preguntas sobre esta lección
Todavía no hay preguntas: sé el primero en pedir ayuda o compartir tu configuración.
Artículos recomendados
Sources, destinations et routes dans Cribl Stream
Recevoir et envoyer des données avec Cribl Stream : sources push, pull, collecteurs et internes, ...
Cribl Stream en production : architecture distribuée, files persistantes et supervision
Passer Cribl Stream en production : Leader, groupes de Workers et processus, commit et déploiemen...
Bonnes pratiques Cribl Stream et Edge
Les bonnes pratiques pour exploiter Cribl en production : conception des routes et pipelines, nom...
Cribl : le pipeline de données pour l'observabilité et la sécurité
Découvrir Cribl : pourquoi un pipeline de données de télémétrie, la suite Cribl (Stream, Edge, La...
Cribl Edge : collecter au plus près des sources
Déployer Cribl Edge sur Linux, Windows et Kubernetes : rôle de l'agent, flottes et sous-flottes, ...
Réduire, transformer et optimiser les volumes avec Cribl
Réduire le volume envoyé aux SIEM et outils d'observabilité sans perdre d'information utile : Dro...
Archiver, rejouer et rechercher : S3, Replay, Cribl Lake et Cribl Search
Garder toutes les données à bas coût et les retrouver à la demande : destination S3 partitionnée,...
Automatiser Cribl : API REST, Packs, Git et Terraform
Gérer Cribl comme du code : API REST (authentification, chemins par groupe, commit et déploiement...
Pipelines et fonctions : parser, enrichir, masquer
Construire des pipelines Cribl Stream : pré-traitement, traitement et post-traitement, catalogue ...