How excanear/osiris---operational-system-intelligence-response-investigation-system works
Osiris appears to be an endpoint telemetry and security-operations platform: host sensors produce events, which are intended to be collected, processed, stored, detected and investigated through a web console. The README provides no product description, so this workflow is inferred from module names and the sampled source. The source index confirms the event pipeline’s normalization/enrichment stages and several product areas, but many links between unsampled subsystems remain unverified.
Main entry points: ingest.rs Event ingest · osiris-api REST API · storage.rs Storage interface · osiris-sensors Host sensors
Components 19
Endpoint collection
- Host sensors
crates/osiris-sensors - DNS capture engine
crates/osiris-sensors/dns/src/engine.rs - Endpoint agent
crates/osiris-agent/src/agent.rs - Mutual-TLS transport
crates/osiris-transport/src/server.rs
Ingest and detection
- Event ingest
crates/osiris-server/src/ingest.rs - Event pipeline
crates/osiris-pipeline/src/pipeline.rs - Normalize and enrich
crates/osiris-pipeline - Rule detection
crates/osiris-detect/src/engine.rs - Storage interface
crates/osiris-storage/src/storage.rs - SQLite storage
crates/osiris-storage-sqlite/src/sqlite_storage.rs - ClickHouse storage
crates/osiris-storage-clickhouse/src
Security operations
- REST API
crates/osiris-api - Entity investigation
crates/osiris-investigate - Evidence and incidents
crates/osiris-evidence - Fleet and policy
crates/osiris-fleet
Web console
- Console routing
console/src/App.tsx - Console API client
console/src/api/client.ts - Operations views
console/src/screens
Other components
- Monitored host
Connections 20
- Monitored host → Host sensors: generates telemetry
- Host sensors → Endpoint agent: supplies events
- DNS capture engine → Host sensors: emits DNS events
crates/osiris-sensors/dns/src/engine.rs - Endpoint agent → Mutual-TLS transport: sends batches
- Mutual-TLS transport → Event ingest: hands off batches
crates/osiris-transport/src/server.rs - Event ingest → Event pipeline: processes events
- Event pipeline → Normalize and enrich: uses stages
crates/osiris-pipeline/src/pipeline.rs - Event ingest → Rule detection: evaluates events
- Event ingest → Storage interface: persists events
- Rule detection → Storage interface: stores alerts
- Storage interface → SQLite storage: backend implementation
- Storage interface → ClickHouse storage: backend implementation
- Event ingest → SQLite storage: opens configured backend
- REST API → Storage interface: queries telemetry
- REST API → Entity investigation: serves investigations
- REST API → Evidence and incidents: serves evidence
- REST API → Fleet and policy: serves fleet operations
- Console routing → Operations views: routes to
console/src/App.tsx - Operations views → Console API client: requests data
- Console API client → REST API: calls API