java.lang.Object
codes.grow.packages.datadogapm.tracing.query.TraceJson

public final class TraceJson extends Object
Converts Trace and Span to and from the normalized JSON form ( spec/schemas/trace.schema.json): integer startMicros/endMicros/ durationMicros, status as {code, message?}, events as {name, timeMicros, attributes}.
  • Method Details

    • toMap

      public static Map<String,Object> toMap(Trace trace)
      Wire form of a trace.
      Parameters:
      trace - trace
      Returns:
      ordered map
    • toMap

      public static Map<String,Object> toMap(Span span)
      Wire form of a span.
      Parameters:
      span - span
      Returns:
      ordered map
    • toJson

      public static String toJson(Trace trace)
      Serialises a trace.
      Parameters:
      trace - trace
      Returns:
      JSON text
    • toJson

      public static String toJson(Span span)
      Serialises a span.
      Parameters:
      span - span
      Returns:
      JSON text
    • traceFromJson

      public static Trace traceFromJson(String json)
      Parses a trace.
      Parameters:
      json - JSON text
      Returns:
      trace
      Throws:
      ValidationException - for invalid JSON or fields
    • spanFromJson

      public static Span spanFromJson(String json)
      Parses a span.
      Parameters:
      json - JSON text
      Returns:
      span
      Throws:
      ValidationException - for invalid JSON or fields
    • spanFromJson

      public static Span spanFromJson(com.fasterxml.jackson.databind.JsonNode node)
      Parses a span from a Jackson tree.
      Parameters:
      node - JSON object
      Returns:
      span
      Throws:
      ValidationException - for invalid fields
    • timestamp

      public static String timestamp(long micros)
      Formats epoch microseconds as RFC 3339 UTC.
      Parameters:
      micros - microseconds since the epoch
      Returns:
      timestamp text
    • micros

      public static long micros(String text)
      Parses an RFC 3339 timestamp into epoch microseconds.
      Parameters:
      text - timestamp
      Returns:
      microseconds
      Throws:
      ValidationException - when the text is not a timestamp