How saadahmed17/infrasentinel works
InfraSentinel is a multi-tenant infrastructure monitoring and operational intelligence platform. Agents send server metrics and security events to the API; the dashboard manages servers and organizations and presents alerts and incidents. The API persists telemetry, evaluates SIEM rules, and coordinates per-server anomaly detection and incident creation. The RAG assistant retrieves tenant-scoped incident context to answer operator questions. The README documents these major capabilities, but several detailed API and UI connections are not shown in source excerpts; those documented relationships are cited to the README.
Main entry points: api-client.ts Web API client · prisma.service.ts Postgres and pgvector · servers.service.ts Server management · rag.py Incident retrieval assistant
Components 25
Telemetry collection
- Monitoring agent
apps/agent/agent.py - SSH event agent
apps/agent/ssh_log_agent.py
API and operations
- Agent ingestion
apps/api/src/servers/metrics-ingestion.controller.ts - Server management
apps/api/src/servers/servers.service.ts - Event tracking
apps/api/src/events/events.service.ts - Authentication and RBAC
apps/api/src/auth/auth.service.ts - Organizations
apps/api/src/organizations/organizations.service.ts - Postgres and pgvector
apps/api/src/prisma/prisma.service.ts
Detection and incidents
- SIEM rule engine
apps/api/src/rules/rule-engine.service.ts - Incident management
apps/api/src/incidents/incidents.service.ts - Anomaly coordination
apps/api/src/anomaly/anomaly.service.ts
AI services
- Metric training data
apps/ai-service/data_pipeline.py - Metric preprocessing
apps/ai-service/preprocess.py - Model training
apps/ai-service/train.py - Anomaly inference
apps/ai-service/inference.py - RAG API proxy
apps/api/src/rag/rag.service.ts - Incident retrieval assistant
apps/ai-service/rag.py
Operator console
- Monitoring dashboard
apps/web/src/app/dashboard/page.tsx - Server console
apps/web/src/app/servers/page.tsx - Rules console
apps/web/src/app/rules/page.tsx - Incident console
apps/web/src/app/incidents/page.tsx - Assistant chat
apps/web/src/app/assistant/page.tsx - Web API client
apps/web/src/lib/api-client.ts
Other components
- Operator
- Groq LLM
Connections 31
- Monitoring agent → Agent ingestion: pushes metrics
- SSH event agent → Agent ingestion: pushes events
- Agent ingestion → Server management: dispatches ingestion
apps/api/src/servers/metrics-ingestion.controller.ts - Server management → Postgres and pgvector: persists telemetry
apps/api/src/servers/servers.service.ts - Server management → Event tracking: records events
apps/api/src/servers/servers.service.ts - Authentication and RBAC → Postgres and pgvector: reads and writes
apps/api/src/auth/auth.service.ts - Organizations → Postgres and pgvector: manages tenant data
apps/api/src/organizations/organizations.service.ts - Server management → SIEM rule engine: feeds SIEM events
- SIEM rule engine → Incident management: creates alerts
- Metric training data → Postgres and pgvector: loads metrics
apps/ai-service/data_pipeline.py - Metric training data → Metric preprocessing: provides metrics
apps/ai-service/preprocess.py - Metric preprocessing → Model training: builds sequences
- Model training → Anomaly inference: supplies model
- Anomaly coordination → Anomaly inference: requests scores
- Anomaly coordination → Incident management: creates anomaly alerts
- Incident management → RAG API proxy: indexes incidents
- RAG API proxy → Incident retrieval assistant: forwards query
apps/api/src/rag/rag.service.ts - Incident retrieval assistant → Postgres and pgvector: retrieves incidents
- Incident retrieval assistant → Groq LLM: generates answer
- Operator → Monitoring dashboard: views status
- Operator → Server console: manages servers
- Operator → Rules console: configures rules
- Operator → Incident console: reviews incidents
- Operator → Assistant chat: asks questions
- Monitoring dashboard → Web API client: requests data
- Server console → Web API client: requests data
- Rules console → Web API client: requests data
- Incident console → Web API client: requests data
- Assistant chat → Web API client: sends queries
- Web API client → Authentication and RBAC: calls API
- Web API client → RAG API proxy: queries assistant