#logging #log #graylog

gelf

A library for logging GELF messages to a Graylog compatible server

7 releases (4 breaking)

0.5.0 Feb 6, 2020
0.4.0 Jul 29, 2019
0.3.1 Nov 16, 2018
0.3.0 Oct 23, 2018
0.1.0 Feb 17, 2017

#2 in #graylog

48 downloads per month

MIT license

63KB
1K SLoC

GELF for Rust (gelf)

Crates.io Build Status

A GELF implementation for Rust (Documentation)

TODO: What's GELF?

  • Link Graylog
  • Link GELF spec

TODO: What's this library?

TODO: GELF example usecases

Features

TODO: ::log-integration, list of backends, conversion of error levels

Install

To make use of GELF for Rust, simply add it as a dependency in your Cargo.toml. Check for the latest version at cargo.io:

[dependencies]
gelf = "a.b.c"

If you installed cargo-edit you can easily add the latest version by running:

cargo add gelf

Finally add the crate to your application:

extern crate gelf;

Examples & use

Two introductory examples (for both standalone and log-integrated uses) can be found in the crate's documentation.

Additional examples covering different backends and other advanced uses can be found in /examples. Every one of those can be run with ´cargo´, e.g.:

cargo run --example simple_udp

Documentation

The documentation is available at https://docs.rs/gelf and will get built automatically for every crate version.

License

GELF for rust (gelf) is licensed under the MIT-License.

Contact & Contributing

Contributions are very welcome. I will lay out a guide for contributions in a CONTRIBUTING.md. Until then you are invited to PR/issue as you like :-)

If you have any questions, feel free to contact me by mail, Twitter or on IRC. I'll usually idle as bzikarsky on freenode in #graylog.

TODO: CONTRIBUTING.md

Dependencies

~3.5–5.5MB
~99K SLoC