How youssefelkassimi/monitoring works
This is a Spring backend for agent-based infrastructure monitoring, alerting, user access, and remote commands. Agents report telemetry and inventory through ingest endpoints; services persist and process those reports, while query endpoints expose monitoring data and command endpoints support dispatch and results. Authentication and user administration form a separate workflow, with WebSocket pushes for live updates. The source index and excerpts support several service relationships, but not every controller or persistence call; unsupported links are omitted rather than inferred.
Main entry points: QueryController.java Monitoring queries · MetricsService.java Metrics processing · UserService.java User management · DiscoveryService.java Discovery records
Components 25
Agent ingestion
- Agent ingest API
src/main/java/com/elkassimi/monitoring_v2_0/controller/AgentIngestController.java - Agent lifecycle
src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java - Agent records
src/main/java/com/elkassimi/monitoring_v2_0/model/Agent.java
Monitoring data
- Monitoring queries
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Metrics processing
src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java - Discovery records
src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java - Alert handling
src/main/java/com/elkassimi/monitoring_v2_0/service/AlertService.java - Anomaly analysis
src/main/java/com/elkassimi/monitoring_v2_0/service/AnomalyService.java - Inventory records
src/main/java/com/elkassimi/monitoring_v2_0/service/InventoryService.java - Agent logs
src/main/java/com/elkassimi/monitoring_v2_0/service/LogService.java - Metrics records
src/main/java/com/elkassimi/monitoring_v2_0/model/Metrics.java - API response envelope
src/main/java/com/elkassimi/monitoring_v2_0/dto/ApiResponse.java - JSON payload utility
src/main/java/com/elkassimi/monitoring_v2_0/util/JsonUtil.java - Timestamp conversion
src/main/java/com/elkassimi/monitoring_v2_0/util/TimeUtil.java
Remote commands
- Command endpoints
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Command dispatch
src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java - Command records
src/main/java/com/elkassimi/monitoring_v2_0/repository/RemoteCommandRepository.java
Identity and live updates
- Authentication API
src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java - Authentication
src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java - User administration
src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java - User management
src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java - WebSocket updates
src/main/java/com/elkassimi/monitoring_v2_0/websocket/RealTimePushService.java - User representation
src/main/java/com/elkassimi/monitoring_v2_0/dto/UserDto.java
Other components
- Monitoring agent
- Monitoring client
Connections 24
- Monitoring agent → Agent ingest API: sends reports
- Monitoring queries → Agent lifecycle: queries agents
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Metrics processing: queries metrics
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Inventory records: queries inventory
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Discovery records: queries discovery
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Agent logs: queries logs
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Alert handling: queries alerts
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Monitoring queries → Anomaly analysis: queries anomalies
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Command endpoints → Command dispatch: manages commands
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - Command dispatch → Command records: loads and saves
src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java - Authentication API → Authentication: handles login
src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java - Authentication → User management: sets online status
src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java - User administration → User management: manages users
src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java - User management → WebSocket updates: pushes user updates
src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java - Authentication → WebSocket updates: dependency only
src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java - Metrics processing → Metrics records: persists metrics
src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java - Metrics processing → JSON payload utility: uses serialization
src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java - Metrics processing → Timestamp conversion: converts timestamps
src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java - Discovery records → JSON payload utility: serializes payload
src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java - Discovery records → Timestamp conversion: converts timestamps
src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java - Agent lifecycle → Agent records: creates agent records
src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java - WebSocket updates → Monitoring client: broadcasts updates
- Monitoring queries → API response envelope: wraps results
src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java - User management → User representation: maps user data
src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java