Une requête lente bloque des verrous, les connexions s’empilent et le service applicatif finit en timeout. OneAgent voit l’appel SQL côté application, mais pas ce qui se passe dans le moteur. Une extension Dynatrace base de données comble ce trou : elle interroge PostgreSQL ou Oracle à distance et remonte l’activité, les attentes et les requêtes les plus coûteuses.
Pour un SRE, c’est la différence entre « la base est lente » et « la session 4127 tient un verrou depuis neuf minutes ». Le diagnostic passe de l’intuition à la preuve, et le MTTR suit.
Objectif de ce tutoriel : préparer un utilisateur de supervision PostgreSQL, installer l’extension depuis le Hub, créer une configuration de supervision exécutée par un groupe d’ActiveGate, puis vérifier les métriques. Le principe vaut pour Dynatrace SaaS et Dynatrace Managed (Extensions 2.0, version 1.255 ou plus récente selon la documentation de l’extension PostgreSQL) ; Oracle est traité en fin d’article.
Comment fonctionne une extension Dynatrace base de données
Les extensions de bases de données du framework Extensions 2.0 sont des extensions distantes : aucun agent n’est installé sur le serveur de base. Un ActiveGate se connecte au moteur avec un compte dédié, exécute des requêtes de supervision à intervalle fixe et envoie les résultats sous forme de métriques et de logs.
- Groupe d’ActiveGate : la configuration cible un groupe, et un seul ActiveGate du groupe l’exécute. Tous les membres doivent joindre la base.
- Point de terminaison : hôte, port, base et identifiants. Une configuration peut porter de nombreux points de terminaison.
- Feature sets : des groupes de métriques que vous activez ou non. Moins de feature sets, moins de requêtes sur la base et moins de consommation.
Prérequis
- Un ActiveGate avec le module d’extensions activé, placé dans un groupe (par exemple
db-paris), qui atteint le port de la base (5432 par défaut pour PostgreSQL). - Un accès administrateur à la base pour créer le compte de supervision.
- Le droit d’installer des extensions et de créer des configurations dans l’environnement Dynatrace.
- Pour PostgreSQL : les modules complémentaires (contrib) installés si la base est auto-hébergée.
Étape 1 : créer l’utilisateur de supervision PostgreSQL
Créez un compte dédié, jamais un compte applicatif partagé. Le rôle intégré pg_monitor donne la lecture des vues de statistiques sans droit d’écriture sur les données.
CREATE USER dynatrace WITH PASSWORD '<mot-de-passe>' INHERIT;
GRANT pg_monitor TO dynatrace;
Activez ensuite pg_stat_statements, indispensable pour les statistiques par requête. Sur un serveur auto-hébergé, dans postgresql.conf :
shared_preload_libraries = 'pg_stat_statements'
Ce paramètre impose un redémarrage : planifiez-le dans une fenêtre de maintenance. Sur AWS RDS, Azure Database for PostgreSQL ou Cloud SQL, modifiez le groupe de paramètres, le paramètre serveur ou le flag correspondant.
Dans chaque base à superviser, créez le schéma de travail de l’extension :
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
CREATE SCHEMA IF NOT EXISTS dynatrace;
GRANT USAGE ON SCHEMA dynatrace TO dynatrace;
La documentation fournit aussi une fonction d’aide qui produit les plans d’exécution des requêtes coûteuses. Elle est optionnelle mais précieuse ; reprenez-la telle quelle depuis la page de l’extension, sans la modifier.
Étape 2 : installer l’extension depuis le Hub
Ouvrez le Hub de votre environnement, cherchez l’extension PostgreSQL publiée par Dynatrace et installez-la. En SaaS, l’application Databases propose un assistant d’ajout d’instance qui génère les scripts SQL adaptés au type d’hébergement ; en Managed, passez par l’écran des extensions. Les deux chemins aboutissent au même objet : une configuration de supervision.
Étape 3 : créer la configuration de supervision
Dans l’extension, ajoutez une configuration. Choisissez le groupe d’ActiveGate, puis déclarez le point de terminaison : hôte, port, nom de la base principale (en général postgres) et identifiants. Préférez le coffre d’identifiants (credential vault) à la saisie directe : la rotation du mot de passe se fait alors à un seul endroit.
Pour automatiser, la même configuration se pousse via l’API. Le fragment de portée qui désigne le groupe d’ActiveGate a cette forme :
"scope": "ag_group-db-paris"
Réglez ensuite les intervalles. L’intervalle de requête par défaut est d’une minute ; l’intervalle long, qui collecte les requêtes les plus coûteuses, vaut cinq minutes. Le raccourcir augmente la consommation de supervision des bases : ne le faites que temporairement, pendant une enquête.
Ajoutez enfin des métadonnées (équipe, centre de coût, contexte de sécurité) : elles serviront au routage des alertes et aux droits d’accès.
Comment vérifier que ça fonctionne
Dans l’écran de l’extension, la configuration doit passer à l’état OK en quelques minutes. Un état d’erreur affiche le message de connexion : mot de passe refusé, port filtré ou pg_stat_statements absent.
En SaaS, ouvrez un notebook et lancez :
timeseries active = avg(postgres.activity.active),
idle_tx = avg(postgres.activity.idle_in_transaction)
Une courbe idle_in_transaction qui monte est souvent la première trace d’une transaction oubliée côté application. En Managed, affichez les mêmes clés de métrique dans l’explorateur de données. Pour la suite, les exemples de requêtes DQL d’exploitation montrent comment croiser ces métriques avec les logs.
Côté ActiveGate, si rien n’arrive, vérifiez que l’hôte rejoint bien la base :
nc -zv db-orders.internal 5432
Et pour Oracle ?
La démarche est la même : extension Oracle Database installée depuis le Hub, compte de supervision dédié, configuration exécutée par un groupe d’ActiveGate qui joint le listener (1521 par défaut). Seuls les droits diffèrent : le compte doit lire les vues dynamiques de performance du dictionnaire. La liste exacte des privilèges dépend de la version de l’extension et de l’architecture (CDB ou non) : reprenez-la depuis la page de l’extension Oracle dans la documentation, plutôt que d’accorder un rôle large comme SELECT ANY DICTIONARY par facilité.
Bonnes pratiques
- Deux ActiveGate au moins par groupe : si l’un tombe, l’autre reprend la configuration.
- Placez le groupe près des bases (même réseau, même région) ; voir Environment ActiveGate ou Cluster ActiveGate.
- N’activez que les feature sets utiles : chaque requête de supervision tourne sur une base de production.
- Alertez sur des symptômes (connexions saturées, deadlocks), pas sur chaque métrique ; notre guide pour réduire le bruit des alertes Davis détaille la méthode.
- Faites tourner le mot de passe du compte via le coffre d’identifiants, jamais dans la configuration elle-même.
Questions fréquentes
L’extension remplace-t-elle OneAgent pour les bases de données ?
Non. OneAgent voit les appels SQL depuis l’application, avec la trace distribuée. L’extension voit le moteur de l’intérieur : sessions, attentes, verrous, plans. Les deux vues se complètent pendant une enquête.
Quelle différence entre SaaS et Managed ?
Le moteur Extensions 2.0 et l’exécution par ActiveGate sont communs. En SaaS, l’application Databases ajoute un assistant et des vues dédiées, et les métriques se requêtent en DQL dans Grail. En Managed, la configuration passe par l’écran des extensions et les métriques s’affichent dans l’explorateur de données.
Pourquoi la configuration reste-t-elle en erreur alors que le mot de passe est bon ?
Vérifiez dans l’ordre : le réseau depuis chaque ActiveGate du groupe (pas seulement depuis votre poste), la règle pg_hba.conf qui doit autoriser l’adresse de l’ActiveGate, puis la présence de pg_stat_statements dans shared_preload_libraries.
Conclusion
Un compte pg_monitor, une extension installée depuis le Hub et un groupe d’ActiveGate suffisent à ouvrir le capot de PostgreSQL. Commencez par une base critique, laissez les intervalles par défaut, observez une semaine, puis étendez. La page de référence est sur docs.dynatrace.com.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Les noms d’écrans et les procédures évoluent : vérifiez toujours la documentation officielle avant un changement en production.