How richssa24/sentinel_linux2.0 works
Sentinel-Linux is an async Linux host-based intrusion detection system. Host collectors produce security observations that are normalized into ECS events, passed through a bounded, deduplicating pipeline, matched against declarative ATT&CK-mapped rules, and promoted to alerts for sink delivery. In parallel, events and alerts are persisted for authenticated API queries; Prometheus metrics expose operational state. The README documents this end-to-end wiring, and the source index identifies the runtime composition root. Some subsystem internals were not excerpted, so edges for those documented capabilities cite the README rather than implying source inspection.
Main entry points: manager.py Alert manager · mapper.py Normalizer · engine.py Detection engine · network.py Network monitor
Components 23
Collection and normalization
- Auth log
src/sentinel/collectors/authlog.py - Process monitor
src/sentinel/collectors/process.py - File integrity
src/sentinel/collectors/integrity.py - Network monitor
src/sentinel/collectors/network.py - Network parser
src/sentinel/collectors/netparse.py - Normalizer
src/sentinel/normalizer/mapper.py
Event processing
- ECS events
src/sentinel/events.py - Pipeline runner
src/sentinel/pipeline/runner.py - Bounded queue
src/sentinel/pipeline/queue.py - Dedup window
src/sentinel/pipeline/dedup.py
Rule detection
- Rule loader
src/sentinel/detection/loader.py - Rule schema
src/sentinel/detection/schema.py - Condition evaluator
src/sentinel/detection/evaluator.py - Detection engine
src/sentinel/detection/engine.py
Alerts and integrations
- Alert manager
src/sentinel/alerting/manager.py - Alert model
src/sentinel/alerting/model.py - Alert sinks
src/sentinel/alerting/sinks
Persistence and access
- Database
src/sentinel/storage/database.py - Storage repository
src/sentinel/storage/repository.py - Authenticated API
src/sentinel/api/app.py - Prometheus metrics
src/sentinel/metrics.py - Runtime composition
src/sentinel/runtime.py
Other components
- Linux host
Connections 25
- Linux host → Auth log: reads auth logs
- Linux host → Process monitor: reads processes
- Linux host → File integrity: watches files
- Linux host → Network monitor: reads sockets
- Network monitor → Network parser: parses sockets
src/sentinel/collectors/network.py - Auth log → Normalizer: normalizes input
- Process monitor → Normalizer: normalizes input
- File integrity → Normalizer: normalizes input
- Network monitor → Normalizer: normalizes input
- Normalizer → ECS events: builds events
src/sentinel/normalizer/mapper.py - Runtime composition → Pipeline runner: assembles pipeline
- Pipeline runner → Bounded queue: enqueues events
src/sentinel/pipeline/runner.py - Bounded queue → Dedup window: feeds events
- Dedup window → Detection engine: dispatches unique events
- Rule loader → Rule schema: validates rules
src/sentinel/detection/loader.py - Detection engine → Condition evaluator: evaluates conditions
src/sentinel/detection/engine.py - Detection engine → Alert manager: emits detections
src/sentinel/alerting/manager.py - Alert manager → Alert model: creates alerts
src/sentinel/alerting/manager.py - Alert manager → Alert sinks: dispatches alerts
src/sentinel/alerting/manager.py - Detection engine → Storage repository: persists events
- Alert manager → Storage repository: persists alerts
- Storage repository → Database: reads and writes
src/sentinel/storage/repository.py - Database → Authenticated API: serves stored data
src/sentinel/api/app.py - Bounded queue → Prometheus metrics: exposes metrics
- Alert manager → Prometheus metrics: exposes metrics