Base de données SQL

Sur cette page

La sonde SQL database se connecte à une base de données depuis un agent privé et vérifie soit que la connexion fonctionne, soit exécute une requête et compare son résultat à une valeur attendue. Utilisez-la pour savoir qu'une base de données accepte les connexions — et pour surveiller des valeurs métier que seule la base connaît : les commandes créées dans les 15 dernières minutes, le retard de réplication, des tâches bloquées dans une table.

Dans l'assistant : Database → SQL database. Nécessite une offre Enterprise et un agent privé Advanced.

Bases de données prises en charge : PostgreSQL, SQL Server, MySQL, MariaDB et Oracle.

Paramètres#

Database connection

Paramètre	Description
Secret	La chaîne de connexion, stockée comme secret de l'environnement de la sonde. La liste affiche les secrets d'un type compatible.
Timeout	Temps accordé pour la connexion et la requête.
Check type	Connect : ouvrir seulement une connexion. Query : exécuter aussi une requête.

Query (lorsque Check type vaut Query)

Paramètre	Description
SQL query	Une requête renvoyant une seule valeur. Elle peut utiliser des variables.
Condition, Value type, Value to check	Comment comparer le résultat : égal, différent, supérieur, inférieur, contient, longueur, regex.

Quand est-elle saine ?#

Lorsque la connexion s'ouvre dans le délai imparti et, en mode requête, que la condition est vérifiée pour la valeur renvoyée. La valeur est enregistrée et affichée sur un graphique.

Checkout — Orders created, une sonde SQL : graphique sur une semaine du temps de réponse de la requête et de la valeur mesurée, le nombre de commandes, qui suit le trafic de la journée. — Une sonde SQL peut surveiller une valeur métier, ici les commandes créées, autant que la base elle-même.

Exemple#

Checkout — Orders created (15 min) :

SQL

SELECT count(*) FROM orders WHERE created_at > now() - interval '15 minutes'

avec la condition More than 0. Si le tunnel de paiement cesse de fonctionner sans bruit, la sonde échoue alors même que toutes les pages répondent encore.

Bon à savoir#

Utilisez un compte de base de données en lecture seule dans la chaîne de connexion : l'agent a seulement besoin de se connecter et de lire.
Associer un secret nécessite le rôle Manager.
La chaîne de connexion ne quitte jamais Onagre, sauf vers l'agent qui exécute le contrôle. Voir Sécurité des secrets.