# amanjeet233/enterprise-log-monitoring-and-incident-management-system architecture

> Architecture diagram of the GitHub repository amanjeet233/enterprise-log-monitoring-and-incident-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system
- Repository: https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system

## Overview

ELMS is a log-monitoring and incident-management platform. External applications ship structured logs through Filebeat into Elasticsearch; users then explore logs and telemetry in the React UI, while scheduled threshold evaluation can create incidents for triage. The UI also manages applications, servers, alert rules, users, and roles, with authentication, notifications, and audit trails supporting operations. The README documents the broad system integrations; source excerpts confirm selected frontend API calls and backend service contracts, but not all backend runtime wiring.

Main entry points: [`frontend/src/api/client.js`](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/api/client.js) (API Client), [`backend/src/main/java/com/elms/alert`](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/alert) (Threshold Evaluation), [`backend/src/main/java/com/elms/log/service/LogService.java`](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/backend/src/main/java/com/elms/log/service/LogService.java) (Log Query API), [`frontend/src/pages/Logs.jsx`](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Logs.jsx) (Log Explorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Log Ingestion"]
  node_applications(("Source Applications"))
  node_filebeat["Filebeat Shipper"]
  node_elasticsearch[("Elasticsearch Logs")]
  node_log_api["Log Query API<br/>[LogService.java]"]
  node_logs_ui["Log Explorer<br/>[Logs.jsx]"]
end

subgraph group_operations["Monitoring Operations"]
  node_alert_engine["Threshold Evaluation"]
  node_alert_ui["Alert Rules UI<br/>[AlertRules.jsx]"]
  node_incident_service["Incident Lifecycle"]
  node_incident_ui["Incident Command Center<br/>[Incidents.jsx]"]
  node_dashboard["Telemetry Dashboard"]
  node_dashboard_ui["Dashboard UI<br/>[Dashboard.jsx]"]
  node_reports["Reports"]
  node_reports_ui["Reports UI<br/>[Reports.jsx]"]
end

subgraph group_management["Platform Management"]
  node_app_registry["Application Registry"]
  node_apps_ui["Applications UI<br/>[Applications.jsx]"]
  node_servers["Server Management"]
  node_server_ui["Servers UI<br/>[Servers.jsx]"]
  node_admin["Users and Roles"]
  node_admin_ui["Admin Screens<br/>[UsersPage.jsx]"]
end

subgraph group_access["Access and Support"]
  node_auth["Authentication and RBAC"]
  node_auth_ui["Frontend Authentication<br/>[AuthContext.jsx]"]
  node_api_client["API Client<br/>[client.js]"]
  node_audit["Audit Trail"]
  node_notifications["Notifications"]
end

node_user(("ELMS User"))

node_applications -->|"emits structured logs"| node_filebeat
node_filebeat -->|"ships and indexes"| node_elasticsearch
node_elasticsearch -->|"supplies log searches"| node_log_api
node_user -->|"explores logs"| node_logs_ui
node_logs_ui -.->|"requests log data"| node_api_client
node_api_client -->|"calls REST API"| node_log_api
node_user -->|"registers services"| node_apps_ui
node_apps_ui -->|"fetches and updates"| node_api_client
node_api_client -->|"calls REST API"| node_app_registry
node_user -->|"manages servers"| node_server_ui
node_server_ui -.->|"uses API"| node_api_client
node_api_client -.->|"calls REST API"| node_servers
node_alert_engine -->|"evaluates log counts"| node_elasticsearch
node_alert_engine -->|"creates auto incidents"| node_incident_service
node_user -->|"configures thresholds"| node_alert_ui
node_alert_ui -.->|"uses API"| node_api_client
node_api_client -.->|"calls REST API"| node_alert_engine
node_user -->|"triages incidents"| node_incident_ui
node_incident_ui -.->|"uses API"| node_api_client
node_api_client -->|"calls REST API"| node_incident_service
node_user -->|"views telemetry"| node_dashboard_ui
node_dashboard_ui -.->|"uses API"| node_api_client
node_dashboard -.->|"uses log metrics"| node_log_api
node_auth_ui -->|"sends login requests"| node_api_client
node_api_client -->|"calls auth endpoints"| node_auth
node_user -->|"authenticates"| node_auth_ui
node_user -->|"administers access"| node_admin_ui
node_admin_ui -.->|"uses API"| node_api_client
node_api_client -.->|"calls REST API"| node_admin
node_user -->|"requests reports"| node_reports_ui
node_reports_ui -.->|"uses API"| node_api_client
node_api_client -.->|"calls REST API"| node_reports
node_user -->|"receives notifications"| node_notifications
node_user -->|"accesses audit trail"| node_audit

click node_log_api "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/backend/src/main/java/com/elms/log/service/LogService.java"
click node_logs_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Logs.jsx"
click node_app_registry "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/application"
click node_apps_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Applications.jsx"
click node_servers "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/server"
click node_server_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Servers.jsx"
click node_alert_engine "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/alert"
click node_alert_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/AlertRules.jsx"
click node_incident_service "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/incident"
click node_incident_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Incidents.jsx"
click node_dashboard "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/dashboard"
click node_dashboard_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Dashboard.jsx"
click node_auth "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/auth"
click node_auth_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/api/client.js"
click node_audit "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/audit"
click node_notifications "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/notification"
click node_admin "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/user"
click node_admin_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/UsersPage.jsx"
click node_reports "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/report"
click node_reports_ui "https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Reports.jsx"

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_applications,node_filebeat,node_elasticsearch,node_log_api,node_logs_ui,node_user toneBlue
class node_alert_engine,node_alert_ui,node_incident_service,node_incident_ui,node_dashboard,node_dashboard_ui,node_reports,node_reports_ui toneAmber
class node_app_registry,node_apps_ui,node_servers,node_server_ui,node_admin,node_admin_ui toneMint
class node_auth,node_auth_ui,node_api_client,node_audit,node_notifications toneRose
```

## Components

### Log Ingestion

- **Source Applications**
- **Filebeat Shipper**
- **Elasticsearch Logs**
- [Log Query API](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/backend/src/main/java/com/elms/log/service/LogService.java): `backend/src/main/java/com/elms/log/service/LogService.java`
- [Log Explorer](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Logs.jsx): `frontend/src/pages/Logs.jsx`

### Monitoring Operations

- [Threshold Evaluation](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/alert): `backend/src/main/java/com/elms/alert`
- [Alert Rules UI](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/AlertRules.jsx): `frontend/src/pages/AlertRules.jsx`
- [Incident Lifecycle](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/incident): `backend/src/main/java/com/elms/incident`
- [Incident Command Center](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Incidents.jsx): `frontend/src/pages/Incidents.jsx`
- [Telemetry Dashboard](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/dashboard): `backend/src/main/java/com/elms/dashboard`
- [Dashboard UI](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Reports](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/report): `backend/src/main/java/com/elms/report`
- [Reports UI](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Reports.jsx): `frontend/src/pages/Reports.jsx`

### Platform Management

- [Application Registry](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/application): `backend/src/main/java/com/elms/application`
- [Applications UI](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Applications.jsx): `frontend/src/pages/Applications.jsx`
- [Server Management](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/server): `backend/src/main/java/com/elms/server`
- [Servers UI](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/Servers.jsx): `frontend/src/pages/Servers.jsx`
- [Users and Roles](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/user): `backend/src/main/java/com/elms/user`
- [Admin Screens](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/pages/UsersPage.jsx): `frontend/src/pages/UsersPage.jsx`

### Access and Support

- [Authentication and RBAC](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/auth): `backend/src/main/java/com/elms/auth`
- [Frontend Authentication](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API Client](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Audit Trail](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/audit): `backend/src/main/java/com/elms/audit`
- [Notifications](https://github.com/amanjeet233/enterprise-log-monitoring-and-incident-management-system/tree/main/backend/src/main/java/com/elms/notification): `backend/src/main/java/com/elms/notification`

### Other components

- **ELMS User**

## Connections

- Source Applications → Filebeat Shipper: emits structured logs
- Filebeat Shipper → Elasticsearch Logs: ships and indexes
- Elasticsearch Logs → Log Query API: supplies log searches
- ELMS User → Log Explorer: explores logs
- Log Explorer → API Client: requests log data
- API Client → Log Query API: calls REST API
- ELMS User → Applications UI: registers services
- Applications UI → API Client: fetches and updates (evidence: `frontend/src/pages/Applications.jsx`)
- API Client → Application Registry: calls REST API
- ELMS User → Servers UI: manages servers
- Servers UI → API Client: uses API (evidence: `frontend/src/pages/Servers.jsx`)
- API Client → Server Management: calls REST API
- Threshold Evaluation → Elasticsearch Logs: evaluates log counts
- Threshold Evaluation → Incident Lifecycle: creates auto incidents
- ELMS User → Alert Rules UI: configures thresholds
- Alert Rules UI → API Client: uses API (evidence: `frontend/src/pages/AlertRules.jsx`)
- API Client → Threshold Evaluation: calls REST API
- ELMS User → Incident Command Center: triages incidents
- Incident Command Center → API Client: uses API (evidence: `frontend/src/pages/Incidents.jsx`)
- API Client → Incident Lifecycle: calls REST API (evidence: `backend/src/main/java/com/elms/incident/controller/IncidentController.java`)
- ELMS User → Dashboard UI: views telemetry
- Dashboard UI → API Client: uses API
- Telemetry Dashboard → Log Query API: uses log metrics (evidence: `backend/src/main/java/com/elms/log/service/LogService.java`)
- Frontend Authentication → API Client: sends login requests (evidence: `frontend/src/context/AuthContext.jsx`)
- API Client → Authentication and RBAC: calls auth endpoints
- ELMS User → Frontend Authentication: authenticates (evidence: `frontend/src/context/AuthContext.jsx`)
- ELMS User → Admin Screens: administers access
- Admin Screens → API Client: uses API
- API Client → Users and Roles: calls REST API
- ELMS User → Reports UI: requests reports
- Reports UI → API Client: uses API
- API Client → Reports: calls REST API
- ELMS User → Notifications: receives notifications
- ELMS User → Audit Trail: accesses audit trail
