java.lang.Object
codes.grow.packages.betterstack.logging.Logger

public final class Logger extends Object
Small logging facade on top of a LogClient. Records below the minimum severity (default INFO) are discarded. When an OpenTelemetry span is active, the client adds its trace id, span id and trace flags to every record.
  • Field Details

  • Constructor Details

    • Logger

      public Logger(LogClient client, String name, Map<String,?> attributes, Severity minSeverity)
      Creates a logger.
      Parameters:
      client - destination
      name - logger name (null or empty for none)
      attributes - attributes added to every record
      minSeverity - minimum severity
  • Method Details

    • name

      public String name()
      Logger name.
      Returns:
      name (empty for none)
    • attributes

      public Map<String,Object> attributes()
      Fixed attributes (including logger.name).
      Returns:
      attributes
    • minSeverity

      public Severity minSeverity()
      Minimum severity.
      Returns:
      severity
    • child

      public Logger child(Map<String,?> extra)
      Returns a logger with more fixed attributes (they win over the parent's).
      Parameters:
      extra - attributes
      Returns:
      child logger
    • withMinSeverity

      public Logger withMinSeverity(Severity severity)
      Returns a copy with another minimum severity.
      Parameters:
      severity - minimum severity
      Returns:
      logger
    • isEnabled

      public boolean isEnabled(Severity severity)
      Whether records of this severity are sent.
      Parameters:
      severity - severity
      Returns:
      true when severity >= minSeverity
    • log

      public void log(Severity severity, String message, Map<String,?> extra)
      Logs a message.
      Parameters:
      severity - severity
      message - message
      extra - attributes for this record (may be null)
    • trace

      public void trace(String message)
      Logs at TRACE.
      Parameters:
      message - message
    • trace

      public void trace(String message, Map<String,?> extra)
      Logs at TRACE.
      Parameters:
      message - message
      extra - attributes
    • debug

      public void debug(String message)
      Logs at DEBUG.
      Parameters:
      message - message
    • debug

      public void debug(String message, Map<String,?> extra)
      Logs at DEBUG.
      Parameters:
      message - message
      extra - attributes
    • info

      public void info(String message)
      Logs at INFO.
      Parameters:
      message - message
    • info

      public void info(String message, Map<String,?> extra)
      Logs at INFO.
      Parameters:
      message - message
      extra - attributes
    • warn

      public void warn(String message)
      Logs at WARN.
      Parameters:
      message - message
    • warn

      public void warn(String message, Map<String,?> extra)
      Logs at WARN.
      Parameters:
      message - message
      extra - attributes
    • error

      public void error(String message)
      Logs at ERROR.
      Parameters:
      message - message
    • error

      public void error(String message, Map<String,?> extra)
      Logs at ERROR.
      Parameters:
      message - message
      extra - attributes
    • fatal

      public void fatal(String message)
      Logs at FATAL.
      Parameters:
      message - message
    • fatal

      public void fatal(String message, Map<String,?> extra)
      Logs at FATAL.
      Parameters:
      message - message
      extra - attributes