How aditisingh0562/system-health works
This repository is a real-machine monitoring stack: a Spring service collects OS metrics, Prometheus scrapes and serves them, Grafana visualizes them, and an MCP server exposes conversational queries. The README documents the main data flow and capabilities; Java implementation details were not sampled, so internal call relationships are limited to those it describes.
Main entry points: SystemHealthController.java Health API · SystemMetricsService.java Metrics service · prometheus.yml Prometheus · datasource.yml Grafana
Components 14
Metric collection
- Metrics service
system-health-service/src/main/java/com/example/systemhealth/SystemMetricsService.java - OSHI readings
- Micrometer gauges
Metrics and dashboards
- Scrape configuration
prometheus/prometheus.yml - Prometheus
prometheus/prometheus.yml - Grafana
grafana/provisioning/datasources/datasource.yml - Health dashboard
grafana/provisioning/dashboards/system-health-dashboard.json - Dashboard provisioning
grafana/provisioning/dashboards/dashboard.yml
Conversational queries
- MCP tools
mcp-server/server.py
Service operations
- Health API
system-health-service/src/main/java/com/example/systemhealth/SystemHealthController.java - Service configuration
system-health-service/src/main/resources/application.yml
Other components
- Operator
- Machine OS
- MCP client
Connections 14
- Operator → Health API: requests health
README.md - Operator → Health API: starts stress test
README.md - Metrics service → Machine OS: reads metrics
README.md - Metrics service → OSHI readings: uses OSHI
README.md - Metrics service → Micrometer gauges: registers gauges
README.md - Health API → Metrics service: exposes readings
- Service configuration → Health API: configures service
- Scrape configuration → Prometheus: configures scraping
README.md - Prometheus → Health API: scrapes metrics
README.md - Grafana → Prometheus: queries metrics
README.md - Dashboard provisioning → Health dashboard: provisions dashboard
README.md - Health dashboard → Grafana: visualizes metrics
README.md - MCP client → MCP tools: invokes tools
README.md - MCP tools → Prometheus: queries API
mcp-server/server.py