RousselTMLEARNING

Article · Cribl : de la découverte à l'expertise

Automatiser Cribl

1. L'API REST #

Tout ce que fait l'interface.

Le parcours #

Automatiser par l'API
CRIBL=http://localhost:19000
TOKEN=$(curl -s -X POST $CRIBL/api/v1/auth/login -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"'"$CRIBL_PASSWORD"'"}' | jq -r .token)
H=(-H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json')

curl -s "${H[@]}" $CRIBL/api/v1/m/default/system/outputs | jq -r '.items[].id'
curl -s "${H[@]}" $CRIBL/api/v1/m/default/routes | jq '.items[0].routes[] | {name, filter, output}'

COMMIT=$(curl -s "${H[@]}" -X POST $CRIBL/api/v1/version/commit \
  -d '{"message":"ci: nouvelle destination archive","group":"default"}' | jq -r '.items[0].commit')
curl -s "${H[@]}" -X PATCH $CRIBL/api/v1/products/stream/groups/default/deploy -d "{\"version\":\"$COMMIT\"}"
curl -s "${H[@]}" -X POST $CRIBL/api/v1/version/commit -d '{"message":"sync leader"}' >/dev/null
  • POST /api/v1/auth/login renvoie un jeton à passer en Authorization: Bearer.
  • Les ressources d'un groupe se trouvent sous /api/v1/m/<groupe>/ (system/inputs, system/outputs, pipelines, routes).
  • Commit du groupe, déploiement avec le hash obtenu, puis commit du Leader pour garder les deux synchronisés.
À savoir : Le chemin de déploiement /api/v1/master/groups/…/deploy des anciennes documentations est remplacé par /api/v1/products/stream/groups/…/deploy ; sur Cribl.Cloud, l'adresse est celle de l'espace de travail et l'authentification passe par un client API.

2. Les Packs #

Réutiliser et partager.

Principe #

  • Un Pack regroupe routes, pipelines, tables de correspondance et échantillons, avec sa propre table de routage interne.
  • On l'utilise comme un pipeline (dans une route ou QuickConnect), on l'exporte en fichier .crbl et on l'importe dans un autre groupe ou environnement.
  • Le Cribl Packs Dispensary propose des Packs prêts à l'emploi (Palo Alto, Windows, AWS, Cisco…) : point de départ utile, à relire et adapter.
Bonne Pratique : Un Pack par source ou par fournisseur, versionné : c'est la meilleure façon de livrer la même logique en recette puis en production.

3. Git, environnements et Terraform #

Configuration as code.

Les options #

Configuration as code
  • Git intégré : chaque commit du Leader est versionné ; poussez vers un dépôt distant et protégez la branche.
  • Environnements : groupes séparés (ou déploiements séparés) pour recette et production, avec promotion par Pack, API ou Terraform.
  • Terraform : fournisseur officiel criblio/criblio, encore en préversion, avec un exportateur pour migrer une configuration existante.
  • SDK : le SDK Python reste disponible ; les SDK TypeScript et Go de « Cribl as Code » sont abandonnés depuis la version 4.20.
terraform {
  required_providers {
    criblio = { source = "criblio/criblio", version = "~> 1.25" }
  }
}
# Ressources et authentification : voir la documentation du fournisseur (préversion)
Attention : Le fournisseur Terraform est en préversion : fixez sa version et testez chaque montée de version en recette.

Copilot #

Cribl Copilot aide à écrire des expressions, construire des pipelines et rédiger des recherches. Depuis la version 4.20, on peut le faire passer par son propre fournisseur d'IA ; un administrateur peut désactiver le widget de discussion indépendamment des autres fonctions IA. Relisez toujours ce qu'il propose avant de déployer.

Commandes à connaître #

Commandes à connaître
  • POST /api/v1/auth/login : obtenir un jeton
  • GET /api/v1/m/default/system/outputs : lister les destinations du groupe
  • POST /api/v1/version/commit : valider une version
  • PATCH /api/v1/products/stream/groups/default/deploy : déployer sur un groupe
  • source = "criblio/criblio" : fournisseur Terraform officiel

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.

📄 Automatiser Cribl : API REST, Packs, Git et Terraform →

Mon suivi

  • ⏱ Durée estimée : ≈ 7 min

Connectez-vous pour suivre votre progression et prendre des notes. Se connecter

💬 Questions sur cette leçon

Aucune question pour l'instant : soyez le premier à demander de l'aide ou à partager votre configuration.

Poser une question sur cette leçon →

Articles recommandés

Pipelines et fonctions : parser, enrichir, masquer

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

Synthetic Monitoring as Code : Industrialisez la gestion des scénarios synthétiques

Découvrez comment intégrer le Synthetic Monitoring dans vos pipelines CI/CD pour des tests de per...

Terraform en CI/CD : pipelines, revue du plan, OIDC et GitOps

Automatiser Terraform : pipeline plan sur demande de fusion et apply après approbation, publicati...

Automatiser Grafana : API HTTP, Terraform et cycle de vie des dashboards

Industrialiser Grafana : API HTTP (dossiers, dashboards, utilisateurs, sources), fournisseur Terr...

Bindplane en production : haute disponibilité, sécurité, Kubernetes et configuration as code

Exploiter Bindplane en production : serveurs actifs-actifs, PostgreSQL et bus d'événements, TLS p...

Bonnes pratiques Bindplane

Check-list pour exploiter Bindplane : organisation par labels et fleets, réduction mesurée, masqu...

Monitors, SLO, dashboards et Datadog as code

Créer des monitors efficaces (métriques, logs, APM, composites, anomalies), des SLO, des dashboar...

Infrastructure as Code sur Azure : Bicep, Terraform, Cost Management et Well-Architected

Décrire et déployer Azure en code avec Bicep (modules, paramètres, what-if, déploiements par pipe...

Bonnes pratiques Datadog : tags, coûts, alertes et gouvernance

Check-list pour exploiter Datadog efficacement : tagging unifié, maîtrise des coûts (hôtes, logs,...

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 !