En esta guía se considera que has configurado Database Monitoring y usas APM. La conexión de APM y DBM inyecta identificadores de traza (trace) de APM en la recopilación de datos de DBM, lo que permite la correlación de estas dos fuentes de datos. Esto permite que las funciones del producto muestren información sobre la base de datos en el producto de APM, y datos de APM en el producto de DBM.

Antes de empezar

Bases de datos compatibles

Postgres, MySQL, SQL Server, Oracle

Versiones compatibles del Agent

7.46 o posterior

Privacidad de los datos

Al habilitar la propagación de comentarios de SQL, se almacenan datos potencialmente confidenciales (nombres de servicios) en las bases de datos, a los que luego pueden acceder terceros a los que se les ha otorgado acceso a la base de datos.

Las integraciones del rastreador de APM admiten un Modo de propagación, que controla la cantidad de información que pasa de las aplicaciones a la base de datos.

• El modo full envía información completa sobre la traza a la base de datos, lo que te permite investigar trazas individuales en DBM. Esta es la solución recomendada para la mayoría de las integraciones.
• El modo service envía el nombre del servicio, lo que te permite conocer qué servicios contribuyen a la carga de la base de datos. Este es el único modo compatible con las aplicaciones de Oracle.
• El modo disabled deshabilita la propagación y no envía información desde las aplicaciones.

* El modo de propagación completa en Aurora MySQL requiere la versión 3.

Rastreadores y controladores de aplicaciones compatibles

* CommandType.StoredProcedure no compatible

** Modo completo de SQL Server para Java/.NET:

• La instrumentación ejecuta un comando SET context_info cuando el cliente emite una consulta, lo que realiza un recorrido completo adicional a la base de datos.
• Requisitos previos:
  • Versión 7.55.0 o posterior del Agent
  • Versión 1.39.0 o posterior del rastreador de Java
  • Versión del rastreador .NET 3.3 o posterior

*** Oracle modo completo para Java:

• La instrumentación sobrescribe V$SESSION.ACTION.
• Requisito previo: rastreador de Java 1.45 o posterior

Configuración

Para obtener la mejor experiencia de usuario, asegúrate de que las siguientes variables de entorno se hayan configurado en tu aplicación:

DD_SERVICE=(nombre de la aplicación)
DD_ENV=(entorno de la aplicación)
DD_VERSION=(versión de la aplicación)

Datadog recomienda establecer el modo de enmascaramiento en obfuscate_and_normalize para las versiones del Agent 7.63 y posteriores. Añade el siguiente parámetro en la sección apm_config de tu archivo de configuración del Agent de APM:

  sql_obfuscation_mode: "obfuscate_and_normalize"

go get gopkg.in/DataDog/dd-trace-go.v1@v1.44.0 # 1.x
# go get github.com/DataDog/dd-trace-go/v2 # 2.x

import (
   "database/sql"
   "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer" // 1.x
   sqltrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql" // 1.x
   // "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer" // 2.x
   // sqltrace "github.com/DataDog/dd-trace-go/contrib/database/sql/v2" // 2.x
)

import (
    "database/sql"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer" // 1.x
   sqltrace "gopkg.in/DataDog/dd-trace-go.v1/contrib/database/sql" // 1.x
   // "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer" // 2.x
   // sqltrace "github.com/DataDog/dd-trace-go/contrib/database/sql/v2" // 2.x
)

func main() {
    // The first step is to set the dbm propagation mode when registering the driver. Note that this can also
    // be done on sqltrace.Open for more granular control over the feature.
    sqltrace.Register("postgres", &pq.Driver{}, sqltrace.WithDBMPropagation(tracer.DBMPropagationModeFull))

    // Followed by a call to Open.
    db, err := sqltrace.Open("postgres", "postgres://pqgotest:password@localhost/pqgotest?sslmode=disable")
    if err != nil {
        log.Fatal(err)
    }

    // Then, we continue using the database/sql package as we normally would, with tracing.
    rows, err := db.Query("SELECT name FROM users WHERE age=?", 27)
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()
}

# Inicia el Java Agent con las propiedades del sistema requeridas
java -javaagent:/path/to/dd-java-agent.jar -Ddd.dbm.propagation.mode=full -Ddd.integration.jdbc-datasource.enabled=true -Ddd.service=my-app -Ddd.env=staging -Ddd.version=1.0 -jar path/to/your/app.jar

public class Application {
    public static void main(String[] args) {
        try {
            Connection connection = DriverManager
                    .getConnection("jdbc:postgresql://127.0.0.1/foobar?preferQueryMode=simple", "user", "password");
            Statement stmt = connection.createStatement();
            String sql = "SELECT * FROM foo";
            stmt.execute(sql);
            stmt.close();
            connection.close();
        } catch (SQLException exception) {
            //  lógica de excepción
        }
    }
}

source 'https://rubygems.org'
gem 'datadog' # Usa `'ddtrace', '>= 1.8.0'` si estás usando v1.x

# Depende de tu uso
gem 'mysql2'
gem 'pg'

require 'mysql2'
require 'ddtrace'

Datadog.configure do |c|
    c.service = 'billing-api'
    c.env = 'production'
    c.version = '1.3-alpha'

    c.tracing.instrument :mysql2, comment_propagation: ENV['DD_DBM_PROPAGATION_MODE']
end

client = Mysql2::Client.new(:host => "localhost", :username => "root")
client.query("SELECT 1;")

pip install "ddtrace>=1.9.0"

pip install psycopg2

import psycopg2

POSTGRES_CONFIG = {
    "host": "127.0.0.1",
    "port": 5432,
    "user": "postgres_user",
    "password": "postgres_password",
    "dbname": "postgres_db_name",
}

# conecta a la base de datos de Postgres
conn = psycopg2.connect(**POSTGRES_CONFIG)
cursor = conn.cursor()
# ejecuta consultas de SQL
cursor.execute("select 'blah'")
cursor.executemany("select %s", (("foo",), ("bar",)))

npm install dd-trace@^3.17.0

// This line must come before importing any instrumented module.
const tracer = require('dd-trace').init();

const pg = require('pg')
const tracer = require('dd-trace').init({ dbmPropagationMode: 'full' })

const client = new pg.Client({
    user: 'postgres',
    password: 'postgres',
    database: 'postgres'
})

client.connect(err => {
    console.error(err);
    process.exit(1);
});

client.query('SELECT $1::text as message', ['Hello world!'], (err, result) => {
    // gestiona el resultado
})

Explorar la conexión de APM en DBM

Atribuir las conexiones de base de datos activas a los servicios de APM que realizan llamadas

Desglosa las conexiones activas de un host determinado por los servicios de APM ascendentes que realizan las solicitudes. Puedes atribuir la carga de una base de datos a servicios individuales para comprender qué servicios son los más activos en la base de datos. Dirígete a la página de servicios del servicio ascendente más activo para continuar la investigación.

Filtrar los hosts de bases de datos por los servicios de APM que los llaman

Filtra con rapidez la lista de bases de datos para solo visualizar los hosts de bases de datos de los que dependen tus servicios de APM específicos. Identifica de manera sencilla si alguna de tus dependencias descendentes tiene actividad de bloqueo que pueda afectar el rendimiento del servicio.

Ver la traza asociada a una muestra de consulta

Al visualizar una muestra de consulta en Database Monitoring, si APM ha realizado un muestreo de la traza asociada, puedes ver la muestra de DBM en el contexto de la traza de APM. Esto te permite combinar la telemetría de DBM, incluido el plan de explicación y el rendimiento histórico de la consulta, junto con el linaje del tramo dentro de tu infraestructura para comprender si un cambio en la base de datos es responsable del bajo rendimiento de la aplicación.

Explorar la conexión de DBM en APM

Visualizar los hosts de bases de datos descendentes de los servicios de APM

En la página de APM de un servicio determinado, visualiza las dependencias de bases de datos descendentes directas del servicio identificadas por Database Monitoring. Determina con rapidez si algún host tiene una carga desproporcionada que puede ser causada por hosts vecinos ruidosos. Para ver la página de un servicio, haz clic en el servicio en el Service Catalog a fin de abrir un panel de detalles y, a continuación, haz clic en View Service Page (Ver página de servicios) en el panel.

Identificar posibles optimizaciones mediante planes de explicación para consultas de bases de datos en trazas

Visualiza el rendimiento histórico de consultas similares a las que se ejecutan en tu traza, incluidos los eventos de espera muestreados, la latencia promedio y los planes de explicación capturados recientemente, para contextualizar cómo se espera que funcione una consulta. Determina si el comportamiento es anormal y continúa la investigación al pasar a Database Monitoring para obtener contexto adicional sobre los hosts de bases de datos subyacentes.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

Correlacionar sin problemas los datos de telemetría de DBM y APM para comprender el rendimiento de las consultas integralesBLOG