Información general

Database Monitoring (DBM) de Datadog correlaciona las traces (trazas) de backend de tu aplicación instrumentada en OpenTelemetry con datos detallados sobre el rendimiento de la base de datos. Esto te permite vincular spans (tramos) de tu aplicación con métricas de consulta y planes de ejecución relacionados, lo que te ayuda a identificar las consultas exactas que están ralentizando tus servicios.

Requisitos

Antes de empezar, asegúrate de haber configurado el etiquetado unificado de servicios. Esto es necesario para todas las correlaciones de datos en Datadog.

Configuración

Para correlacionar traces (trazas) y métricas, debes:

1. Instrumentar spans (tramos) de la base de datos: Añade atributos específicos de OpenTelemetry a tus spans (tramos) de base de datos para permitir la correlación con DBM.

2. Configurar la ruta de ingesta de traces (trazas): Activa la puerta de función correcta en tu recopilador o Agent para garantizar que los spans (tramos) de base de datos se procesen correctamente para DBM.

Step (UI) / paso (generic) 1: Instrumenta tu base de datos

Para que la correlación de DBM funcione, los spans (tramos) de tu base de datos deben incluir los siguientes atributos.

Utilización de la instrumentación automática

Para empezar, instrumenta tu aplicación utilizando la biblioteca de autoinstrumentación de OpenTelemetry apropiada para tu lenguaje. Para obtener instrucciones de configuración, consulta la documentación de instrumentación de OpenTelemetry oficial.

Estas bibliotecas añaden automáticamente los atributos db.system y db.statement necesarios. A continuación, el Datadog Agent o el kit de desarrollo de software (SDK) obtienen span.type automáticamente, por lo que no es necesario configurar manualmente los atributos.

processors:
  attributes/add_span_type:
    actions:
      - key: span.type
        value: "sql"
        action: insert
        # Apply this action only to spans that have the db.system attribute
        from_context: span
        when:
          - span.attributes["db.system"] != nil

service:
  pipelines:
    traces:
      # Add the processor to your traces pipeline
      processors: [..., attributes/add_span_type, ...]

Utilización de instrumentación manual

Si estás creando spans (tramos) manualmente con kit de desarrollo de software (SDK) de OpenTelemetry, puedes configurar los atributos directamente en tu código. Para obtener más información, consulta la documentación de OpenTelemetry.

A continuación se muestra un ejemplo conceptual de instrumentación manual con el kit de desarrollo de software (SDK) de OpenTelemetry de Python:

from opentelemetry import trace

tracer = trace.get_tracer("my-app.instrumentation")

# When making a database call, create a span and set attributes
with tracer.start_as_current_span("postgres.query") as span:
    # Set attributes required for DBM correlation
    span.set_attribute("span.type", "sql")
    span.set_attribute("db.system", "postgres")
    span.set_attribute("db.statement", "SELECT * FROM users WHERE id = ?")
    span.set_attribute("db.name", "user_accounts")

    # Your actual database call would go here
    # db_cursor.execute("SELECT * FROM users WHERE id = %s", (user_id,))

Step (UI) / paso (generic) 2: Configurar tu ruta de ingesta

Según cómo envíes las traces (trazas) a Datadog, puede que necesites activar puertas de función específicas para asegurarte de que los spans (tramos) de base de datos se procesen correctamente.

datadog:
  otelCollector:
    featureGates: "datadog.EnableReceiveResourceSpansV2,datadog.EnableOperationAndResourceNameV2"

otelcontribcol --config=config.yaml \
--feature-gates=datadog.EnableOperationAndResourceNameV2

otelcontribcol --config=config.yaml \
--feature-gates=datadog.EnableReceiveResourceSpansV2,datadog.EnableOperationAndResourceNameV2

Visualizar datos correlacionados en Datadog

Después de que tu aplicación envíe traces (trazas), podrás ver la correlación en la vista de traces (trazas) de APM:

1. Ve a APM > Traces (APM > Traces (trazas).
2. Busca y haz clic en una trace (traza) de tu servicio instrumentado.
3. En el gráfico de llamas de la trace (traza), selecciona un span (tramo) de base de datos (por ejemplo, un span (tramo) con span.type: sql)
4. En el panel de detalles, haz clic en la pestaña SQL Queries (Consultas SQL). Deberías ver las métricas de rendimiento y los planes de ejecución de la consulta.

Solucionar problemas

Si no ves la correlación esperada entre tus traces (trazas) de APM y DBM, normalmente se debe a una falta de configuración o a una configuración incorrecta. Check las siguientes causas comunes:

• Faltan atributos: El span (tramo) de base de datos debe contener db.system y db.statement. El atributo span.type también es necesario, pero Datadog suele obtenerlo automáticamente.
• Etiquetado incorrecto del servicio unificado: La tag (etiqueta) service en los spans (tramos) de tu base de datos debe estar configurada. Comprueba que el etiquetado de servicio unificado esté configurado correctamente.
• La consulta SQL puede no ser analizable: La correlación se basa en la capacidad de Datadog para analizar la consulta SQL a partir del atributo db.statement. Si la consulta utiliza una sintaxis no estándar o compleja, el análisis puede fallar. Si sospechas que se trata de case (incidencia), ponte en contacto con el servicio de asistencia de Datadog para obtener ayuda.
• Las puertas de función correctas deben estar activadas para tu ruta de ingesta de traces (trazas) específica, tal y como se describe en los pasos de configuración.

Referencias adicionales

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

Envío de traces (trazas) de OpenTelemetry a DatadogDOCUMENTACIÓN