[−][src]Crate tracing_gelf
Provides Graylog structured logging using the tracing
.
Usage
use std::net::SocketAddr; use tracing_gelf::Logger; #[tokio::main] async fn main() { // Graylog address let address: SocketAddr = "127.0.0.1:12202".parse().unwrap(); // Start tracing let bg_task = Logger::builder().init_tcp(address).unwrap(); // Spawn background task // Any futures executor can be used tokio::spawn(bg_task); // Send a log to Graylog tracing::info!(message = "our dreams feel real while we're in them"); // Create a span let span = tracing::info_span!("level 1"); span.in_scope(|| { // Log inside a span tracing::warn!(message = "we need to go deeper"); // Create an nested span let inner_span = tracing::info_span!("level 5"); inner_span.in_scope(|| { // Log inside nested span tracing::error!(message = "you killed me"); }); }); // Log a structured log tracing::info!(message = "he's out", spinning_top = true); // Don't exit loop {} }
GELF Encoding
Events
are encoded into GELF format
as follows:
Event
fields are inserted asGELF
additional fields,_field_name
.Event
field namedmessage
is renamed toshort_message
.- If
short_message
(ormessage
)Event
field is missing itshort_message
is set to the empty string. Event
fields whose names collide withGELF
required fields are coerced into the required types and overrides defaults given in the builder.- The hierarchy of spans is concatenated and inserted as
span_a::span_b::span_c
and inserted as an additional field_span
.
Structs
Builder | A builder for |
Logger |
|
Enums
BuilderError | The error type for |