How vaibhav-zemo/ai-rca-platform works
This is a Spring Boot platform for turning streamed microservice telemetry into structured root-cause reports. Its main workflow consumes Kafka events, filters and deduplicates incidents, enriches analysis with Neo4j topology and pgvector history, requests structured Gemini output, persists the incident and report, and feeds the outcome back to vector search. The README documents these capabilities; the graph initializer and principal workflow are excerpted, while wiring for some infrastructure relies on README statements and configuration.
Main entry points: TelemetryIngestionService.java Telemetry ingestion · RcaOrchestratorService.java RCA orchestrator · RcaReportEntity.java Persisted RCA report · RcaBootController.java Pipeline check API
Components 19
Telemetry intake
- Telemetry ingestion
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Telemetry message
src/main/java/org/vaibhav/aircaplatform/dto/TelemetryMessage.java - Pipeline check API
src/main/java/org/vaibhav/aircaplatform/controller/RcaBootController.java - Spring Boot application
src/main/java/org/vaibhav/aircaplatform/AiRcaPlatformApplication.java
RCA analysis
- RCA orchestrator
src/main/java/org/vaibhav/aircaplatform/service/RcaOrchestratorService.java - Structured RCA report
src/main/java/org/vaibhav/aircaplatform/dto/RcaReport.java - Vector history
Service topology
- Service graph node
src/main/java/org/vaibhav/aircaplatform/model/graph/ServiceNode.java - Service graph repository
src/main/java/org/vaibhav/aircaplatform/repository/graph/ServiceGraphRepository.java - Topology seeder
src/main/java/org/vaibhav/aircaplatform/config/GraphDataInitializer.java
Incident records
- Incident record
src/main/java/org/vaibhav/aircaplatform/model/Incident.java - Incident repository
src/main/java/org/vaibhav/aircaplatform/repository/IncidentRepository.java - Persisted RCA report
src/main/java/org/vaibhav/aircaplatform/model/RcaReportEntity.java - Report repository
src/main/java/org/vaibhav/aircaplatform/repository/RcaReportRepository.java
AI and stores
- Kafka topic
- PostgreSQL pgvector
- Neo4j topology
- Gemini model
Other components
- Telemetry producer
Connections 21
- Telemetry producer → Kafka topic: publishes telemetry
README.md - Kafka topic → Telemetry ingestion: delivers events
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Telemetry ingestion → Telemetry message: parses payload
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Telemetry ingestion → Incident repository: checks and saves
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Incident repository → Incident record: stores incident
src/main/java/org/vaibhav/aircaplatform/repository/IncidentRepository.java - Telemetry ingestion → RCA orchestrator: requests analysis
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - RCA orchestrator → Neo4j topology: queries dependencies
src/main/java/org/vaibhav/aircaplatform/service/RcaOrchestratorService.java - RCA orchestrator → Vector history: searches history
src/main/java/org/vaibhav/aircaplatform/service/RcaOrchestratorService.java - RCA orchestrator → Gemini model: requests diagnosis
README.md - RCA orchestrator → Structured RCA report: returns structured result
src/main/java/org/vaibhav/aircaplatform/service/RcaOrchestratorService.java - Telemetry ingestion → Persisted RCA report: builds report record
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Telemetry ingestion → Report repository: saves report
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Report repository → Persisted RCA report: stores report
src/main/java/org/vaibhav/aircaplatform/repository/RcaReportRepository.java - Persisted RCA report → Incident record: references incident
src/main/java/org/vaibhav/aircaplatform/model/RcaReportEntity.java - Telemetry ingestion → Vector history: adds learned outcome
src/main/java/org/vaibhav/aircaplatform/service/TelemetryIngestionService.java - Vector history → PostgreSQL pgvector: persists vectors
README.md - Topology seeder → Neo4j topology: seeds topology
src/main/java/org/vaibhav/aircaplatform/config/GraphDataInitializer.java - Service graph node → Neo4j topology: models service graph
- Service graph repository → Neo4j topology: accesses graph
- Pipeline check API → Vector history: checks vector storage
src/main/java/org/vaibhav/aircaplatform/controller/RcaBootController.java - Pipeline check API → Gemini model: checks model call
src/main/java/org/vaibhav/aircaplatform/controller/RcaBootController.java