Crate grapsus_common 

Common utilities and shared components for Grapsus proxy

This crate provides shared functionality used across all Grapsus components, including observability (metrics, logging, tracing), error types, and common utilities.

Module Organization

• ids: Type-safe identifier newtypes (CorrelationId, RequestId, etc.)
• types: Common type definitions (ByteSize, Priority, etc.)
• errors: Error types and result aliases
• limits: Resource limits and rate limiting
• observability: Metrics, logging, and tracing (runtime only)
• circuit_breaker: Circuit breaker state machine (runtime only)
• registry: Generic type-safe registry abstraction (runtime only)

Re-exports

pub use observability::init_tracing;

pub use observability::AuditLogEntry;

pub use observability::ComponentHealth;

pub use observability::ComponentHealthTracker;

pub use observability::HealthStatus;

pub use observability::RequestMetrics;

pub use errors::GrapsusError;

pub use errors::GrapsusResult;

pub use limits::Limits;

pub use limits::RateLimiter;

pub use ids::AgentId;

pub use ids::CorrelationId;

pub use ids::QualifiedId;

pub use ids::RequestId;

pub use ids::RouteId;

pub use ids::Scope;

pub use ids::UpstreamId;

pub use types::CircuitBreakerConfig;

pub use types::TraceIdFormat;

pub use inference::ColdModelAction;

pub use inference::InferenceProbeConfig;

pub use inference::InferenceReadinessConfig;

pub use inference::ModelStatusConfig;

pub use inference::QueueDepthConfig;

pub use inference::WarmthDetectionConfig;

pub use circuit_breaker::CircuitBreaker;

pub use registry::Registry;

pub use scoped_registry::ScopedRegistry;

pub use scoped_metrics::ScopeLabels;

pub use scoped_metrics::ScopedMetrics;

pub use budget::BudgetAlert;

pub use budget::BudgetCheckResult;

pub use budget::BudgetPeriod;

pub use budget::CostAttributionConfig;

pub use budget::CostResult;

pub use budget::ModelPricing;

pub use budget::TenantBudgetStatus;

pub use budget::TokenBudgetConfig;

Modules

budget

Token budget management and cost attribution types.

circuit_breaker

Circuit breaker implementation for resilient service protection

errors

Error types for Grapsus proxy

ids

Type-safe identifier newtypes for Grapsus proxy.

inference

Inference health check configuration types

limits

Limits and rate limiting for Grapsus proxy

observability

Observability module for Grapsus proxy

registry

Generic registry for thread-safe storage of named components.

scoped_metrics

Scope-aware metrics for namespaced configurations.

scoped_registry

Scoped registry for hierarchical component storage.

types

Common type definitions for Grapsus proxy.

Type Aliases

HealthCheckerDeprecated