amtool-caascad - HedgeDoc

# amtool-caascad #### Démo Point de Synchro du 13/05/2022 --- # Objectif - présenter amtool et son nouveau wrapper amtool-caascad --- # Amtool - C'est un outil CLI pour gérer les alertes et silences d'Alertmanager - Il permet entre autres : - de lister les alertes - de lister les silences - de poser des silences --- # Amtool-caascad - C'est un wrapper pour amtool parce que : - l'url de `amtool --alertmanager.url=<URL Rancher>` est trop lourde à écrire - il faut récupérer un token - il faut mettre ce token dans un fichier - il faut indiquer ce fichier à amtool - Ce wrapper simplifie l'URL de Rancher en `<cc_client>/<cc_prom>` et cache complètement l'aspect token/vault/fichier intermédiaire. --- # Documentation - Documentation d'amtool : [/Opérations/Applications/Alertmanager/amtool/](https://docs-internal.corp.caascad.com/Op%C3%A9rations/Applications/Alertmanager/amtool/) - Architecture du Monitoring : [/Architecture/Monitoring/metrics](https://docs-internal.corp.caascad.com/Architecture/Monitoring/metrics/) - Nomenclature des labels : [/Architecture/Nomenclature/Monitoring-Logging/monitoring_labels](https://docs-internal.corp.caascad.com/Architecture/Nomenclature/Monitoring-Logging/monitoring_labels/) --- # Installation ``` toolbox update toolbox install amtool amtool-caascad ``` --- # Exemples (silences et alertes) ``` amtool-caascad --help ``` ``` amtool-caascad --alertmanager.url ocb-test06/caascad alert query ``` ``` amtool-caascad --alertmanager.url ocb-test06/caascad silence --help ``` ``` amtool-caascad --alertmanager.url ocb-test06/caascad silence query ``` ``` amtool-caascad --alertmanager.url ocb-test06/caascad silence add \ job=test bidule=chouette \ --author YME --duration 5m --comment test ``` --- # Exemples (variations sur alertmanager.url) ``` amtool-caascad --alertmanager.url ocb-test06/caascad alert query ``` ``` amtool-caascad --alertmanager.url ocb-test06/cloud-caascad alert query ``` ``` amtool-caascad --alertmanager.url infra-stg/infra-caascad alert query ``` ``` amtool-caascad --alertmanager.url infra-stg/consumption alert query ``` ``` amtool-caascad --alertmanager.url ocb-test06/client alert query ``` ``` amtool-caascad --alertmanager.url ocb-test06/cloud-client alert query ``` :warning: ATTENTION :warning: Ne pas utiliser `cloud-app` (ou `app`) sauf si on sait ce qu'on fait. Cela appartient au client ! --- # Exemples (types de sortie) ``` amtool-caascad --alertmanager.url ocb-test06/caascad alert query ``` ``` amtool-caascad --output extended --alertmanager.url ocb-test06/caascad alert query ``` ``` amtool-caascad --output json --alertmanager.url ocb-test06/caascad alert query | jq . ``` --- # Remarques - Lors de la pose d'un silence, penser à indiquer le numéro de ticket concerné dans le commentaire. - <span>`Warning: amtool version (0.24.0) and alertmanager version (0.23.0) are different.` : nous utilisons amtool-0.24.0. Pour le moment, nos Alertmanagers sont en 0.23.0.</span> - En temps normal, ce warning signalera que la version d'amtool sera en retard sur celle d'Alertmanager. - Pour le moment, c'est amtool qui est en avance et nous n'avons pas observé de problème. --- # Conclusion - Pensez à poser des silences avant vos opération - <span>`toolbox update ; toolbox install amtool amtool-caascad`</span> <style type="text/css"> p { font-size: smaller; } .reveal ul ul li { font-size: smaller; } .reveal section { text-align: left; } } .reveal h3 { color: orange; text-align: center; border-bottom: 1px solid orange; } .reveal h1 { color: orange; text-align: center; border-bottom: 1px solid orange; margin-bottom: 0.4em; } .reveal code { color: aquamarine; font-size: smaller; } </style>