32 releases

0.5.6 Jul 11, 2023
0.5.4 Mar 9, 2023
0.5.1 Jul 20, 2022
0.5.0 Jan 12, 2022
0.1.2 Dec 21, 2018

#96 in Compression

Download history 39/week @ 2023-12-11 21/week @ 2023-12-18 20/week @ 2024-01-01 85/week @ 2024-01-08 27/week @ 2024-01-15 14/week @ 2024-02-19 106/week @ 2024-02-26 30/week @ 2024-03-04 83/week @ 2024-03-11 57/week @ 2024-03-18 136/week @ 2024-03-25

308 downloads per month

Custom license

26KB
528 lines

compressed_log

Latest Version Documentation

A Rust crate to compress logs on the fly, and send them over the network after reaching a configured threshold.

This is useful for when you have a fleet of embedded devices running a Rust program, instead of building a complicated metrics framework you can collect the normal Rust log output securely using https and efficiently using Deflate compression.

The pure rust backend of LibFlate2 is used with only a 100kb in memory buffer. Using the 'fast' compression setting the average compression ratio in our tests is ~25 without any noticible cpu impact on even embedded MIPS processors.

Right now compressed_log pulls in the full Actix suite to handle futures and async requests. We hope to transition it to native futures and dramaticly reudce the dependency tree once they become more mature.

On the server side logs are simply dumped into a file, where they can be aggregated and processed by standard log collection tools.

Features

  • Uses log API
  • LieFlate2 to compress log on the fly
  • Configurable threshold which will trigger in-memory log rotation and data transmission.
  • Fully architecture portable, including Mips and other BE architectures

Example

Check out examples folder for more examples. Including custom formats for collected logs.

Client:

let level = Level::Info;
let logger = LoggerBuilder::new()
    .set_level(level)
    .set_compression_level(Compression::Slow)
    .set_sink_url("http://127.0.0.1:8000/sink/")
    .build()?;
log::set_boxed_logger(Box::new(logger))?;
log::set_max_level(level.to_level_filter());

Server:

The current server reference implementaiton is compressed_log_sink

Dependencies

~19–31MB
~528K SLoC