Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Architectural Characteristics

Orion provides production-grade capabilities across eight architectural dimensions. Each subcategory below links to its detailed documentation.

C Creational · S Structural · B Behavioral

Click a node to expand its capabilities. Click any leaf node to jump to its documentation.


Observability — S

AreaCapabilities
Structured LoggingJSON & pretty-print formats · Configurable log levels · Per-request context · Per-crate filtering
Prometheus MetricsRequest counters & error rates · Latency histograms · Circuit breaker metrics · Rate limit rejections
Distributed TracingW3C Trace Context · OpenTelemetry OTLP export · Configurable sampling rate · Per-task span tracking
Health MonitoringComponent-level health checks · Automatic degradation · Request ID propagation · Kubernetes liveness & readiness probes

Resilience — S

AreaCapabilities
Circuit BreakersLock-free state machine · Per-connector isolation · Auto-recovery after cooldown · Admin API to inspect & reset
Retry & BackoffExponential backoff (capped 60 s) · Configurable max retries · Retryable error detection
TimeoutsPer-channel enforcement · Workflow execution limits · Per-connector query timeout
Fault ToleranceGraceful shutdown (SIGTERM/SIGINT) · Connection draining · Dead letter queue with retry · Panic recovery middleware

Security — B

AreaCapabilities
Secret ManagementAuto-masked API responses · Credential isolation via connectors
Input ValidationPer-channel JSONLogic rules · Payload size limits · Header & query param access
Network SecuritySSRF protection (private IP blocking) · TLS/HTTPS support · Security headers (CSP, X-Frame-Options)
Access ControlAdmin API authentication · Per-channel CORS enforcement · Origin allowlist
Data SafetyParameterized SQL queries · Injection protection · URL validation

Scalability — C

AreaCapabilities
Rate LimitingToken bucket algorithm · Per-client keying via JSONLogic · Platform & per-channel limits
BackpressureSemaphore concurrency limits · 503 load shedding · Per-channel configuration
Async ProcessingMulti-worker trace queue · Bounded buffer channels · DLQ retry processor
Horizontal ScalingStateless instances · Channel include/exclude filters · Multi-database backends

Deployability — C

AreaCapabilities
PackagingSingle binary · SQLite, PostgreSQL, MySQL · Minimal footprint
ContainerizationMulti-stage Docker build · Non-root execution · Built-in health probes
ConfigurationTOML + env var overrides · Sensible defaults · Runtime configuration
DistributionHomebrew tap · Shell & PowerShell installers · Multi-platform binaries

Extensibility — S

AreaCapabilities
ConnectorsHTTP & Webhooks · Kafka pub/sub · Database (SQL) · Cache (Memory & Redis) · Storage (S3/GCS) · MongoDB (NoSQL)
Custom FunctionsAsync function handlers · Built-in function library · JSONLogic expressions
Channel ProtocolsREST with route matching (sync) · Simple HTTP (sync) · Kafka (async)

Availability — C

AreaCapabilities
Hot-ReloadZero-downtime engine swap · Channel registry rebuild · Kafka consumer restart
Canary RolloutsPercentage-based traffic split · Gradual migration · Instant rollback
VersioningDraft / Active / Archived lifecycle · Multi-version history · Workflow import & export
PerformanceResponse caching · Request deduplication · Connection pool caching

Maintainability — B

AreaCapabilities
Admin APIsFull CRUD for all entities · Version management · Engine control · OpenAPI / Swagger UI
CI/CD IntegrationBulk import & export · Pre-deploy validation · GitOps-friendly
TestingDry-run execution · Workflow validation · Step-by-step traces
OperationsAudit logging · Database backup & restore · Config validation CLI