Aller au contenu
Docs

HTTP

Sur cette page
  1. Réglages
  2. Quand est-elle saine ?
  3. Exemple
  4. Bon à savoir

La sonde HTTP envoie une requête à une URL et vérifie le code de statut HTTP de la réponse. Utilisez-la pour savoir qu'un site web, un point d'accès d'API ou une route de santé répond.

Dans l'assistant : Website → Website availability, ou API → HTTP status only.

Storefront — Homepage, une sonde HTTP opérationnelle : ses réglages (GET, 200, délai de 10 s, SSL vérifié), sa disponibilité, ses latences P50 et P95, et le graphique des temps de réponse sur 24 heures.
La page d'une sonde : sa configuration en un coup d'œil, puis la disponibilité, la latence et l'historique des temps de réponse.

Réglages#

Réglages d'un contrôle HTTP dans l'assistant de création : gravité, planification et fréquence, puis la méthode et l'URL de la requête, le délai d'expiration en millisecondes, les codes acceptés 2xx et 3xx, et la vérification SSL.
Un contrôle HTTP, c'est une requête, un délai et les codes de statut considérés comme sains.
Réglage Description
Request Méthode et URL. HEAD (par défaut, la plus légère), GET, POST, PUT, PATCH ou DELETE.
Timeout Délai accordé pour la réponse, en millisecondes.
Accepted HTTP codes Codes considérés comme sains : codes exacts (200, 204) ou familles (2xx). Par défaut : 2xx et 3xx.
Verify SSL certificate Fait échouer le contrôle quand le certificat est invalide ou expiré. Activé par défaut.

Show advanced options ajoute :

  • Authentication — aucune, Basic (nom d'utilisateur et mot de passe) ou jeton Bearer ;
  • Request body — un type de contenu et une charge utile, pour POST, PUT et PATCH ;
  • Headers — tout en-tête dont votre point d'accès a besoin.

Les redirections sont suivies.

Quand est-elle saine ?#

Quand le point d'accès répond dans le délai avec un code accepté. Un dépassement de délai, une erreur de connexion, un certificat invalide (s'il est vérifié) ou tout autre code fait échouer le contrôle.

Exemple#

Public API — Health : GET https://api.corvane.example/health, code accepté 200, toutes les minutes, sévérité Critical, alerting Slack #ops-alerts et le téléphone d'astreinte.

Bon à savoir#

  • Pour contrôler ce que renvoie le point d'accès, utilisez Keyword, JSON ou XML : ces sondes partagent ces réglages et ajoutent une condition sur le contenu.
  • L'URL, les identifiants et les en-têtes acceptent des variables comme ${API_HOST} ; la charge utile, non.
  • L'agent public n'atteint que des adresses publiques. Pour une URL interne, exécutez la sonde sur un agent privé.