Correlated Logs Are Not Showing Up In The Trace ID Panel

Overview

The trace panel contains information about the trace, host, and correlated logs.

A trace page showing an empty log section

There are four types of logs that appear in a trace:

  • trace_id: Display logs that have the corresponding trace ID.
  • host: Display logs from the trace’s host within the trace’s timeframe.
  • container_id: Display logs from the trace’s container within the trace’s timeframe.
  • pod_name: Display logs from the trace’s pod within the trace’s timeframe.
A trace's log dropdown menu showing the trace ID and host options

In some cases, the Logs section in the trace panel may appear empty. This guide walks you through how to fix this issue.

Infrastructure options

If the Log section is empty for the host, container_id, or pod_name options, navigate to the Log Explorer and ensure the following conditions:

  1. Logs are being sent from the host/container/pod that emitted the trace.
  2. There are logs for that host within the trace’s timeframe.
  3. The logs’ timestamp is properly set. For more information, see Logs Not Showing Expected Timestamp.

Trace ID option

If the Log section is empty for the trace_id option, ensure you have a standard trace_id attribute in your logs. If your logs do not contain trace_id, correlate your traces and logs in order to do the following:

  1. Extract the trace ID in a log attribute.

  2. Remap this attribute to the reserved trace_id attribute.

    For JSON logs, Step 1 and 2 are automatic. The tracer injects the trace and span IDs into the logs, which are automatically remapped by the reserved attribute remappers.

    If this process is not working as expected, ensure the logs attribute’s name containing the trace ID is dd.trace_id and verify that the attribute is correctly set in the reserved attributes’ Trace ID section.

     <div class="shortcode-wrapper shortcode-img expand"><figure class="text-center"><a href="https://datadog-docs-staging.imgix.net/images/tracing/troubleshooting/trace_id_reserved_attribute_mapping.bf8ead6e5722342da25c5315aec7bb68.png?fit=max&amp;auto=format" class="pop" data-bs-toggle="modal" data-bs-target="#popupImageModal"><picture class=""  >
             <img 
                 class="img-fluid" 
                 srcset="https://datadog-docs-staging.imgix.net/images/tracing/troubleshooting/trace_id_reserved_attribute_mapping.bf8ead6e5722342da25c5315aec7bb68.png?auto=format" 
                  alt="The preprocessing for JSON logs page with the Trace Id section highlighted"  />
           </picture></a></figure>
     </div>
    

    For raw logs (where you are collecting the logs using a log integration for a specific language), set the source attribute to the language, such as java, python, ruby, and more. The integration automatically correlates traces and logs.

    This example demonstrates the Java integration pipeline:

     <div class="shortcode-wrapper shortcode-img expand"><figure class="text-center"><a href="https://datadog-docs-staging.imgix.net/images/tracing/troubleshooting/tracing_java_traceid_remapping.9aea4d2194cba4e077d724709744026d.png?fit=max&amp;auto=format" class="pop" data-bs-toggle="modal" data-bs-target="#popupImageModal"><picture class=""  style="width:90%;"  >
             <img 
                 class="img-fluid" 
                 srcset="https://datadog-docs-staging.imgix.net/images/tracing/troubleshooting/tracing_java_traceid_remapping.9aea4d2194cba4e077d724709744026d.png?auto=format" 
                 style="width:90%;"  alt="The Java log pipeline with the Trace Id remapper highlighted"  />
           </picture></a></figure>
     </div>
    

    It is possible that the log format is not recognized by the integration pipeline. In this case, clone the pipeline and follow the parsing troubleshooting guide to make sure the pipeline accepts the log format.

    For raw logs where you aren’t using an integration to collect the logs:

    1. Make sure that the custom parsing rule extracts the trace and span IDs as a string, like in the following example:

      A custom parser with the trace Id highlighted in the sample log, parsing rule, and extraction sections
    2. Then define a Trace remapper on the extracted attribute to remap it to the official trace ID of the logs.

Once the IDs are properly injected and remapped to your logs, you can see the logs correlated to the trace in the trace panel.

A trace page showing the logs section with correlated logs

Note: Trace IDs and span IDs are not displayed in your logs or log attributes in the UI.

Further Reading

PREVIEWING: may/unit-testing