RousselTMLEARNING

Artículo · Cribl: del descubrimiento a la maestría

Automatizar Cribl

Este artículo está disponible en francés.

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 →

Mi seguimiento

  • ⏱ Duración estimada : ≈ 7 min

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.

Hacer una pregunta sobre esta lección →

Artículos recomendados

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...

Sources, destinations et routes dans Cribl Stream

Recevoir et envoyer des données avec Cribl Stream : sources push, pull, collecteurs et internes, ...

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

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...

Installer et administrer Cribl Stream

Installer Cribl Stream en Docker ou sur Linux, le lancer comme service, comprendre $CRIBL_HOME, d...

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

Pipelines et fonctions : parser, enrichir, masquer

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

Apoyar

♥ APOYAR

Apoya RousselTM Learning

Los cursos, artículos, prácticas y certificados siguen siendo gratuitos y sin publicidad intrusiva. Una contribución libre, por el importe que elijas, financia el alojamiento, los entornos de prácticas y nuevos contenidos.

Contribuir con PayPal Importe libre · tarjeta o cuenta PayPalMás información
QR code PayPal
O escanea este código QR con tu teléfono

¡Gracias, cada contribución cuenta!