Alarme personnalisée - Paramètres

Accessible depuis ITCare → Resources → URLs → Actions → Add Custom Check

Les paramètres sont regroupés en blocs. Certains sont communs aux deux types d'alarmes, d'autres sont spécifiques.

---

Bloc — Identification

Commun à l'Alarme Personnalisée et à l'Alarme Personnalisée Externe.

Nom

Obligatoire	Oui
Modifiable après création	Non

Le nom permet d'identifier l'application ou le service testé. Il sera utilisé pour nommer l'alarme dans ITCare selon la convention :

APPS_CHECK_URL_<Nom>

Exemple : mon-app-prod → alarme nommée APPS_CHECK_URL_mon-app-prod

URL

Obligatoire	Oui
Modifiable après création	Non

Pré-remplie et non modifiable si vous accédez à la création depuis le contexte d'une URL existante.

---

Bloc — Source

Commun à l'Alarme Personnalisée et à l'Alarme Personnalisée Externe.

Source du test

Obligatoire	Oui
Modifiable après création	Non — pour toute modification, supprimer et recréer l'alarme (prévoir jusqu'à 30 min pour la prise en compte)

Choisissez d'où le test est exécuté :

Valeur	Description
Interne (depuis cegedim.cloud)	Sonde interne — incluse dans le Load Balancer
Externe (depuis Internet - multi-sites FR)	Sondes publiques depuis Marseille et Paris — option payante

---

Bloc — Requête

Commun à l'Alarme Personnalisée et à l'Alarme Personnalisée Externe.

Protocole

Obligatoire	Oui
Modifiable après création	Non pour l'Alarme Personnalisée Externe

💡 Il est recommandé d'utiliser le protocole HTTPS pour tester vos applications.

Chemin

Obligatoire	Oui
Modifiable après création	Non pour l'Alarme Personnalisée Externe

Le chemin correspond à l'URI sans le domaine et sans les paramètres.

Exemple : pour tester https://www.monapp.com/search?q=test

• Domaine : www.monapp.com

• Chemin : /search

• Les paramètres (?q=test) sont à renseigner dans le bloc Paramètres ci-dessous

---

Bloc — Paramètres de la requête (optionnel)

Commun à l'Alarme Personnalisée et à l'Alarme Personnalisée Externe. Activé via un bouton toggle (désactivé par défaut).

En-têtes HTTP

Obligatoire	Non
Modifiable après création	Oui

Permet d'ajouter des paramètres d'en-tête HTTP à la requête. Lorsqu'un en-tête contient des informations d'authentification, il doit être marqué comme clé sécurisée (pictogramme 🔒).

⚠️ Une seule clé d'authentification peut être activée à la fois. Le verrouillage est désactivé si une authentification est déjà configurée via Basic Authentication.

Exemple :

• Key : Authorization

• Value : login:c39fdde712ca4d9690cd6

Paramètres

Obligatoire	Non
Modifiable après création	Non pour l'Alarme Personnalisée Externe

Permet de spécifier les paramètres de la requête (query string).

Exemple : pour tester https://www.monapp.com/search?q=test&source=hp

• Paramètre 1 — Key : q / Value : test

• Paramètre 2 — Key : source / Value : hp

Authentification basique

Obligatoire	Non
Modifiable après création	Oui

Désactivé automatiquement si une clé d'authentification est déjà configurée dans les En-têtes.

---

Bloc — Vérification de la réponse

Ce bloc diffère selon le type d'alarme.

Alarme Personnalisée (Interne)

Par défaut, une alarme critique est déclenchée lorsque le code HTTP est < 200 ou >= 300.

Les opérateurs supportés :

• Comparaison : ==, !=, >, <, >=, <=

• Logique : or, and

La recherche dans le contenu se fait par la méthode contient — pas d'expression régulière.

Paramètre	Obligatoire	Modifiable	Description	Exemple
Code critique (Critical code)	Oui (valeur par défaut fournie)	Oui	Plage de codes HTTP déclenchant une alarme CRITICAL	%{http_code} < 200 or %{http_code} >= 300
Contenu critique (Critical content)	Non	Oui	Si ce contenu est présent dans la réponse → CRITICAL	__NAGSTATUS=2__
Contenu attendu (Expected content)	Non	Oui	Si ce contenu est absent de la réponse → CRITICAL	Bienvenue sur mon site
Code d'avertissement (Warning code)	Non	Oui	Plage de codes HTTP déclenchant une alarme WARNING	%{http_code} == 302
Contenu d'avertissement (Warning content)	Non	Oui	Si ce contenu est présent dans la réponse → WARNING	__NAGSTATUS=1__

---

Alarme Personnalisée Externe

Par défaut, une alarme est déclenchée lorsque le code HTTP est < 200 ou >= 300 (approche échec).

Deux approches sont disponibles :

Approche	Comportement
Échec (Fail)	L'alarme se déclenche si la réponse correspond aux critères
Réussite (Pass)	L'alarme se déclenche si la réponse ne correspond pas aux critères

Les formats acceptés pour les codes HTTP :

Format	Exemple
Nombre exact	200
Inégalité	>=500
Plage	406-410
Masque de classe	3xx
Valeurs multiples (virgule)	3xx, 404, >=500

⚠️ La gestion des alarmes WARNING n'est pas disponible pour l'Alarme Personnalisée Externe.

Paramètre	Obligatoire	Modifiable	Description	Exemple
Statut par code (Status on code)	Oui (valeur par défaut : < 200, >= 300)	Oui	Code(s) HTTP déclenchant l'alarme	3xx, 404, >=500
Statut par contenu (Status on content)	Non	Oui	Si ce contenu est trouvé/absent dans la réponse → alarme. Recherche par contient uniquement, sans expression régulière	Error establishing a database connection