#gelf #log #graylog #logging

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

#1 in #gelf

Download history 156/week @ 2021-08-10 77/week @ 2021-08-17 99/week @ 2021-08-24 57/week @ 2021-08-31 27/week @ 2021-09-07 31/week @ 2021-09-14 45/week @ 2021-09-21 41/week @ 2021-09-28 66/week @ 2021-10-05 37/week @ 2021-10-12 52/week @ 2021-10-19 37/week @ 2021-10-26 52/week @ 2021-11-02 43/week @ 2021-11-09 48/week @ 2021-11-16 70/week @ 2021-11-23

228 downloads per month
Used in throttle-server

MIT license

62KB
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

~2.5–4MB
~74K SLoC