How biswajit-masanta/sentryx-edr works
SENTRYX collects endpoint identity, resource, and process telemetry; sends reports to a FastAPI service; stores telemetry, evaluates resource rules, derives features, and records a Random Forest risk prediction for dashboard visibility. The graph preserves the documented multi-host, alert, process-risk, and monitoring views. Agent transport details and dashboard request wiring are not shown in the excerpts, so those links are dashed and unverified; other edges cite the caller or README.
Main entry points: server.py Report and REST API · agent.py Agent loop · operations.py Telemetry operations · report.py Report schema
Components 23
Endpoint agent
- System identity
agent/modules_for_agents/sys_info.py - Resource sampler
agent/modules_for_agents/resources.py - Process collector
agent/modules_for_agents/process_collector.py - Agent loop
agent/agent.py - Report sender
agent/modules_for_agents/sender.py
Telemetry service
- Report and REST API
server/server.py - Report schema
server/models/report.py - System schema
server/models/sys_info.py - Process schema
server/models/processes.py - Resource schema
server/models/resource.py
Detection and ML
- Resource rules
server/database/rules.py - Feature extraction
server/ml/feature_extractor.py - Risk inference
server/ml/predict.py - Prediction status
server/ml/model_status.py - Model training
server/ml/train_model.py
Persistence
- Telemetry operations
server/database/operations.py - Table definitions
server/database/scheme.py - SQLite connection
server/database/connection.py - SQLite telemetry store
Dashboard
- Dashboard views
server/dashboard
Other components
- Security operator
- Monitored endpoint
- Dashboard user
Connections 25
- Monitored endpoint → Agent loop: runs on
README.md - Agent loop → System identity: collects identity
agent/agent.py - Agent loop → Resource sampler: samples resources
agent/agent.py - Agent loop → Process collector: collects processes
agent/agent.py - Agent loop → Report sender: sends report
agent/agent.py - Report sender → Report and REST API: posts telemetry
- Report and REST API → Report schema: accepts report
server/server.py - Report schema → System schema: includes
server/models/report.py - Report schema → Resource schema: includes
server/models/report.py - Report schema → Process schema: includes
server/models/report.py - Report and REST API → Telemetry operations: stores and queries
server/server.py - Report and REST API → Resource rules: evaluates resources
server/server.py - Report and REST API → Feature extraction: extracts features
server/server.py - Report and REST API → Risk inference: predicts risk
server/server.py - Report and REST API → Prediction status: updates status
server/server.py - Report and REST API → Table definitions: initializes tables
server/server.py - Feature extraction → Telemetry operations: counts active alerts
server/ml/feature_extractor.py - Resource rules → Telemetry operations: manages alerts
server/database/rules.py - Telemetry operations → SQLite connection: opens connections
server/database/operations.py - Table definitions → SQLite connection: opens connections
server/database/scheme.py - Telemetry operations → SQLite telemetry store: reads and writes
server/database/operations.py - Table definitions → SQLite telemetry store: creates tables
server/database/scheme.py - Report and REST API → Dashboard views: serves telemetry
- Dashboard user → Dashboard views: views monitoring
README.md - Model training → Risk inference: supplies model