Sur cette page

SIGNL4

L’Integrator envoie chaque alerte a SIGNL4 via le webhook entrant de l’equipe. Un moniteur = une alerte SIGNL4 : le retablissement du moniteur la clot. Il vous faut le secret d’equipe (team secret) de l’equipe SIGNL4 a alerter (ou l’URL complete du webhook).

SIGNL4 fonctionne comme PagerDuty : memes interrupteurs, meme destination par defaut sur l’Integrator, meme cloture automatique.

Comment Mugnsoft utilise SIGNL4
API Webhook entrant SIGNL4 - https://connect.signl4.com/webhook/<team secret>
Destination Le secret d’equipe (ou le secret d’une integration), ou l’URL complete du webhook. Seule une URL https sur un hote signl4.com est acceptee : une faute de frappe n’envoie jamais d’alerte ailleurs.
Identifiant d’alerte X-S4-ExternalID = <sonde>:<type>:<moniteur>, par exemple probe-paris:url:web-shop_probe-paris. Toutes les alertes du moniteur se rapportent a la meme alerte SIGNL4.
Statut non OK X-S4-Status: new - declenche l’alerte
Retour a OK X-S4-Status: resolved - clot l’alerte - avec On change, et aussi avec On fail seul
Titre Le titre de l’alerte : [CRITICAL] web-shop · HTTP 503 · probe-paris
Contenu Le message, le type de moniteur en X-S4-Service (il choisit la categorie SIGNL4), moniteur, statut, cible, sonde et heure du controle en champs supplementaires, et un lien Locate in 3D view

Etape 1 : obtenir le secret d’equipe dans SIGNL4

  1. Connectez-vous au portail web SIGNL4 avec un compte manager.
  2. Ouvrez Teams et choisissez l’equipe qui doit recevoir les alertes Mugnsoft.
  3. Copiez le team secret. L’URL du webhook de l’equipe est https://connect.signl4.com/webhook/<team secret>.

Pour passer plutot par une integration dediee de l’equipe, ajoutez une integration Webhook dans Integrations et utilisez son secret ou son URL.

Guides officiels : webhook entrant SIGNL4, Integration with Webhook.

Quiconque possede le secret peut alerter l’equipe : traitez-le comme un secret. Mugnsoft le stocke chiffre et ne le replique jamais vers un webserver-front.

Etape 2 : configurer Mugnsoft

Par defaut pour tous les moniteurs d’un Integrator - Integrator → General → Notifications → SIGNL4 : activez On fail et/ou On change, et collez le secret dans Default team secret.

Par moniteur - moniteur → Actions → carte SIGNL4 : activez le ou les declencheurs. Laissez Team secret vide pour utiliser la valeur par defaut de l’Integrator, ou collez le secret d’une autre equipe. Les applications, les agents Sentinel et les hotes de conteneurs ont la meme carte.

Enregistrez les deux formulaires avec l’icone disquette.

Declencheurs recommandes :

Objectif On fail On change
Alerter sur une panne durable, clore automatiquement active (regle : par ex. error, after 2, for 1) desactive
Suivre chaque changement de statut desactive active

Avec On fail seul, l’alerte est declenchee quand la regle est atteinte et close quand le moniteur revient a OK. Une panne qui est aussi un changement de statut envoie un seul evenement, pas deux.

Une sonde sans Integrator, un agent Sentinel et le Webserver (pour les applications) envoient eux-memes leurs alertes SIGNL4, avec les memes regles.

Tester

Depuis Mugnsoft - dans le bloc Notifications de l’Integrator, cliquez sur ⚡ sur la carte SIGNL4. L’Integrator declenche une alerte de test ([TEST] Mugnsoft notification test) avec le secret affiche dans le champ, ou sa valeur par defaut enregistree, et la clot aussitot. Cela alerte l’equipe d’astreinte : prevenez-la avant.

A la main, depuis l’hote de l’Integrator :


# Declencher une alerte de test
curl -s -X POST https://connect.signl4.com/webhook/YOUR_TEAM_SECRET \
  -H "Content-Type: application/json" \
  -d '{"Title":"Mugnsoft test alert","Message":"test","X-S4-ExternalID":"mugnsoft-test","X-S4-Status":"new"}'

# La clore
curl -s -X POST https://connect.signl4.com/webhook/YOUR_TEAM_SECRET \
  -H "Content-Type: application/json" \
  -d '{"X-S4-ExternalID":"mugnsoft-test","X-S4-Status":"resolved"}'

Chaque appel doit repondre avec un eventId (HTTP 200 ou 201).

Lancez ensuite le test de bout en bout.

Import et export CSV

Les exports de moniteurs se terminent par s4WH;s4OnF;s4OnSC, de meme que l’export des applications. Un fichier exporte avant l’ajout de ces colonnes s’importe toujours : un moniteur ou une application existant garde ses parametres SIGNL4. Voir Import et export.

Depannage

L’Integrator journalise l’erreur SIGNL4 (sendMsgSignl4 - [monitor] - all 3 attempts failed: <error>). Une alerte en echec passe par le tampon de nouvelles tentatives comme pour les autres canaux.

Symptome Cause et action
not a SIGNL4 team secret Le champ contient autre chose qu’un secret (espaces, valeur tronquee…). Copiez a nouveau le secret d’equipe.
not a SIGNL4 webhook URL L’URL collee n’est pas https://...signl4.com/.... Collez le secret seul, ou l’URL du webhook telle que SIGNL4 l’affiche.
SIGNL4 webhook returned HTTP 4xx Secret faux ou revoque. Copiez-le a nouveau depuis l’equipe et lancez le test ⚡.
Le test reussit mais personne n’est alerte Personne de l’equipe n’est d’astreinte, ou la categorie/le service est muet dans SIGNL4. Verifiez l’alerte dans le portail SIGNL4.
Les alertes ne sont jamais closes Le retablissement a ete retenu par Debounce status-change alerts sur la sonde et le moniteur a de nouveau echoue avant d’etre stable.
Une alerte close dans SIGNL4 revient Le moniteur est toujours en echec : son alerte suivante declenche une nouvelle alerte SIGNL4.
Plusieurs alertes pour une panne Une alerte par moniteur et par sonde, par conception : un site controle depuis trois sondes declenche trois alertes.

Plus d’informations dans Depannage.

Traductions

Script personnalise