Class DatadogLogCorrelation

java.lang.Object
codes.grow.packages.datadogapm.DatadogLogCorrelation

public final class DatadogLogCorrelation extends Object
Datadog log correlation (DECISIONS.md #3). Same field format as ddtrace's log injection: dd.trace_id is 32 lower-case hex for a 128-bit id and the decimal low 64 bits for a 64-bit id; dd.span_id is decimal.
  • Field Details

  • Method Details

    • setDatadogLogDefaults

      public static void setDatadogLogDefaults(String service, String env, String version)
      Sets the service/env/version datadogLogFields() uses when the current span carries no resource. DatadogTracing.initTracing() calls it with its effective config; call it yourself when spans come from another tracer provider.
      Parameters:
      service - default service or null
      env - default env or null
      version - default version or null
    • datadogLogFields

      public static Map<String,String> datadogLogFields()
      datadogLogFields(String, String, String) without explicit values.
      
       logger.info("checkout done {}", DatadogLogCorrelation.datadogLogFields());
       
      Returns:
      fields; keys are absent when unknown
    • datadogLogFields

      public static Map<String,String> datadogLogFields(String service, String env, String version)
      The Datadog log correlation fields for the current span, ready to merge into any structured log record (for example SLF4J MDC): dd.trace_id, dd.span_id, dd.service, dd.env, dd.version. Service, env and version come from the arguments, else the current span's resource (service.name, deployment.environment.name, service.version), else the last DatadogTracing.initTracing() config. Without a valid span only the service fields are returned.
      Parameters:
      service - explicit service or null
      env - explicit env or null
      version - explicit version or null
      Returns:
      fields; keys are absent when unknown