Una consulta lenta bloquea locks, las conexiones se apilan y el servicio de aplicación acaba en timeout. OneAgent ve la llamada SQL desde el lado de la aplicación, pero no lo que ocurre dentro del motor. Una extensión Dynatrace para bases de datos cubre ese hueco: consulta PostgreSQL u Oracle de forma remota y devuelve la actividad, las esperas y las consultas más costosas.
Para un SRE, es la diferencia entre «la base de datos va lenta» y «la sesión 4127 lleva nueve minutos reteniendo un lock». El diagnóstico pasa de la intuición a la prueba, y el MTTR lo agradece.
Objetivo de este tutorial: preparar un usuario de monitorización de PostgreSQL, instalar la extensión desde el Hub, crear una configuración de monitorización ejecutada por un grupo de ActiveGate y verificar después las métricas. El principio vale para Dynatrace SaaS y Dynatrace Managed (Extensions 2.0, versión 1.255 o posterior según la documentación de la extensión de PostgreSQL); Oracle se trata al final del artículo.
Cómo funciona una extensión Dynatrace para bases de datos
Las extensiones de bases de datos del framework Extensions 2.0 son extensiones remotas: no se instala ningún agente en el servidor de la base de datos. Un ActiveGate se conecta al motor con una cuenta dedicada, ejecuta consultas de monitorización a intervalos fijos y envía los resultados como métricas y logs.
- Grupo de ActiveGate: la configuración apunta a un grupo, y un único ActiveGate del grupo la ejecuta. Todos los miembros deben alcanzar la base de datos.
- Punto de conexión (endpoint): host, puerto, base de datos e identificadores. Una configuración puede llevar muchos puntos de conexión.
- Feature sets: grupos de métricas que activas o no. Cuantos menos feature sets, menos consultas sobre la base de datos y menos consumo.
Requisitos previos
- Un ActiveGate con el módulo de extensiones activado, colocado en un grupo (por ejemplo
db-paris), que alcance el puerto de la base de datos (5432 por defecto en PostgreSQL). - Acceso de administrador a la base de datos para crear la cuenta de monitorización.
- Derecho a instalar extensiones y a crear configuraciones en el entorno de Dynatrace.
- Para PostgreSQL: los módulos complementarios (contrib) instalados si la base de datos es autoalojada.
Paso 1: crear el usuario de monitorización de PostgreSQL
Crea una cuenta dedicada, nunca una cuenta de aplicación compartida. El rol integrado pg_monitor da lectura de las vistas de estadísticas sin derecho de escritura sobre los datos.
CREATE USER dynatrace WITH PASSWORD '<mot-de-passe>' INHERIT;
GRANT pg_monitor TO dynatrace;
Activa después pg_stat_statements, indispensable para las estadísticas por consulta. En un servidor autoalojado, en postgresql.conf:
shared_preload_libraries = 'pg_stat_statements'
Este parámetro exige un reinicio: planifícalo en una ventana de mantenimiento. En AWS RDS, Azure Database for PostgreSQL o Cloud SQL, modifica el grupo de parámetros, el parámetro del servidor o el flag correspondiente.
En cada base de datos que quieras monitorizar, crea el esquema de trabajo de la extensión:
CREATE EXTENSION IF NOT EXISTS pg_stat_statements;
CREATE SCHEMA IF NOT EXISTS dynatrace;
GRANT USAGE ON SCHEMA dynatrace TO dynatrace;
La documentación proporciona también una función auxiliar que genera los planes de ejecución de las consultas costosas. Es opcional pero valiosa; tómala tal cual de la página de la extensión, sin modificarla.
Paso 2: instalar la extensión desde el Hub
Abre el Hub de tu entorno, busca la extensión de PostgreSQL publicada por Dynatrace e instálala. En SaaS, la aplicación Databases ofrece un asistente para añadir instancias que genera los scripts SQL adecuados al tipo de alojamiento; en Managed, pasa por la pantalla de extensiones. Ambos caminos llevan al mismo objeto: una configuración de monitorización.
Paso 3: crear la configuración de monitorización
En la extensión, añade una configuración. Elige el grupo de ActiveGate y declara después el punto de conexión: host, puerto, nombre de la base de datos principal (en general postgres) e identificadores. Prefiere la caja fuerte de credenciales (credential vault) a la introducción directa: la rotación de la contraseña se hace entonces en un único sitio.
Para automatizar, la misma configuración se envía por la API. El fragmento de ámbito que designa el grupo de ActiveGate tiene esta forma:
"scope": "ag_group-db-paris"
Ajusta después los intervalos. El intervalo de consulta por defecto es de un minuto; el intervalo largo, que recoge las consultas más costosas, es de cinco minutos. Acortarlo aumenta el consumo de la monitorización sobre las bases de datos: hazlo solo de forma temporal, durante una investigación.
Añade por último metadatos (equipo, centro de costes, contexto de seguridad): servirán para enrutar las alertas y para los derechos de acceso.
Cómo comprobar que funciona
En la pantalla de la extensión, la configuración debe pasar al estado OK en unos minutos. Un estado de error muestra el mensaje de conexión: contraseña rechazada, puerto filtrado o pg_stat_statements ausente.
En SaaS, abre un notebook y ejecuta:
timeseries active = avg(postgres.activity.active),
idle_tx = avg(postgres.activity.idle_in_transaction)
Una curva idle_in_transaction que sube suele ser la primera huella de una transacción olvidada en la aplicación. En Managed, muestra las mismas claves de métrica en el explorador de datos. Para seguir, los ejemplos de consultas DQL de operación muestran cómo cruzar estas métricas con los logs.
Desde el lado del ActiveGate, si no llega nada, comprueba que el host alcanza de verdad la base de datos:
nc -zv db-orders.internal 5432
¿Y para Oracle?
El método es el mismo: extensión Oracle Database instalada desde el Hub, cuenta de monitorización dedicada y configuración ejecutada por un grupo de ActiveGate que alcance el listener (1521 por defecto). Solo difieren los derechos: la cuenta debe leer las vistas dinámicas de rendimiento del diccionario. La lista exacta de privilegios depende de la versión de la extensión y de la arquitectura (CDB o no): tómala de la página de la extensión de Oracle en la documentación, en lugar de conceder por comodidad un rol amplio como SELECT ANY DICTIONARY.
Buenas prácticas
- Al menos dos ActiveGate por grupo: si uno cae, el otro retoma la configuración.
- Coloca el grupo cerca de las bases de datos (misma red, misma región); consulta Environment ActiveGate o Cluster ActiveGate.
- Activa solo los feature sets útiles: cada consulta de monitorización se ejecuta en una base de datos de producción.
- Alerta sobre síntomas (conexiones saturadas, deadlocks), no sobre cada métrica; nuestra guía para reducir el ruido de las alertas de Davis detalla el método.
- Rota la contraseña de la cuenta mediante la caja fuerte de credenciales, nunca en la propia configuración.
Preguntas frecuentes
¿Sustituye la extensión a OneAgent para las bases de datos?
No. OneAgent ve las llamadas SQL desde la aplicación, con la traza distribuida. La extensión ve el motor por dentro: sesiones, esperas, locks, planes. Las dos vistas se complementan durante una investigación.
¿Qué diferencia hay entre SaaS y Managed?
El motor de Extensions 2.0 y la ejecución por ActiveGate son comunes. En SaaS, la aplicación Databases añade un asistente y vistas dedicadas, y las métricas se consultan con DQL en Grail. En Managed, la configuración pasa por la pantalla de extensiones y las métricas se muestran en el explorador de datos.
¿Por qué la configuración sigue en error si la contraseña es correcta?
Comprueba por orden: la red desde cada ActiveGate del grupo (no solo desde tu equipo), la regla de pg_hba.conf, que debe autorizar la dirección del ActiveGate, y después la presencia de pg_stat_statements en shared_preload_libraries.
Conclusión
Una cuenta pg_monitor, una extensión instalada desde el Hub y un grupo de ActiveGate bastan para abrir el capó de PostgreSQL. Empieza por una base de datos crítica, deja los intervalos por defecto, observa durante una semana y amplía después. La página de referencia está en docs.dynatrace.com.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC. Dynatrace es una marca de su propietario. Los nombres de pantallas y los procedimientos evolucionan: comprueba siempre la documentación oficial antes de un cambio en producción.