How mghiremath0281/incidentbrain works
IncidentBrain is an event-driven incident detection and response platform. Prometheus metrics are scraped and evaluated into alerts; Kafka carries alerts to correlation, which groups them into incidents. Context enrichment adds logs and service metrics, then the AI service analyzes the enriched incident and Jira turns analysis into a ticket. Authentication and a web UI support users, while the gateway and Eureka provide shared access and discovery. The README also describes postmortem and notification consumers, but their implementations are not present in the supplied tree; unsampled service internals are represented at their listed entry-point paths.
Main entry points: ContextBuilderService.java Context enrichment · MetricsIngestionService.java Metric ingestion · AnalysisEngine.java LLM analysis · App.jsx IncidentBrain UI
Components 28
User access
- IncidentBrain UI
incidentbrain_ui/src/App.jsx - Authentication
infrastructure/auth-service/src/main/java/com/incidentbbrain/authservice/service/AuthService.java
Platform infrastructure
- API Gateway
infrastructure/api-gateway/src/main/java/com/incidentbbrain/apigateway/ApiGatewayApplication.java - Service discovery
infrastructure/eurekaserver/src/main/java/com/incidentbbrain/eurekaserver/EurekaserverApplication.java - Configuration service
infrastructure/config-service/src/main/java/com/incidentbbrain/configservice/ConfigServiceApplication.java
Alert detection
- Metric ingestion
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java - Metric parser
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/PrometheusParserService.java - Alert rules
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/RuleEvaluationService.java - Alert ingestion API
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/controller/MetricsIngestionController.java
Incident pipeline
- Raw alerts topic
- Alert correlation
microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java - Incident records
microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/IncidentService.java - Created incidents topic
- Context enrichment
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java - Elasticsearch logs
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ElasticsearchLogService.java - Actuator metrics
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ActuatorMetricsService.java - Enriched incidents
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/repository/IncidentRepository.java
Analysis and action
- Context ready topic
- LLM analysis
ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java - Analysis records
ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/entity/IncidentAnalysis.java - Analysis learning
ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/service/LearningService.java - Analysis completed topic
- Jira ticketing
microservices/jira-service/src/main/java/com/incidentbbrain/jiraservice/service/JiraOrchestrator.java - Postmortem consumer
- Notification consumer
Other components
- Operator
- Prometheus
- Jira
Connections 26
- Operator → IncidentBrain UI: uses
README.md - IncidentBrain UI → Authentication: authenticates via
- IncidentBrain UI → API Gateway: accesses services
- API Gateway → Service discovery: discovers services
README.md - Configuration service → API Gateway: configures
- Prometheus → Metric ingestion: provides metrics
README.md - Metric ingestion → Metric parser: parses metrics
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java - Metric ingestion → Alert rules: evaluates metrics
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java - Metric ingestion → Alert ingestion API: pushes alerts
microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java - Alert ingestion API → Raw alerts topic: publishes alerts
README.md - Raw alerts topic → Alert correlation: consumed by
README.md - Alert correlation → Incident records: creates incident
microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java - Alert correlation → Created incidents topic: publishes incident
microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java - Created incidents topic → Context enrichment: consumed by
README.md - Context enrichment → Elasticsearch logs: fetches logs
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java - Context enrichment → Actuator metrics: fetches metrics
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java - Context enrichment → Enriched incidents: saves enrichment
microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java - Context enrichment → Context ready topic: publishes context
README.md - Context ready topic → LLM analysis: consumed by
README.md - Context ready topic → Postmortem consumer: consumed by
README.md - LLM analysis → Analysis records: stores analysis
ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java - LLM analysis → Analysis learning: uses learning
- LLM analysis → Analysis completed topic: publishes analysis
README.md - Analysis completed topic → Jira ticketing: consumed by
README.md - Analysis completed topic → Notification consumer: consumed by
README.md - Jira ticketing → Jira: creates tickets
README.md