Este artículo está disponible en francés.
1. L'API REST #
Tout ce que fait l'interface.
Le parcours #
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/nullPOST /api/v1/auth/loginrenvoie un jeton à passer enAuthorization: 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/…/deploydes 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
.crblet 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 #
- 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 jetonGET /api/v1/m/default/system/outputs: lister les destinations du groupePOST /api/v1/version/commit: valider une versionPATCH /api/v1/products/stream/groups/default/deploy: déployer sur un groupesource = "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.
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
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 ...