18 stable releases (6 major)

Uses old Rust 2015

6.1.0 Apr 26, 2023
6.0.1 Dec 19, 2021
5.0.0 Nov 1, 2019
4.0.1 Aug 27, 2018
0.0.1 Jan 18, 2015

#46 in Unix APIs

Download history 14576/week @ 2023-11-21 20592/week @ 2023-11-28 16038/week @ 2023-12-05 17529/week @ 2023-12-12 15713/week @ 2023-12-19 7955/week @ 2023-12-26 15541/week @ 2024-01-02 18174/week @ 2024-01-09 18792/week @ 2024-01-16 19410/week @ 2024-01-23 19040/week @ 2024-01-30 18078/week @ 2024-02-06 18914/week @ 2024-02-13 19030/week @ 2024-02-20 17818/week @ 2024-02-27 16300/week @ 2024-03-05

74,960 downloads per month
Used in 73 crates (58 directly)

MIT license

31KB
669 lines

Sending to Syslog in Rust

Build Status Coverage Status

A small library to write to local syslog.

Installation

syslog is available on crates.io and can be included in your Cargo enabled project like this:

[dependencies]
syslog = "^6.0"

documentation

Reference documentation is available here.

Example

extern crate syslog;

use syslog::{Facility, Formatter3164};

fn main() {
  let formatter = Formatter3164 {
    facility: Facility::LOG_USER,
    hostname: None,
    process: "myprogram".into(),
    pid: 42,
  };

  match syslog::unix(formatter) {
    Err(e)         => println!("impossible to connect to syslog: {:?}", e),
    Ok(mut writer) => {
      writer.err("hello world").expect("could not write error message");
    }
  }
}

The struct syslog::Logger implements Log from the log crate, so it can be used as backend for other logging systems:

extern crate syslog;
#[macro_use]
extern crate log;

use syslog::{Facility, Formatter3164, BasicLogger};
use log::{SetLoggerError, LevelFilter};

fn main() {
    let formatter = Formatter3164 {
        facility: Facility::LOG_USER,
        hostname: None,
        process: "myprogram".into(),
        pid: 0,
    };

    let logger = syslog::unix(formatter).expect("could not connect to syslog");
    log::set_boxed_logger(Box::new(BasicLogger::new(logger)))
            .map(|()| log::set_max_level(LevelFilter::Info));

    info!("hello world");
}

There are 3 functions to create loggers:

  • the unix function sends to the local syslog through a Unix socket: syslog::unix(formatter)
  • the tcp function takes an address for a remote TCP syslog server: tcp(formatter, "127.0.0.1:4242")
  • the udp function takes an address for a local port, and the address remote UDP syslog server: udp(formatter, "127.0.0.1:1234", "127.0.0.1:4242")

Dependencies

~0.8–1.1MB
~18K SLoC