zerodds-security-logging 1.0.0-rc.1

Security-Logging-Backends fuer DDS-Security 1.1 §8.6: stderr + JSON-lines + RFC-5424-UDP-Syslog + FanOut.
Documentation
  • Coverage
  • 100%
    5 out of 5 items documented0 out of 0 items with examples
  • Size
  • Source code size: 28.94 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 515.36 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 11s Average build duration of successful builds.
  • all releases: 11s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • zero-objects/zero-dds
    2 1 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • SandraK82

zerodds-security-logging

License: Apache-2.0 docs.rs

Security-Logging-Backends fuer den ZeroDDS-Stack: LoggingPlugin-Implementationen fuer stderr, JSON-Lines, Syslog und FanOut. Safety classification: SAFE.

Spec-Mapping

Spec Abschnitt
OMG DDS-Security 1.1 §8.6 (LoggingPlugin)
RFC 5424 Syslog (UDP)

Was ist drin

  • StderrLoggingPlugin — Default fuer Container-Deployments mit stdout/stderr-Collector (Loki, Vector, Fluentd).
  • JsonLinesLoggingPluginapplication/x-ndjson in eine Datei. Rotation via logrotate.
  • SyslogLoggingPlugin — UDP an Syslog-Collector (Facility LOCAL0).
  • FanOutLoggingPlugin — fan-out an mehrere Backends parallel.

Alle Backends filtern Events nach LogLevel; Default-Level Warning.

Schichten-Position

Layer 4. Konsumiert zerodds-security (LoggingPlugin-Trait + LogLevel + SecurityError).

Quickstart

use zerodds_security_logging::{StderrLoggingPlugin, FanOutLoggingPlugin, JsonLinesLoggingPlugin};
use zerodds_security::{LoggingPlugin, LogLevel};

let stderr = StderrLoggingPlugin::new(LogLevel::Warning);
let json = JsonLinesLoggingPlugin::open("/var/log/zerodds/security.jsonl", LogLevel::Informational)
    .expect("open");
let fanout: Box<dyn LoggingPlugin> = Box::new(FanOutLoggingPlugin::new(vec![
    Box::new(stderr),
    Box::new(json),
]));

Nicht-Ziele

  • Syslog-TCP (RFC 5425) und Syslog-TLS — vertrautes Segment vorausgesetzt.
  • OpenTelemetry/OTLP — abgedeckt von zerodds-observability-otlp.
  • Log-Rotation im Plugin — Aufgabe von logrotate/journald.

Stabilitaet

1.0.0-rc.1. Public-API + JSON-Lines-Format + RFC-5424-Encoding RC1-stabil.

Tests

cargo test -p zerodds-security-logging

16 Tests grün.

Lizenz

Apache-2.0.