https://github.com/swsnr/logcontrol.rs

Rust types and implementations for systemd's logcontrol interface.
https://github.com/swsnr/logcontrol.rs

dbus journald logging systemd

Last synced: 3 months ago
JSON representation

Rust types and implementations for systemd's logcontrol interface.

• Host: GitHub
• URL: https://github.com/swsnr/logcontrol.rs
• Owner: swsnr
• License: apache-2.0
• Created: 2023-09-28T06:28:45.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-01T14:41:50.000Z (5 months ago)
• Last Synced: 2024-10-06T15:47:32.139Z (3 months ago)
• Topics: dbus, journald, logging, systemd
• Language: Rust
• Homepage: https://crates.io/crates/logcontrol
• Size: 193 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE-Apache-2.0

Awesome Lists containing this project

README

        
# logcontrol.rs

[![Crates.io](https://img.shields.io/crates/v/logcontrol)](https://crates.io/crates/logcontrol)

[![docs.rs](https://img.shields.io/docsrs/logcontrol)](https://docs.rs/logcontrol)

Types and implementations for systemd's [logcontrol] interface.

This interface provides means to change logging behaviour of system services at runtime, over D-Bus, or via `systemctl service-log-level` or `systemctl service-log-target`.

This repository provides a collection of traits of basic types and implementations of this interface:

- `logcontrol` contains the basic types and defines an abstract trait for the interface.

- [`logcontrol-tracing`](https://github.com/swsnr/logcontrol.rs/tree/main/tracing) provides a logcontrol backend implementation for the [`tracing`][tracing] library.

- [`logcontrol-log`](https://github.com/swsnr/logcontrol.rs/tree/main/log) provides a logcontrol backend implementation for the [`log`][log] library.

- [`logcontrol-zbus`](https://github.com/swsnr/logcontrol.rs/tree/main/zbus) provides a DBus interface implementation for [`zbus`][zbus] DBus framework.

[logcontrol]: https://www.freedesktop.org/software/systemd/man/org.freedesktop.LogControl1.html#

[tracing]: https://github.com/tokio-rs/tracing

[log]: https://github.com/rust-lang/log

[zbus]: https://github.com/dbus2/zbus

## Usage

```console

$ cargo add logcontrol-tracing

$ cargo add logcontrol-zbus

```

```rust

use std::error::Error;

use std::time::Duration;

use logcontrol_tracing::{PrettyLogControl1LayerFactory, TracingLogControl1};

use logcontrol_zbus::{ConnectionBuilderExt, LogControl1};

use tracing::{event, Level};

use tracing_subscriber::prelude::*;

use tracing_subscriber::Registry;

use zbus::ConnectionBuilder;

#[async_std::main]

async fn main() -> Result<(), Box> {

    let (control, control_layer) =

        TracingLogControl1::new_auto(PrettyLogControl1LayerFactory, Level::INFO)?;

    let subscriber = Registry::default().with(control_layer);

    tracing::subscriber::set_global_default(subscriber).unwrap();

    let _conn = ConnectionBuilder::session()?

        .name("com.example.Foo")?

        .serve_log_control(LogControl1::new(control))?

        .build()

        .await?;

    loop {

        async_std::task::sleep(Duration::from_secs(5)).await;

        event!(Level::INFO, "An message at info level");

        async_std::task::sleep(Duration::from_secs(1)).await;

        event!(Level::WARN, "An message at warning level");

    }

}

```

See [tracing-server.rs](https://github.com/swsnr/logcontrol.rs/blob/main/zbus/examples/tracing-server.rs) for a more complete example.