How shashi999kant/ai-rca-platform works
This is a Spring Boot incident RCA engine. Telemetry is parsed, deduplicated and grouped before new incidents are queued for asynchronous analysis; workers combine service-call paths and verified incident history, ask Gemini for structured findings, and persist reports. Engineers can retrieve reports, verify them to seed future retrieval, and inspect grouping statistics. The graph and vector integrations are explicit in the README and orchestrator excerpt; the REST, DLT, and startup capabilities are documented, though some implementation details were not sampled.
Main entry points: IncidentAnalysisService.java Analysis worker · repository Incident and report repositories · TelemetryIngestionService.java Telemetry ingestion · RcaOrchestratorService.java RCA orchestrator
Components 21
Ingestion
- Raw Kafka topic
- Telemetry ingestion
src/main/java/com/shashi/rca/service/TelemetryIngestionService.java - Error signature
src/main/java/com/shashi/rca/service/ErrorSignature.java
RCA analysis
- Analysis topic
- Analysis worker
src/main/java/com/shashi/rca/service/IncidentAnalysisService.java - RCA orchestrator
src/main/java/com/shashi/rca/service/RcaOrchestratorService.java - Gemini client
src/main/java/com/shashi/rca/service/LlmClient.java - RCA and API DTOs
src/main/java/com/shashi/rca/dto - Analysis dead-letter topic
- Dead-letter listener
src/main/java/com/shashi/rca/service/DeadLetterListener.java
Knowledge context
- Service dependency graph
- Verified incident vectors
Persistence
- PostgreSQL incident and report data
- Incident and report repositories
src/main/java/com/shashi/rca/repository - Incident and report models
src/main/java/com/shashi/rca/model
Reports and API
- Incident and report REST API
src/main/java/com/shashi/rca/controller/IncidentController.java - Report service
src/main/java/com/shashi/rca/service/ReportService.java - Grouping statistics
src/main/java/com/shashi/rca/dto/StatsResponse.java
Other components
- Telemetry producer
- Google Gemini
- On-call engineer
Connections 22
- Telemetry producer → Raw Kafka topic: publishes telemetry
README.md - Raw Kafka topic → Telemetry ingestion: delivers events
README.md - Telemetry ingestion → Error signature: normalizes errors
src/main/java/com/shashi/rca/service/TelemetryIngestionService.java - Telemetry ingestion → Incident and report repositories: deduplicates and stores
src/main/java/com/shashi/rca/service/TelemetryIngestionService.java - Telemetry ingestion → Analysis topic: queues incident ID
src/main/java/com/shashi/rca/service/TelemetryIngestionService.java - Analysis topic → Analysis worker: delivers requests
README.md - Analysis worker → Incident and report repositories: claims and saves incident
src/main/java/com/shashi/rca/service/IncidentAnalysisService.java - Analysis worker → RCA orchestrator: runs analysis
src/main/java/com/shashi/rca/service/IncidentAnalysisService.java - RCA orchestrator → Service dependency graph: queries call paths
src/main/java/com/shashi/rca/service/RcaOrchestratorService.java - RCA orchestrator → Verified incident vectors: searches similar verified reports
src/main/java/com/shashi/rca/service/RcaOrchestratorService.java - RCA orchestrator → Gemini client: supplies RCA context
src/main/java/com/shashi/rca/service/RcaOrchestratorService.java - Gemini client → Google Gemini: requests structured analysis
README.md - Analysis worker → RCA and API DTOs: consumes RCA report
src/main/java/com/shashi/rca/service/IncidentAnalysisService.java - Incident and report repositories → PostgreSQL incident and report data: reads and writes
README.md - Analysis worker → Analysis dead-letter topic: routes exhausted retries
README.md - Analysis dead-letter topic → Dead-letter listener: delivers failed requests
README.md - Dead-letter listener → Incident and report repositories: marks incidents failed
src/main/java/com/shashi/rca/service/DeadLetterListener.java - On-call engineer → Incident and report REST API: requests reports or verifies
README.md - Incident and report REST API → Report service: delegates report operations
src/main/java/com/shashi/rca/controller/IncidentController.java - Report service → Incident and report repositories: loads reports and counts
src/main/java/com/shashi/rca/service/ReportService.java - Report service → Verified incident vectors: adds verified report
src/main/java/com/shashi/rca/service/ReportService.java - Incident and report REST API → Grouping statistics: returns statistics
README.md