RousselTMLEARNING

Observabilité

Automatiser Cribl : API REST, Packs, Git et Terraform

Gérer Cribl comme du code : API REST (authentification, chemins par groupe, commit et déploiement), Packs réutilisables, Git et environnements, fournisseur Terraform criblio/criblio, SDK Python et assistant Copilot.

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.

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

Installer et administrer Cribl Stream

Installer Cribl Stream en Docker ou sur Linux, le lancer comme service, comprendre $CRIBL_HOME, default et lo…

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…

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 !