RousselTMLEARNING

Observabilité

Installer et administrer Cribl Stream

Installer Cribl Stream en Docker ou sur Linux, le lancer comme service, comprendre $CRIBL_HOME, default et local, les fichiers de configuration, les ports, la première connexion, l'authentification, le TLS et les mises à jour.

1. Choisir un mode #

Instance unique, distribué, cloud ou hybride.

Les modes #

Modes de déploiement

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 cribl

CRIBL_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 cribl
Attention : 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 #

$CRIBL_HOME
DossierContenu
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 #

  1. Ouvrez http://localhost:9000 et connectez-vous avec admin / admin : Cribl impose de changer le mot de passe.
  2. Acceptez la licence gratuite (ou chargez une licence) dans Settings › Licensing.
  3. Repérez les menus : Data (Sources, Destinations), Routing (Data Routes, QuickConnect), Processing (Pipelines, Packs, Knowledge), Monitoring.
  4. 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 #

PortUsage
9000interface et API REST
4200communication Leader ↔ Workers (mode distribué)
9514source syslog (TCP/UDP), valeur courante
8088source Splunk HEC
10080source HTTP de Cribl
4317 / 4318source 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ée
  • sudo /opt/cribl/bin/cribl boot-start enable -m systemd -u cribl : démarrage automatique
  • tail -f /opt/cribl/log/cribl.log : journal interne
  • docker 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.

Articles liés

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, Lake, Search, …

Sources, destinations et routes dans Cribl Stream

Recevoir et envoyer des données avec Cribl Stream : sources push, pull, collecteurs et internes, découpage en…

Pipelines et fonctions : parser, enrichir, masquer

Construire des pipelines Cribl Stream : pré-traitement, traitement et post-traitement, catalogue des fonction…

Pour aller plus loin

Soutenir

♥ SOUTENIR

Soutenez RousselTM Learning

Les formations, articles, TP et attestations restent gratuits et sans publicité intrusive. Une contribution libre, du montant de votre choix, finance l’hébergement, les environnements de TP et l’écriture de nouveaux contenus.

Contribuer avec PayPal Montant libre · carte bancaire ou compte PayPalEn savoir plus
QR code PayPal
Ou scannez ce QR code avec votre téléphone

Merci, chaque contribution compte !