Correlación de logs y trazas de Go

Inyección manual

La API de rastreador de Go permite imprimir información de tramo (span) junto con sentencias de log mediante el especificador de formato %v:

package main

import (
    "net/http"

    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func handler(w http.ResponseWriter, r *http.Request) {
    // Crea un tramo para una solicitud web en la URL /posts.
    span := tracer.StartSpan("web.request", tracer.ResourceName("/posts"))
    defer span.Finish()

    // Anexa información del tramo a mensajes de log:
    log.Printf("my log message %v", span)
}

El ejemplo anterior ilustra cómo utilizar el contexto del tramo en el paquete log de la biblioteca estándar. Una lógica similar puede aplicarse también a paquetes de terceros.

Nota: Si no estás utilizando una integración de log de Datadog para analizar tus logs, las reglas personalizadas de parseo de log, deben asegurarse de que dd.trace_id, dd.span_id, dd.service, dd.env y dd.version se analizan como cadenas. Encontrarás más información en Los logs correlacionados no aparecen en el panel de ID de traza.

Inyección en logs de logrus

Hay disponible un hook para el paquete de logrus para vincular automáticamente tus logs y tramos. El paquete está disponible en el rastreador de Go.

package main

import (
    "github.com/sirupsen/logrus"

    dd_logrus "gopkg.in/DataDog/dd-trace-go.v1/contrib/sirupsen/logrus"
    "gopkg.in/DataDog/dd-trace-go.v1/ddtrace/tracer"
)

func main() {
    // Opcional: Cambia el formato de log para usar JSON (Cf. Go Log Collection)
    logrus.SetFormatter(&logrus.JSONFormatter{})

    // Añade un hook de log de contexto de Datadog
    logrus.AddHook(&dd_logrus.DDContextLogHook{}) 

    // ...
}

Esto inyecta automáticamente el ID de traza a tus logs cuando logueas con el contexto.

    // Loguear con el contexto
    logrus.WithContext(ctx).Info("Go logs and traces connected!")

Lectura adicional

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

Instrumenta tu aplicación de forma manual para crear trazas.DOCUMENTACIÓN more more Explora tus servicios, recursos y trazasDOCUMENTACIÓN more more Correlacionar automáticamente logs de solicitud con trazasBLOG more more Facilita la solución de problemas con una correlación entre productos.GUÍA more more