Créer et gérer des sondes
Sur cette page
Créer une sonde#
Cliquez sur New monitor — dans la barre latérale, sur la vue d'ensemble ou sur la page Resources — et choisissez comment commencer :
- Start from a template — choisissez un scénario courant (Website availability, Nightly backup, PostgreSQL availability…) : le formulaire ci-dessous s'ouvre prérempli, vous complétez ce qui vous est propre. Voir Modèles.
- Configure manually — l'assistant pose quatre questions, décrites ci-dessous, et donne accès à tous les types et à toutes les options.
1. Que surveiller#
Choisissez un objectif : Website, API, Database, Scheduled job, Server, Network, SSL certificate, Domain name, Message queue ou Files. Inutile de connaître les types de sondes : l'objectif y mène.
Server ne se crée pas ici : les sondes serveur accompagnent chaque agent privé, cette carte mène donc simplement à la page des agents.
2. Stratégie#
Choisissez le contrôle qui correspond à ce qui compte pour vous. Par exemple :
| Objectif | Stratégies |
|---|---|
| Website | Website availability (HTTP) · Specific content (Keyword) |
| API | HTTP status only (HTTP) · JSON response content (JSON) · XML response content (XML) |
| Database | SQL database (SQL) · Key-value store (Redis) (Clé-valeur) |
| Network | Host availability (Ping) · Port availability (Port) |
Les objectifs comportant un seul contrôle sautent cette étape. Un contrôle non inclus dans votre offre affiche un bouton Upgrade.
3. Configuration#
L'étape de configuration comporte les mêmes sections pour tous les types :
- General — Name, Service et Environment (tous deux pré-remplis avec vos valeurs par défaut) et des Tags facultatifs (appuyez sur Entrée ou saisissez une virgule pour en ajouter un).
- Schedule and severity — voir ci-dessous.
- Les réglages propres au type — la requête, l'hôte, la requête SQL… La page de chaque type les détaille.
- Agent — l'Onagre public agent, sélectionné par défaut, ou l'un de vos agents privés. Seuls les agents Advanced sont listés ; chacun indique s'il est Online. Les types qui exigent un agent privé masquent l'agent public.
- Alerting — les intégrations à notifier. Si vous n'en sélectionnez aucune, Onagre vous demande de confirmer : la sonde ouvrira des incidents mais ne préviendra personne.
4. Vérification#
Vérifiez le récapitulatif — chaque partie a un bouton Edit — puis cliquez sur Create monitor. Vous arrivez sur la page de la sonde, où le premier résultat apparaît après le premier contrôle.
Planification et sévérité#
Planification des contrôles
- Interval — toutes les 1, 2, 5, 10, 15 ou 30 minutes, ou toutes les 1, 2, 6 ou 12 heures. L'offre Free commence à 5 minutes ; la valeur par défaut est 5 minutes.
- Daily — une fois par jour, à une heure donnée.
- Weekly — une fois par semaine, un jour et à une heure donnés.
Les heures sont exprimées dans le fuseau horaire de votre organisation (défini dans votre profil). Les contrôles de certificat s'exécutent toujours une fois par jour.
Severity — Critical, Major, Minor ou Info. Elle est recopiée sur chaque incident ouvert par la sonde, ce qui vous permet de trier et filtrer les incidents par importance. Elle ne change pas qui est notifié.
Timeout — pour les contrôles réseau et base de données, le délai accordé avant que le contrôle échoue, en millisecondes. Il vaut par défaut le maximum de votre offre : 5 secondes en Free, 15 secondes sur les offres payantes.
Hôtes et adresses#
Les champs nommés Host acceptent un nom d'hôte (db01), un nom de domaine complet (api.corvane.example), une adresse IPv4 (10.20.1.21) ou une adresse IPv6 (2001:db8::1). N'incluez ni schéma (https://) ni chemin : ils ont leur place dans les champs URL.
Gardez en tête l'endroit où s'exécute le contrôle : l'agent public n'atteint que des adresses publiques, donc 10.20.1.21 ou db01 nécessitent un agent privé situé dans le même réseau.
Réutiliser des valeurs entre environnements#
Les champs comme les URL, les hôtes, les en-têtes, les requêtes SQL et les clés Redis acceptent des variables écrites ${NAME}, tirées de l'environnement de la sonde : https://${API_HOST}/health contrôle un hôte différent en Staging et en Production. Les sondes base de données, clé-valeur et file utilisent des secrets pour leurs chaînes de connexion.
Utiliser une variable ou un secret dans une sonde exige le rôle Manager. Voir Variables et Secrets.
Gérer les sondes existantes#
Depuis la page d'une sonde :
- Edit rouvre l'assistant à l'étape de configuration ; Save changes applique les modifications dès le contrôle suivant.
- Pause suspend les contrôles (ni résultats, ni incidents) jusqu'à ce que vous cliquiez sur Start.
- More actions → Duplicate crée une copie et l'ouvre pour modification ; Delete supprime la sonde et son historique. Un incident ouvert est clos avec le motif resource deleted.
Depuis la liste Resources, sélectionnez plusieurs sondes avec leurs cases à cocher pour les démarrer (Start), les mettre en pause (Pause) ou les supprimer (Delete) en une fois, ou pour définir leurs intégrations avec Alertings (cela remplace leur alerting actuel). Cliquez sur l'état d'une sonde pour la mettre en pause ou la démarrer.
Pour retrouver des sondes, filtrez par type avec les pastilles en haut, par état avec All / Up / Down / Paused / Created, ou recherchez par nom. Le champ de recherche comprend aussi tag:checkout et state:down.
Les sondes serveur et les sondes de heartbeat d'agent se gèrent avec leur agent : elles ne peuvent pas être mises en pause, dupliquées ni supprimées isolément.
Qui peut faire quoi#
Les Viewer peuvent voir les sondes et leurs résultats. Créer, modifier, mettre en pause et supprimer des sondes exige le rôle User ; utiliser des variables ou des secrets exige Manager. Voir Équipe et rôles.
Limites#
Chaque offre inclut un nombre de sondes — 10 en Free, puis de 50 à 1 000. Les sondes serveur ne sont pas comptées. Une fois la limite atteinte, la création est refusée jusqu'à ce que vous changiez d'offre. Voir Offres.