# excanear/osiris---operational-system-intelligence-response-investigation-system architecture

> Architecture diagram of the GitHub repository excanear/osiris---operational-system-intelligence-response-investigation-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/excanear/osiris---operational-system-intelligence-response-investigation-system
- Repository: https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system

## Overview

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: [`crates/osiris-server/src/ingest.rs`](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-server/src/ingest.rs) (Event ingest), [`crates/osiris-api`](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-api) (REST API), [`crates/osiris-storage/src/storage.rs`](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-storage/src/storage.rs) (Storage interface), [`crates/osiris-sensors`](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-sensors) (Host sensors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Endpoint collection"]
  node_sensors["Host sensors"]
  node_dns_engine["DNS capture engine<br/>[engine.rs]"]
  node_agent["Endpoint agent<br/>[agent.rs]"]
  node_transport["Mutual-TLS transport<br/>[server.rs]"]
end

subgraph group_backend["Ingest and detection"]
  node_ingest["Event ingest<br/>[ingest.rs]"]
  node_pipeline["Event pipeline<br/>[pipeline.rs]"]
  node_normalization["Normalize and enrich"]
  node_detection["Rule detection<br/>[engine.rs]"]
  node_storage_api["Storage interface<br/>[storage.rs]"]
  node_sqlite[("SQLite storage<br/>[sqlite_storage.rs]")]
  node_clickhouse[("ClickHouse storage")]
end

subgraph group_operations["Security operations"]
  node_api["REST API"]
  node_investigation["Entity investigation"]
  node_evidence["Evidence and incidents"]
  node_fleet["Fleet and policy"]
end

subgraph group_console["Web console"]
  node_console_app["Console routing<br/>[App.tsx]"]
  node_console_api["Console API client<br/>[client.ts]"]
  node_console_views["Operations views"]
end

node_host(("Monitored host"))

node_host -.->|"generates telemetry"| node_sensors
node_sensors -.->|"supplies events"| node_agent
node_dns_engine -.->|"emits DNS events"| node_sensors
node_agent -.->|"sends batches"| node_transport
node_transport -->|"hands off batches"| node_ingest
node_ingest -.->|"processes events"| node_pipeline
node_pipeline -->|"uses stages"| node_normalization
node_ingest -.->|"evaluates events"| node_detection
node_ingest -.->|"persists events"| node_storage_api
node_detection -.->|"stores alerts"| node_storage_api
node_storage_api -.->|"backend implementation"| node_sqlite
node_storage_api -.->|"backend implementation"| node_clickhouse
node_ingest -->|"opens configured backend"| node_sqlite
node_api -.->|"queries telemetry"| node_storage_api
node_api -.->|"serves investigations"| node_investigation
node_api -.->|"serves evidence"| node_evidence
node_api -.->|"serves fleet operations"| node_fleet
node_console_app -->|"routes to"| node_console_views
node_console_views -.->|"requests data"| node_console_api
node_console_api -.->|"calls API"| node_api

click node_sensors "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-sensors"
click node_dns_engine "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-sensors/dns/src/engine.rs"
click node_agent "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-agent/src/agent.rs"
click node_transport "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-transport/src/server.rs"
click node_ingest "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-server/src/ingest.rs"
click node_pipeline "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-pipeline/src/pipeline.rs"
click node_normalization "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-pipeline"
click node_detection "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-detect/src/engine.rs"
click node_storage_api "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-storage/src/storage.rs"
click node_sqlite "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-storage-sqlite/src/sqlite_storage.rs"
click node_clickhouse "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-storage-clickhouse/src"
click node_api "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-api"
click node_investigation "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-investigate"
click node_evidence "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-evidence"
click node_fleet "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-fleet"
click node_console_app "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/console/src/App.tsx"
click node_console_api "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/console/src/api/client.ts"
click node_console_views "https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/console/src/screens"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sensors,node_dns_engine,node_agent,node_transport toneBlue
class node_ingest,node_pipeline,node_normalization,node_detection,node_storage_api,node_sqlite,node_clickhouse toneAmber
class node_api,node_investigation,node_evidence,node_fleet toneMint
class node_console_app,node_console_api,node_console_views toneRose
class node_host toneIndigo
```

## Components

### Endpoint collection

- [Host sensors](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-sensors): `crates/osiris-sensors`
- [DNS capture engine](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-sensors/dns/src/engine.rs): `crates/osiris-sensors/dns/src/engine.rs`
- [Endpoint agent](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-agent/src/agent.rs): `crates/osiris-agent/src/agent.rs`
- [Mutual-TLS transport](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-transport/src/server.rs): `crates/osiris-transport/src/server.rs`

### Ingest and detection

- [Event ingest](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-server/src/ingest.rs): `crates/osiris-server/src/ingest.rs`
- [Event pipeline](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-pipeline/src/pipeline.rs): `crates/osiris-pipeline/src/pipeline.rs`
- [Normalize and enrich](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-pipeline): `crates/osiris-pipeline`
- [Rule detection](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-detect/src/engine.rs): `crates/osiris-detect/src/engine.rs`
- [Storage interface](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-storage/src/storage.rs): `crates/osiris-storage/src/storage.rs`
- [SQLite storage](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/crates/osiris-storage-sqlite/src/sqlite_storage.rs): `crates/osiris-storage-sqlite/src/sqlite_storage.rs`
- [ClickHouse storage](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-storage-clickhouse/src): `crates/osiris-storage-clickhouse/src`

### Security operations

- [REST API](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-api): `crates/osiris-api`
- [Entity investigation](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-investigate): `crates/osiris-investigate`
- [Evidence and incidents](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-evidence): `crates/osiris-evidence`
- [Fleet and policy](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/crates/osiris-fleet): `crates/osiris-fleet`

### Web console

- [Console routing](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/console/src/App.tsx): `console/src/App.tsx`
- [Console API client](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/blob/master/console/src/api/client.ts): `console/src/api/client.ts`
- [Operations views](https://github.com/excanear/osiris---operational-system-intelligence-response-investigation-system/tree/master/console/src/screens): `console/src/screens`

### Other components

- **Monitored host**

## Connections

- Monitored host → Host sensors: generates telemetry
- Host sensors → Endpoint agent: supplies events
- DNS capture engine → Host sensors: emits DNS events (evidence: `crates/osiris-sensors/dns/src/engine.rs`)
- Endpoint agent → Mutual-TLS transport: sends batches
- Mutual-TLS transport → Event ingest: hands off batches (evidence: `crates/osiris-transport/src/server.rs`)
- Event ingest → Event pipeline: processes events
- Event pipeline → Normalize and enrich: uses stages (evidence: `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 (evidence: `console/src/App.tsx`)
- Operations views → Console API client: requests data
- Console API client → REST API: calls API
