glogg

Types

Field

opaque </>

pub opaque type Field

Level

</>

pub type Level {
  Debug
  Info
  Notice
  Warning
  Error
  Critical
  Alert
  Emergency
}

Constructors

```
Debug
```
```
Info
```
```
Notice
```
```
Warning
```
```
Error
```
```
Critical
```
```
Alert
```
```
Emergency
```

Logger

opaque </>

pub opaque type Logger

Values

add_default_fields

</>

pub fn add_default_fields(
  logger: Logger,
  fields: List(Field),
) -> Logger

Adds additional default fields to an existing logger.

The new fields are appended to the logger’s existing default fields. These fields will be included in every log message produced by the returned logger.

alert

</>

pub fn alert(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Alert level to standard error.

bool

</>

pub fn bool(key: String, value: Bool) -> Field

Creates a boolean field with the given key and value.

configure_default_json_formatting

</>

pub fn configure_default_json_formatting() -> Nil

Configures all loggers to use JSON formatting by default.

configure_default_minimum_level

</>

pub fn configure_default_minimum_level(level: Level) -> Nil

Configures all loggers to use the specified minimum log level by default. Messages below this level will be ignored.

critical

</>

pub fn critical(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Critical level to standard error.

debug

</>

pub fn debug(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Debug level.

duration_ms

</>

pub fn duration_ms(
  key: String,
  duration: duration.Duration,
) -> Field

Creates a duration field in milliseconds with the given key and value.

emergency

</>

pub fn emergency(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Emergency level to standard error.

error

</>

pub fn error(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Error level to standard error.

fields_to_metadata

</>

pub fn fields_to_metadata(
  fields: List(Field),
) -> dict.Dict(String, dynamic.Dynamic)

Converts a list of fields into a metadata dictionary suitable for logging.

float

</>

pub fn float(key: String, value: Float) -> Field

Creates a float field with the given key and value.

get_default_fields

</>

pub fn get_default_fields(logger: Logger) -> List(Field)

Retrieves the default fields of a logger.

group

</>

pub fn group(key: String, fields: List(Field)) -> Field

Creates a group field with the given key and nested fields.

info

</>

pub fn info(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Info level.

int

</>

pub fn int(key: String, value: Int) -> Field

Creates an integer field with the given key and value.

new

</>

pub fn new() -> Logger

Creates a new logger with sensible default settings.

By default, the minimum level is Debug and there are no default fields.

notice

</>

pub fn notice(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Notice level.

stacktrace

</>

pub fn stacktrace() -> Field

Creates a stacktrace field that with the key “stacktrace”.

string

</>

pub fn string(key: String, value: String) -> Field

Creates a string field with the given key and value.

warning

</>

pub fn warning(
  logger: Logger,
  message: String,
  fields: List(Field),
) -> Nil

Logs a message and fields at the Warning level.

with_default_fields

</>

pub fn with_default_fields(
  arg: Logger,
  fields: List(Field),
) -> Logger

Returns a new logger with a set of default fields.

These fields will be included in every log message produced by this logger, in addition to any fields provided at the call site.