queuerious 0.1.0

Rust SDK for Queuerious job queue observability platform
Documentation

queuerious

Rust SDK for the Queuerious job queue observability platform.

Report job lifecycle events (started, completed, failed, retrying, dead-lettered) from your Rust applications to Queuerious for real-time monitoring, alerting, and debugging.

Installation

[dependencies]
queuerious = "0.1"

Optional features

Feature Description
tower Tower middleware for automatic job tracking
metrics Queue metrics collection
commands Remote command execution support
agent Full agent mode (enables metrics + commands)
# Example: enable Tower middleware
queuerious = { version = "0.1", features = ["tower"] }

Quick start

use queuerious::{QueuriousClient, JobEvent, Backend};

#[tokio::main]
async fn main() -> Result<(), queuerious::QueuriousError> {
    let client = QueuriousClient::builder()
        .api_key("qk_your_api_key")
        .endpoint("https://api.queuerious.dev")
        .build()?;

    // Report a job started event (non-blocking, batched)
    client.report(
        JobEvent::started("email-queue", Backend::RabbitMQ, "job-123", "SendEmail")
            .payload(serde_json::json!({"to": "user@example.com"}))
            .build()
    )?;

    // Gracefully shut down (flushes pending events)
    client.shutdown().await?;
    Ok(())
}

Queue backend adapters

For automatic lifecycle tracking with specific queue backends, use one of the adapter crates:

License

Licensed under either of

at your option.