DataDog ha liberado pg_tracing, una extensión de código abierto para PostgreSQL que facilita la implementación de rastreo distribuido (distributed tracing) a nivel de base de datos. Esta utilidad genera automáticamente segmentos de rastreo para consultas muestreadas, ofreciendo visibilidad detallada sobre el rendimiento interno del motor de la base de datos, según se detalla en su repositorio de GitHub.
La extensión captura métricas granulares, abarcando desde funciones internas como la planificación y la ejecución, hasta el tiempo invertido en el commit de transacciones y la sincronización de datos WAL. Los desarrolladores pueden acceder a estos datos mediante vistas como pg_tracing_consume_spans o exportarlos directamente en formato OTLP JSON utilizando la función pg_tracing_json_spans.
Para la propagación del contexto de rastreo, pg_tracing ofrece dos mecanismos principales: comentarios SQL utilizando SQLCommenter o mediante parámetros de configuración GUC, específicamente pg_tracing.trace_context. Esto permite correlacionar las operaciones de la base de datos con trazas de servicios de aplicación externos.
La instrumentación puede ser activada para todas las consultas estableciendo la tasa de muestreo a 1.0 a través del parámetro pg_tracing.sample_rate. Alternativamente, la extensión puede enviar segmentos de forma asíncrona a un colector OpenTelemetry si se configura pg_tracing.otel_endpoint, utilizando un hilo de trabajo en segundo plano para la transmisión periódica.
La instalación requiere compilar la extensión con los paquetes de desarrollo de PostgreSQL y cargarla mediante la directiva shared_preload_libraries en postgresql.conf, lo que exige un reinicio del servidor. DataDog advierte que la herramienta se encuentra en una fase inicial de desarrollo y su estabilidad aún no está garantizada.
El alcance del monitoreo es amplio, incluyendo el seguimiento de nodos individuales en el plan de ejecución (como SeqScan o HashJoin), consultas anidadas y operaciones ejecutadas a través de disparadores (triggers). Esta profundidad de detalle es crucial para diagnosticar latencias ocultas dentro de la capa de persistencia.
El lanzamiento de pg_tracing subraya la tendencia creciente de integrar herramientas de observabilidad directamente en componentes fundamentales de la infraestructura, moviendo el punto de instrumentación más cerca de la fuente de la latencia. La adopción exitosa podría mejorar significativamente la depuración de aplicaciones complejas que dependen fuertemente de PostgreSQL.
