# witness

[![Package Version](https://img.shields.io/hexpm/v/witness)](https://hex.pm/packages/witness)
[![Hex Docs](https://img.shields.io/badge/hex-docs-ffaff3)](https://hexdocs.pm/witness/)

```sh
gleam add witness@1 logging@1
```
```gleam
import gleam/io
import logging
import witness

pub fn main() -> Nil {
  configure_logging()

  // log a message
  witness.this(logging.Info, "Some log message", [
    witness.string("example", "you can add structured data"),
    witness.bool("also_bools", True),
    witness.float("and_floats", 1.23),
    witness.int("ints_as_well", 3),
  ])
}

fn configure_logging() {
  // configure erlang logger
  logging.configure()

  // create a new config
  witness.empty_config()
  // log formatted text to stdout
  |> witness.with_sink(witness.Text, fn(level, message) {
    io.println(witness.level_to_short_string(level) <> " " <> message)
  })
  // log json to the erlang logger
  |> witness.with_sink(witness.Json, logging.log)
  // apply this config globally
  |> witness.set_config()
}
```
Will log this to the erlang logger:
```
INFO {"timestamp":"2026-05-28T18:30:40.020522296Z","level":"info","message":"Some log message","example":"you can add structured data","also_bools":true,"and_floats":1.23,"ints_as_well":3}
```
And this to the console:
```
[INFO] 20:30:40 Some log message
  example: you can add structured data
  also_bools: True
  and_floats: 1.23
  ints_as_well: 3
```

Further documentation can be found at <https://hexdocs.pm/witness>.

## Development

```sh
gleam run   # Run the project
gleam test  # Run the tests
```