Logtail Rust

Logtail rust is an http wrapper for sending logs to betterstack

Environment Variables

Variable	Description
ENVIRONMENT	Can be "local", "qa", "preprod" or "prod"
LOGS_SOURCE_TOKEN	Docs

Usage

Basic usage

let logger = Logger::new(env!("CARGO_PKG_VERSION").to_string(), true);

let log = logtail_rust::LogSchema {
    message: "Server started".to_string(),
    context: format!("{} - {}", file!(), line!()),
};

// Log methods now return Result<(), LogtailError>
logger.info(log).await?;

Builder pattern

use logtail_rust::{Logger, LogSchema};
use std::time::Duration;

let logger = Logger::builder()
    .app_version("1.0.0")
    .verbose(true)
    .max_retries(3)
    .base_delay(Duration::from_millis(200))
    .max_delay(Duration::from_millis(800))
    .jitter(true)
    .build();

logger.info(LogSchema {
    message: "hello".to_string(),
    context: "main".to_string(),
}).await?;

Custom retry config

use logtail_rust::http_client::RetryConfig;
use std::time::Duration;

let retry = RetryConfig {
    max_retries: 3,
    base_delay: Duration::from_millis(500),
    max_delay: Duration::from_millis(3000),
    jitter: true,
};

let logger = Logger::with_retry(retry);

Default (reads from env vars, default retry)

let logger = Logger::default();

Configuration Reference

Logger options

Option	Type	Default	Description
`app_version`	`String`	`CARGO_PKG_VERSION`	Version string included in every log sent to BetterStack
`verbose`	`bool`	`true`	When `true`, logs are also printed to stdout (`info`/`warn`/`debug`) or stderr (`error`) in addition to being sent over HTTP
`environment`	`EnvEnum`	Read from `ENVIRONMENT` env var	One of `Local`, `QA`, `PreProd`, `Prod`. When set to `Local`, HTTP calls are skipped entirely
`logs_source_token`	`String`	Read from `LOGS_SOURCE_TOKEN` env var	BetterStack source token for authentication

Retry options

Option	Type	Default	Description
`max_retries`	`u32`	`3`	Maximum number of retry attempts after the initial call fails
`base_delay`	`Duration`	`1000ms`	Initial delay before the first retry, doubled on each subsequent attempt
`max_delay`	`Duration`	`5000ms`	Upper bound on the backoff delay
`jitter`	`bool`	`true`	Randomize the delay (0 to computed delay) to avoid thundering herd

Retry Behavior

Failed HTTP requests are automatically retried with exponential backoff. Only transient errors are retried:

5xx HTTP errors — retried (server errors)
Network errors — retried (connection failures, timeouts)
4xx HTTP errors — not retried (client errors)
Serialization errors — not retried

Error Handling

All log methods (info, warn, error, debug) return Result<(), LogtailError>. Errors are no longer silently swallowed.

LogtailError variants:

Http { status, message } — HTTP error with status code
Serialization(serde_json::Error) — JSON serialization failure
Network(reqwest::Error) — Network/connection error

Migration from 0.2.x

Breaking: info(), warn(), error(), debug() now return Result<(), LogtailError> instead of ()
Breaking: push_log() now returns Result<Option<Value>, LogtailError> instead of Option<Value>
Add .await? or let _ = to log calls to handle the new return type
tokio with time feature is now a required dependency
New Logger::builder(), Logger::with_retry() constructors available

logtail-rust 0.3.0