# youssefelkassimi/monitoring architecture

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

- Interactive diagram: https://gitdiagram.com/youssefelkassimi/monitoring
- Repository: https://github.com/youssefelkassimi/monitoring

## Overview

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: [`src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java) (Monitoring queries), [`src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java`](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java) (Metrics processing), [`src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java`](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java) (User management), [`src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java`](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java) (Discovery records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Agent ingestion"]
  node_ingest_api["Agent ingest API"]
  node_agent_service["Agent lifecycle<br/>[AgentService.java]"]
  node_agent_model["Agent records<br/>[Agent.java]"]
end

subgraph group_monitor["Monitoring data"]
  node_query_api["Monitoring queries"]
  node_metrics["Metrics processing"]
  node_discovery["Discovery records"]
  node_alerts["Alert handling<br/>[AlertService.java]"]
  node_anomaly["Anomaly analysis"]
  node_inventory["Inventory records"]
  node_logs["Agent logs<br/>[LogService.java]"]
  node_metrics_model["Metrics records<br/>[Metrics.java]"]
  node_response["API response envelope<br/>[ApiResponse.java]"]
  node_json["JSON payload utility<br/>[JsonUtil.java]"]
  node_time["Timestamp conversion<br/>[TimeUtil.java]"]
end

subgraph group_commands["Remote commands"]
  node_command_api["Command endpoints"]
  node_command_service["Command dispatch"]
  node_command_repo[("Command records")]
end

subgraph group_identity["Identity and live updates"]
  node_auth_api["Authentication API"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_users_api["User administration"]
  node_users["User management<br/>[UserService.java]"]
  node_push["WebSocket updates"]
  node_user_dto["User representation<br/>[UserDto.java]"]
end

node_agent(("Monitoring agent"))
node_client(("Monitoring client"))

node_agent -.->|"sends reports"| node_ingest_api
node_query_api -->|"queries agents"| node_agent_service
node_query_api -->|"queries metrics"| node_metrics
node_query_api -->|"queries inventory"| node_inventory
node_query_api -->|"queries discovery"| node_discovery
node_query_api -->|"queries logs"| node_logs
node_query_api -->|"queries alerts"| node_alerts
node_query_api -->|"queries anomalies"| node_anomaly
node_command_api -.->|"manages commands"| node_command_service
node_command_service -->|"loads and saves"| node_command_repo
node_auth_api -.->|"handles login"| node_auth
node_auth -->|"sets online status"| node_users
node_users_api -.->|"manages users"| node_users
node_users -->|"pushes user updates"| node_push
node_auth -.->|"dependency only"| node_push
node_metrics -.->|"persists metrics"| node_metrics_model
node_metrics -.->|"uses serialization"| node_json
node_metrics -.->|"converts timestamps"| node_time
node_discovery -->|"serializes payload"| node_json
node_discovery -->|"converts timestamps"| node_time
node_agent_service -->|"creates agent records"| node_agent_model
node_push -.->|"broadcasts updates"| node_client
node_query_api -->|"wraps results"| node_response
node_users -.->|"maps user data"| node_user_dto

click node_ingest_api "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/AgentIngestController.java"
click node_agent_service "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java"
click node_query_api "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java"
click node_metrics "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java"
click node_discovery "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java"
click node_alerts "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AlertService.java"
click node_anomaly "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AnomalyService.java"
click node_inventory "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/InventoryService.java"
click node_logs "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/LogService.java"
click node_command_api "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java"
click node_command_service "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java"
click node_command_repo "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/repository/RemoteCommandRepository.java"
click node_auth_api "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java"
click node_auth "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java"
click node_users_api "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java"
click node_users "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java"
click node_push "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/websocket/RealTimePushService.java"
click node_metrics_model "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/model/Metrics.java"
click node_agent_model "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/model/Agent.java"
click node_response "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/dto/ApiResponse.java"
click node_user_dto "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/dto/UserDto.java"
click node_json "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/util/JsonUtil.java"
click node_time "https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/util/TimeUtil.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_ingest_api,node_agent_service,node_agent_model,node_client toneBlue
class node_query_api,node_metrics,node_discovery,node_alerts,node_anomaly,node_inventory,node_logs,node_metrics_model,node_response,node_json,node_time toneAmber
class node_command_api,node_command_service,node_command_repo toneMint
class node_auth_api,node_auth,node_users_api,node_users,node_push,node_user_dto toneRose
class node_agent toneIndigo
```

## Components

### Agent ingestion

- [Agent ingest API](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/AgentIngestController.java): `src/main/java/com/elkassimi/monitoring_v2_0/controller/AgentIngestController.java`
- [Agent lifecycle](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java`
- [Agent records](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/model/Agent.java): `src/main/java/com/elkassimi/monitoring_v2_0/model/Agent.java`

### Monitoring data

- [Monitoring queries](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java): `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`
- [Metrics processing](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java`
- [Discovery records](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java`
- [Alert handling](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AlertService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/AlertService.java`
- [Anomaly analysis](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AnomalyService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/AnomalyService.java`
- [Inventory records](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/InventoryService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/InventoryService.java`
- [Agent logs](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/LogService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/LogService.java`
- [Metrics records](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/model/Metrics.java): `src/main/java/com/elkassimi/monitoring_v2_0/model/Metrics.java`
- [API response envelope](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/dto/ApiResponse.java): `src/main/java/com/elkassimi/monitoring_v2_0/dto/ApiResponse.java`
- [JSON payload utility](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/util/JsonUtil.java): `src/main/java/com/elkassimi/monitoring_v2_0/util/JsonUtil.java`
- [Timestamp conversion](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/util/TimeUtil.java): `src/main/java/com/elkassimi/monitoring_v2_0/util/TimeUtil.java`

### Remote commands

- [Command endpoints](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java): `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`
- [Command dispatch](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java`
- [Command records](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/repository/RemoteCommandRepository.java): `src/main/java/com/elkassimi/monitoring_v2_0/repository/RemoteCommandRepository.java`

### Identity and live updates

- [Authentication API](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java): `src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java`
- [Authentication](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java`
- [User administration](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java): `src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java`
- [User management](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java): `src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java`
- [WebSocket updates](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/websocket/RealTimePushService.java): `src/main/java/com/elkassimi/monitoring_v2_0/websocket/RealTimePushService.java`
- [User representation](https://github.com/youssefelkassimi/monitoring/blob/main/src/main/java/com/elkassimi/monitoring_v2_0/dto/UserDto.java): `src/main/java/com/elkassimi/monitoring_v2_0/dto/UserDto.java`

### Other components

- **Monitoring agent**
- **Monitoring client**

## Connections

- Monitoring agent → Agent ingest API: sends reports
- Monitoring queries → Agent lifecycle: queries agents (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Metrics processing: queries metrics (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Inventory records: queries inventory (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Discovery records: queries discovery (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Agent logs: queries logs (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Alert handling: queries alerts (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Monitoring queries → Anomaly analysis: queries anomalies (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Command endpoints → Command dispatch: manages commands (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- Command dispatch → Command records: loads and saves (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/RemoteCommandService.java`)
- Authentication API → Authentication: handles login (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/AuthController.java`)
- Authentication → User management: sets online status (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java`)
- User administration → User management: manages users (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/UserController.java`)
- User management → WebSocket updates: pushes user updates (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java`)
- Authentication → WebSocket updates: dependency only (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/AuthService.java`)
- Metrics processing → Metrics records: persists metrics (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java`)
- Metrics processing → JSON payload utility: uses serialization (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java`)
- Metrics processing → Timestamp conversion: converts timestamps (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/MetricsService.java`)
- Discovery records → JSON payload utility: serializes payload (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java`)
- Discovery records → Timestamp conversion: converts timestamps (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/DiscoveryService.java`)
- Agent lifecycle → Agent records: creates agent records (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/AgentService.java`)
- WebSocket updates → Monitoring client: broadcasts updates
- Monitoring queries → API response envelope: wraps results (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/controller/QueryController.java`)
- User management → User representation: maps user data (evidence: `src/main/java/com/elkassimi/monitoring_v2_0/service/UserService.java`)
