tazz4843 / fenrir-rs

Fenrir is a crate for using Loki for log aggregation which can be used with a logging framework like fern.

fenrir-rs

Fenrir (Fenrir was the son of the trickster god Loki and the giantess Angrboða) facilitates collecting and shipping your applications logs to a Loki instance. It does this by integrating with the log crate.

Getting Started

Examples are available for several use-cases, check out the examples folder.

1. Create a new Rust project: cargo new example

2. Add dependencies to this create to your Cargo.toml file:

   [dependencies.fenrir-rs]
   version = "0.5.0"
   features = ["ureq", "json"]

3. Use it 😉

Development and testing

For easier testing and during the development phase, you can use the example docker-compose.yml to start your own instance of Loki locally. Just use docker compose to start the Loki container as well as a local Grafana instance for viewing the messages:

docker compose up -d

After the containers have started, you can visit http://localhost:3000/explore to query messages in your local Loki instance.

Minimum Supported Rust Version (MSRV)

The MSRV for this tool ist 1.60.0.

License

This project is licensed under the MIT License.