1. Organiser le parc #
Labels, fleets et gateways.
Edge et gateway #
| Rôle | Où | Ce qu'il fait |
|---|---|---|
| Edge | Sur chaque serveur ou nœud | Collecte locale, parsing, filtrage et masquage légers |
| Gateway | Quelques collecteurs dédiés | Agrégation, routage, échantillonnage de traces, jetons des destinations, sortie Internet unique |
- Les labels (
env,team,region) sont posés à l'installation (OPAMP_LABELS) ou dans l'interface. - Une edge fleet regroupe des collecteurs qui partagent une configuration : on gère un groupe, pas des machines.
- Une gateway est un groupe nommé de collecteurs passerelles, à placer derrière un équilibreur OTLP.
Bonne Pratique : Avec des gateways, les jetons d'API des backends ne sont présents que sur quelques machines, et les flux sortants vers Internet passent par un seul point.
2. Les rollouts #
Déployer sans tout casser.
Standard #
Un rollout standard (toutes éditions) déploie par lots croissants : 3 collecteurs, puis 15, 75, et 100 par lot ensuite, un lot toutes les quelques secondes. Si un collecteur signale une erreur avec la nouvelle version, le rollout se met en pause automatiquement.
bindplane rollout start web-logs --initial 2 --multiplier 3 --max 50 --max-errors 0
bindplane rollout status web-logsProgressif (Enterprise) #
Un rollout progressif se découpe en étapes définies par des labels (env=dev, puis env=preprod, puis env=prod). Chaque étape attend un clic sur Continue Rollout. Une dernière étape récupère toujours les collecteurs qui ne correspondent à aucune autre.
En cas d'erreur #
- Cliquez sur le texte d'erreur du rollout pour lister les collecteurs en échec, puis ouvrez un collecteur pour lire le message.
- Corrigez la configuration et lancez un nouveau rollout, ou revenez à une version précédente par Roll forward to this version.
Erreur Courante : Une erreur de configuration (port déjà utilisé, fichier introuvable, jeton invalide) n'apparaît souvent qu'au démarrage du collecteur : c'est précisément ce que le premier lot de 3 collecteurs doit révéler. Ne lancez pas un rollout avec --initial égal au parc entier.Droits #
| Rôle (RBAC) | Lancer un rollout | Modifier les versions | Consulter |
|---|---|---|---|
| Admin | Oui | Oui | Oui |
| User | Non | Oui | Oui |
| Viewer | Non | Non | Oui |
