# mghiremath0281/incidentbrain architecture

> Architecture diagram of the GitHub repository mghiremath0281/incidentbrain, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mghiremath0281/incidentbrain
- Repository: https://github.com/mghiremath0281/incidentbrain

## Overview

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: [`microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java`](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java) (Context enrichment), [`microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java`](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java) (Metric ingestion), [`ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java`](https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java) (LLM analysis), [`incidentbrain_ui/src/App.jsx`](https://github.com/mghiremath0281/incidentbrain/blob/main/incidentbrain_ui/src/App.jsx) (IncidentBrain UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User access"]
  node_ui["IncidentBrain UI<br/>[App.jsx]"]
  node_auth["Authentication<br/>[AuthService.java]"]
end

subgraph group_platform["Platform infrastructure"]
  node_gateway["API Gateway"]
  node_registry["Service discovery"]
  node_config["Configuration service"]
end

subgraph group_detection["Alert detection"]
  node_ingestion["Metric ingestion"]
  node_parser["Metric parser"]
  node_rules["Alert rules"]
  node_alertapi["Alert ingestion API"]
end

subgraph group_incident["Incident pipeline"]
  node_alertbus["Raw alerts topic"]
  node_correlation["Alert correlation"]
  node_incidents[("Incident records")]
  node_incidentbus["Created incidents topic"]
  node_context["Context enrichment"]
  node_logs["Elasticsearch logs"]
  node_actuator["Actuator metrics"]
  node_contextdb[("Enriched incidents")]
end

subgraph group_response["Analysis and action"]
  node_contextbus["Context ready topic"]
  node_ai["LLM analysis"]
  node_analysisdb[("Analysis records")]
  node_learning["Analysis learning"]
  node_analysisbus["Analysis completed topic"]
  node_jira["Jira ticketing"]
  node_postmortem["Postmortem consumer"]
  node_notifications["Notification consumer"]
end

node_user(("Operator"))
node_prometheus["Prometheus"]
node_jiraapi["Jira"]

node_user -->|"uses"| node_ui
node_ui -.->|"authenticates via"| node_auth
node_ui -.->|"accesses services"| node_gateway
node_gateway -->|"discovers services"| node_registry
node_config -.->|"configures"| node_gateway
node_prometheus -->|"provides metrics"| node_ingestion
node_ingestion -->|"parses metrics"| node_parser
node_ingestion -->|"evaluates metrics"| node_rules
node_ingestion -->|"pushes alerts"| node_alertapi
node_alertapi -->|"publishes alerts"| node_alertbus
node_alertbus -->|"consumed by"| node_correlation
node_correlation -->|"creates incident"| node_incidents
node_correlation -->|"publishes incident"| node_incidentbus
node_incidentbus -->|"consumed by"| node_context
node_context -->|"fetches logs"| node_logs
node_context -->|"fetches metrics"| node_actuator
node_context -->|"saves enrichment"| node_contextdb
node_context -->|"publishes context"| node_contextbus
node_contextbus -->|"consumed by"| node_ai
node_contextbus -->|"consumed by"| node_postmortem
node_ai -.->|"stores analysis"| node_analysisdb
node_ai -.->|"uses learning"| node_learning
node_ai -->|"publishes analysis"| node_analysisbus
node_analysisbus -->|"consumed by"| node_jira
node_analysisbus -->|"consumed by"| node_notifications
node_jira -->|"creates tickets"| node_jiraapi

click node_ui "https://github.com/mghiremath0281/incidentbrain/blob/main/incidentbrain_ui/src/App.jsx"
click node_auth "https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/auth-service/src/main/java/com/incidentbbrain/authservice/service/AuthService.java"
click node_gateway "https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/api-gateway/src/main/java/com/incidentbbrain/apigateway/ApiGatewayApplication.java"
click node_registry "https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/eurekaserver/src/main/java/com/incidentbbrain/eurekaserver/EurekaserverApplication.java"
click node_config "https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/config-service/src/main/java/com/incidentbbrain/configservice/ConfigServiceApplication.java"
click node_ingestion "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java"
click node_parser "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/PrometheusParserService.java"
click node_rules "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/RuleEvaluationService.java"
click node_alertapi "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/controller/MetricsIngestionController.java"
click node_correlation "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java"
click node_incidents "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/IncidentService.java"
click node_context "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java"
click node_logs "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ElasticsearchLogService.java"
click node_actuator "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ActuatorMetricsService.java"
click node_contextdb "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/repository/IncidentRepository.java"
click node_ai "https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java"
click node_analysisdb "https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/entity/IncidentAnalysis.java"
click node_learning "https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/service/LearningService.java"
click node_jira "https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/jira-service/src/main/java/com/incidentbbrain/jiraservice/service/JiraOrchestrator.java"

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_ui,node_auth toneBlue
class node_gateway,node_registry,node_config toneAmber
class node_ingestion,node_parser,node_rules,node_alertapi toneMint
class node_alertbus,node_correlation,node_incidents,node_incidentbus,node_context,node_logs,node_actuator,node_contextdb toneRose
class node_contextbus,node_ai,node_analysisdb,node_learning,node_analysisbus,node_jira,node_postmortem,node_notifications,node_user,node_prometheus,node_jiraapi toneIndigo
```

## Components

### User access

- [IncidentBrain UI](https://github.com/mghiremath0281/incidentbrain/blob/main/incidentbrain_ui/src/App.jsx): `incidentbrain_ui/src/App.jsx`
- [Authentication](https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/auth-service/src/main/java/com/incidentbbrain/authservice/service/AuthService.java): `infrastructure/auth-service/src/main/java/com/incidentbbrain/authservice/service/AuthService.java`

### Platform infrastructure

- [API Gateway](https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/api-gateway/src/main/java/com/incidentbbrain/apigateway/ApiGatewayApplication.java): `infrastructure/api-gateway/src/main/java/com/incidentbbrain/apigateway/ApiGatewayApplication.java`
- [Service discovery](https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/eurekaserver/src/main/java/com/incidentbbrain/eurekaserver/EurekaserverApplication.java): `infrastructure/eurekaserver/src/main/java/com/incidentbbrain/eurekaserver/EurekaserverApplication.java`
- [Configuration service](https://github.com/mghiremath0281/incidentbrain/blob/main/infrastructure/config-service/src/main/java/com/incidentbbrain/configservice/ConfigServiceApplication.java): `infrastructure/config-service/src/main/java/com/incidentbbrain/configservice/ConfigServiceApplication.java`

### Alert detection

- [Metric ingestion](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java): `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java`
- [Metric parser](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/PrometheusParserService.java): `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/PrometheusParserService.java`
- [Alert rules](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/RuleEvaluationService.java): `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/RuleEvaluationService.java`
- [Alert ingestion API](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/controller/MetricsIngestionController.java): `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/controller/MetricsIngestionController.java`

### Incident pipeline

- **Raw alerts topic**
- [Alert correlation](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java): `microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java`
- [Incident records](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/IncidentService.java): `microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/IncidentService.java`
- **Created incidents topic**
- [Context enrichment](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java): `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java`
- [Elasticsearch logs](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ElasticsearchLogService.java): `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ElasticsearchLogService.java`
- [Actuator metrics](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ActuatorMetricsService.java): `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ActuatorMetricsService.java`
- [Enriched incidents](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/context-service/src/main/java/com/incidentbbrain/contextservice/repository/IncidentRepository.java): `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/repository/IncidentRepository.java`

### Analysis and action

- **Context ready topic**
- [LLM analysis](https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java): `ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/engine/AnalysisEngine.java`
- [Analysis records](https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/entity/IncidentAnalysis.java): `ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/entity/IncidentAnalysis.java`
- [Analysis learning](https://github.com/mghiremath0281/incidentbrain/blob/main/ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/service/LearningService.java): `ai/ai-service-fixed/src/main/java/com/incidentbbrain/aiservice/service/LearningService.java`
- **Analysis completed topic**
- [Jira ticketing](https://github.com/mghiremath0281/incidentbrain/blob/main/microservices/jira-service/src/main/java/com/incidentbbrain/jiraservice/service/JiraOrchestrator.java): `microservices/jira-service/src/main/java/com/incidentbbrain/jiraservice/service/JiraOrchestrator.java`
- **Postmortem consumer**
- **Notification consumer**

### Other components

- **Operator**
- **Prometheus**
- **Jira**

## Connections

- Operator → IncidentBrain UI: uses (evidence: `README.md`)
- IncidentBrain UI → Authentication: authenticates via
- IncidentBrain UI → API Gateway: accesses services
- API Gateway → Service discovery: discovers services (evidence: `README.md`)
- Configuration service → API Gateway: configures
- Prometheus → Metric ingestion: provides metrics (evidence: `README.md`)
- Metric ingestion → Metric parser: parses metrics (evidence: `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java`)
- Metric ingestion → Alert rules: evaluates metrics (evidence: `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java`)
- Metric ingestion → Alert ingestion API: pushes alerts (evidence: `microservices/alertservice/src/main/java/com/incidentbbrain/alertservice/service/MetricsIngestionService.java`)
- Alert ingestion API → Raw alerts topic: publishes alerts (evidence: `README.md`)
- Raw alerts topic → Alert correlation: consumed by (evidence: `README.md`)
- Alert correlation → Incident records: creates incident (evidence: `microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java`)
- Alert correlation → Created incidents topic: publishes incident (evidence: `microservices/correlation-service/src/main/java/com/incidentbbrain/correlationservice/service/CorrelationEngine.java`)
- Created incidents topic → Context enrichment: consumed by (evidence: `README.md`)
- Context enrichment → Elasticsearch logs: fetches logs (evidence: `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java`)
- Context enrichment → Actuator metrics: fetches metrics (evidence: `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java`)
- Context enrichment → Enriched incidents: saves enrichment (evidence: `microservices/context-service/src/main/java/com/incidentbbrain/contextservice/service/ContextBuilderService.java`)
- Context enrichment → Context ready topic: publishes context (evidence: `README.md`)
- Context ready topic → LLM analysis: consumed by (evidence: `README.md`)
- Context ready topic → Postmortem consumer: consumed by (evidence: `README.md`)
- LLM analysis → Analysis records: stores analysis (evidence: `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 (evidence: `README.md`)
- Analysis completed topic → Jira ticketing: consumed by (evidence: `README.md`)
- Analysis completed topic → Notification consumer: consumed by (evidence: `README.md`)
- Jira ticketing → Jira: creates tickets (evidence: `README.md`)
