13 releases (7 breaking)

0.9.0 Jul 15, 2022
0.8.0 Jan 28, 2022
0.7.0 Sep 25, 2020
0.6.1 Jan 19, 2019
0.2.0 Feb 23, 2016

#1455 in Encoding

Download history 4/week @ 2023-11-20 15/week @ 2023-11-27 51/week @ 2023-12-04 16/week @ 2023-12-11 32/week @ 2023-12-18 1/week @ 2024-01-01 7/week @ 2024-01-15 96/week @ 2024-01-22 7/week @ 2024-01-29 16/week @ 2024-02-05 16/week @ 2024-02-12 6/week @ 2024-02-19 46/week @ 2024-02-26 13/week @ 2024-03-04

81 downloads per month
Used in rsyslog

ISC license

44KB
949 lines

This module implements an RFC 5424 IETF Syslog Protocol parser in Rust.

CI Documentation crates.io

This tool supports serializing the parsed messages using serde if it's built with the serde-serialize feature.

This library is licensed under the ISC license, a copy of which can be found in LICENSE.txt

The minimum supported Rust version for this library is 1.34.

Performance

On a recent system1, a release build takes approximately 8µs to parse an average message and approximately 300ns to parse the smallest legal message. Debug timings are a bit worse -- about 60µs for an average message and about 8µs for the minimal message. A single-threaded Syslog server should be able to parse at least 100,000 messages/s, as long as you run a separate thread for the parser.

This compares very favorably to python syslog-rfc5424-parser2, which takes about 300µs for a minimal message, and more than 700µs for an average message.

Footnotes

  • 1: An Intel i7-4850HQ in a 2013 rMBP
  • 2: Which I also wrote

Dependencies

~1–1.7MB
~36K SLoC