Class LogRecord.Builder

java.lang.Object
codes.grow.packages.betterstack.logging.LogRecord.Builder
Enclosing class:
LogRecord

public static final class LogRecord.Builder extends Object
Builder for LogRecord.
  • Method Details

    • timestamp

      public LogRecord.Builder timestamp(Instant timestamp)
      Sets the event time.
      Parameters:
      timestamp - event time
      Returns:
      this builder
    • observedTimestamp

      public LogRecord.Builder observedTimestamp(Instant observedTimestamp)
      Sets the observed time.
      Parameters:
      observedTimestamp - observed time (may be null)
      Returns:
      this builder
    • severity

      public LogRecord.Builder severity(Severity severity)
      Sets the severity; the severity text follows unless set explicitly.
      Parameters:
      severity - severity
      Returns:
      this builder
    • severityText

      public LogRecord.Builder severityText(String severityText)
      Sets a vendor severity text (defaults to the severity name).
      Parameters:
      severityText - text (may be null)
      Returns:
      this builder
    • body

      public LogRecord.Builder body(String body)
      Sets the message.
      Parameters:
      body - message (null becomes empty)
      Returns:
      this builder
    • attributes

      public LogRecord.Builder attributes(Map<String,?> attributes)
      Replaces all attributes.
      Parameters:
      attributes - attributes (may be null)
      Returns:
      this builder
    • attribute

      public LogRecord.Builder attribute(String key, Object value)
      Adds one attribute.
      Parameters:
      key - name
      value - attribute value
      Returns:
      this builder
    • resource

      public LogRecord.Builder resource(Map<String,?> resource)
      Replaces all resource attributes.
      Parameters:
      resource - resource attributes (may be null)
      Returns:
      this builder
    • traceId

      public LogRecord.Builder traceId(String traceId)
      Sets the trace id (32 hex; upper case is accepted, 16 hex is left-padded).
      Parameters:
      traceId - trace id or null
      Returns:
      this builder
    • spanId

      public LogRecord.Builder spanId(String spanId)
      Sets the span id (16 hex).
      Parameters:
      spanId - span id or null
      Returns:
      this builder
    • traceFlags

      public LogRecord.Builder traceFlags(Integer traceFlags)
      Sets the W3C trace flags (0–255).
      Parameters:
      traceFlags - flags or null
      Returns:
      this builder
    • build

      public LogRecord build()
      Builds the record.
      Returns:
      the record
      Throws:
      ValidationException - when a trace id, span id or trace flags value is invalid