datadog.opentracing.LogHandler Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of dd-trace-ot Show documentation

dd-trace-ot

The newest version!

package datadog.opentracing;

import datadog.trace.bootstrap.instrumentation.api.AgentSpan;
import java.util.Map;

public interface LogHandler {

  /**
   * Handles the log implementation in the Span.
   *
   * @param fields key:value log fields. Tracer implementations should support String, numeric, and
   *     boolean values; some may also support arbitrary Objects.
   * @param span from which the call was made
   */
  void log(Map fields, AgentSpan span);

  /**
   * Handles the log implementation in the Span.
   *
   * @param timestampMicroseconds The explicit timestamp for the log record. Must be greater than or
   *     equal to the Span's start timestamp.
   * @param fields key:value log fields. Tracer implementations should support String, numeric, and
   * @param span from which the call was made
   */
  void log(long timestampMicroseconds, Map fields, AgentSpan span);

  /**
   * Handles the log implementation in the Span..
   *
   * @param event the event value; often a stable identifier for a moment in the Span lifecycle
   * @param span from which the call was made
   */
  void log(String event, AgentSpan span);

  /**
   * Handles the log implementation in the Span.
   *
   * @param timestampMicroseconds The explicit timestamp for the log record. Must be greater than or
   *     equal to the Span's start timestamp.
   * @param event the event value; often a stable identifier for a moment in the Span lifecycle
   * @param span from which the call was made
   */
  void log(long timestampMicroseconds, String event, AgentSpan span);
}