Requête HTTP

La tâche HTTP vérifie si un site ou un service web s'ouvre comme vous l'attendez dans un fonctionnement normal.

Quand l'utiliser

  • Quand il faut contrôler une page de site, un tableau de bord ou un endpoint de santé.
  • Quand il est important de vérifier non seulement la disponibilité du serveur, mais aussi la réponse HTTP correcte.
  • Quand vous voulez voir la panne avec les yeux de l'utilisateur, et pas seulement par un port ouvert.

Quand choisir un autre type

  • Si vous devez vérifier seulement la connectivité réseau de base du serveur, un Ping suffit souvent.
  • Si seule la date d'expiration du certificat est importante, SSL convient mieux.
  • Si le monitoring doit attendre un signal d'un processus externe, utilisez « Événement externe ».
Attention : pour la vérification principale, choisissez mieux une URL qui reflète vraiment l'état de fonctionnement du service, et non une page aléatoire qui peut changer à cause de l'authentification, de la publicité ou de la personnalisation.

Champs généraux du formulaire

Champ Que cela signifie Que spécifier Exemple
Tâche activée Détermine si la vérification sera lancée immédiatement après la sauvegarde. Laissez la tâche activée si vous voulez commencer le monitoring tout de suite. Activé
Nom Nom de la vérification dans la liste et les notifications. Indiquez ce qui est exactement vérifié. Page d'accueil example.com
Groupe Permet d'attribuer la tâche à un projet ou une section. Choisissez un groupe si vous voulez garder les tâches d'un projet ensemble. Site example.com
Intervalle À quelle fréquence la vérification HTTP sera exécutée. Choisissez l'intervalle selon l'importance de la page ou du service. 5 minutes
Canaux de notification Où envoyer les messages sur les problèmes et les récupérations. Marquez les canaux où vous lisez vraiment les notifications. Telegram et email
Rapports Résumés périodiques de la tâche. Activez si vous voulez recevoir un aperçu sans entrer manuellement dans le panneau. Rapport hebdomadaire

Champs de vérification HTTP

Champ Que cela signifie Que spécifier Exemple
Méthode Quelle requête HTTP sera envoyée. GET suffit généralement. Les autres méthodes sont nécessaires si votre endpoint les exige. GET
URL Adresse complète de la page ou de l'endpoint à vérifier. Indiquez l'URL complète avec le schéma et le domaine. https://example.com/health
Timeout Combien de temps attendre la réponse avant l'erreur de non-disponibilité. Choisissez une valeur légèrement supérieure au temps de réponse habituel de votre service. 30 secondes
Mot-clé Vérification supplémentaire du contenu de la réponse. Indiquez le texte qui doit être présent dans la réponse. OK
Paramètres avancés Ouvre des champs HTTP supplémentaires. Activez seulement si vous avez besoin d'en-têtes, d'un corps de requête ou de votre propre liste de codes de succès. Activé
En-têtes En-têtes HTTP supplémentaires de la requête. Ajoutez seulement les en-têtes vraiment nécessaires à votre API. Authorization: Bearer <token><br /> Accept: application/json
Contenu Corps de la requête HTTP pour POST, PUT ou PATCH. Remplissez si l'endpoint attend un JSON ou un autre corps de requête. {"event":"healthcheck"}
Codes de réponse réussis Quels codes HTTP considérer comme un résultat normal. Laissez la plage standard ou définissez vos propres codes et plages. 200-299, 301
Points de vérification autorisés De quels points la vérification sera effectuée. Laissez tous les points si aucun scénario spécial par région ou réseau n'est nécessaire. Tous les points de vérification

Quand l'alerte arrivera

  • Le site ou l'endpoint ne répondra pas à temps.
  • Le serveur renverra un code qui n'est pas dans la liste des succès.
  • Le texte obligatoire sera absent de la réponse si vous avez indiqué un mot-clé.
  • Pour une adresse en HTTPS, il ne sera pas possible d'établir une connexion sécurisée : le certificat a expiré, on ne lui fait pas confiance ou il est émis sous un autre nom. La raison de la vérification indiquera exactement le problème.
Vous vérifiez un service interne ? S'il fonctionne en HTTPS avec un certificat auto-signé, activez « Paramètres avancés » et cochez le paramètre « Permettre un certificat auto-signé » — sinon la vérification échouera en raison de la méfiance du certificat, bien que le service lui-même réponde correctement.

Configuration des notifications

Pour chaque canal de notification dans la tâche, on peut définir des paramètres supplémentaires. Ils ne s'appliquent qu'aux événements DOWN.

Paramètre Ce que cela fait
Activé Autorise ou interdit l'envoi de notifications par ce canal pour cette tâche.
Reporter de PRO Retarde la première notification DOWN du temps sélectionné (jusqu'à 12 heures). Pratique pour ne pas recevoir d'alertes sur des pannes temporaires.
Répéter toutes les PRO Répète périodiquement la notification tant que la tâche reste dans le statut DOWN (jusqu'à 1 heure entre les répétitions). Convient quand il est important de ne pas manquer une panne prolongée.
Les paramètres « Reporter » et « Répéter » n'affectent pas les événements UP et les notifications de récupération.
À la liste des types de tâches