Class BetterStackEvents

java.lang.Object
codes.grow.packages.betterstack.BetterStackEvents

public final class BetterStackEvents extends Object
Maps LogRecords to Better Stack events and encodes request bodies (JSON, NDJSON, MessagePack).
  • Method Details

    • toEvent

      public static Map<String,Object> toEvent(LogRecord record)
      Maps a record to the Better Stack event shape (the JSON stored in the raw column): {dt, message, level, severity_number, span: {trace_id, span_id}, trace_flags, resource, attributes, observed_dt}. span.trace_id/span.span_id are Better Stack's log to trace correlation fields. dt and observed_dt are Instants until encoded; empty resource/attributes are left out.
      Parameters:
      record - record
      Returns:
      a mutable event map
    • formatTimestamp

      public static String formatTimestamp(Instant t)
      Formats an instant as RFC 3339 UTC with up to nanosecond digits ( 2026-11-18T21:00:00.123456789Z).
      Parameters:
      t - instant
      Returns:
      the text
    • eventJson

      public static String eventJson(Map<String,?> event)
      JSON text of one event (Instant values become RFC 3339 UTC strings).
      Parameters:
      event - event
      Returns:
      compact JSON
    • encode

      public static byte[] encode(List<? extends Map<String,?>> events, IngestEncoding encoding)
      Encodes events as one request body: JSON a JSON array, NDJSON one object per line, MSGPACK a MessagePack array with Instant values as timestamp extensions.
      Parameters:
      events - events
      encoding - body encoding
      Returns:
      the body