# s-structured-log
s-structured-log is a JSON logging library for Rust.
This library consists of two parts, the [log](https://crates.io/crates/log) frontend wapper macros (`s_info!`, `s_warn!`, etc) and the `JsonLogger` that is implemented the `Log` trait.
## Document
* [s-structured-log](http://siphilia.github.io/s-structured-log-rs/doc/s_structured_log)
## Basic usage
```toml
...
[dependencies]
log = "*"
s_structured_log = "*"
serde_json = "*"
```
```rust
#[macro_use]
extern crate log;
#[macro_use]
extern crate s_structured_log;
extern crate serde_json;
use s_structured_log::{JsonLogger, LoggerOutput, q};
fn main() {
JsonLogger::init(LoggerOutput::Stdout, log::LogLevelFilter::Info);
s_debug!(json_object! {
"debug_key1" => 1,
"debug_key2" => "value2"
});
s_info!(json_object! {
"info_key1" => 1,
"info_key2" => "value2"
});
s_error!(json_object! {
"error_key1" => 1,
"error_key2" => "value2"
});
}
```
## More complicated example
```rust
#[macro_use]
extern crate log;
#[macro_use]
extern crate s_structured_log;
extern crate serde_json;
use s_structured_log::{JsonLogger, LoggerOutput, q};
fn main() {
JsonLogger::init(LoggerOutput::Stderr, log::LogLevelFilter::Info);
// use json_object!
s_info!(json_object! {
"Fruits" => json_object! {
"on_the_table" => json_object! {
"Apple" => 1,
"Orange" => "two",
"Grape" => 1.2
},
"in_the_basket" => ["Banana", "Strawberry"]
},
"Pets" => [
json_object! {
"name" => "Tama",
"kind" => "cat",
"age" => 3
},
json_object! {
"name" => "Pochi",
"kind" => "dog",
"age" => 5
}
]
});
// use json_format! and target with `json:` prefix.
info!(target: &format!("json:{}", module_path!()),
"{}",
json_format! {
"Fruits" => json_format! {
"on_the_table" => json_format! {
"Apple" => 1,
"Orange" => q("two"),
"Grape" => 1.2
},
"in_the_basket" => json_format![q("Banana"), q("Strawberry")]
},
"Pets" => json_format![
json_format! {
"name" => q("Tama"),
"kind" => q("cat"),
"age" => 3
},
json_format! {
"name" => q("Pochi"),
"kind" => q("dog"),
"age" => 5
}
]
});
// use json_format! and default target.
info!("{}",
json_format! {
"Fruits" => json_format! {
"on_the_table" => json_format! {
"Apple" => 1,
"Orange" => 2,
"Grape" => 1.2
},
"in_the_basket" => json_format![q("Banana"), q("Strawberry")]
},
"Pets" => json_format![
json_format! {
"name" => q("Tama"),
"kind" => q("cat")
},
json_format! {
"name" => q("Pochi"),
"kind" => q("dog")
}
]
});
}
```
## License
* [Apache-2.0](LICENSE)