# mohammed-mojaly/laralyze architecture

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

- Interactive diagram: https://gitdiagram.com/mohammed-mojaly/laralyze
- Repository: https://github.com/mohammed-mojaly/laralyze

## Overview

Laralyze is a self-hosted Laravel production-monitoring package. Its main workflow records application activity, ingests and stores measurements, then serves dashboard pages and execution timelines. It also provides database-health reporting, configurable alerts, and an AI assistant. The graph preserves the documented monitoring categories without enumerating every card. Some wiring is supported only by README statements and source-index references; unsampled implementation details are not assumed.

Main entry points: [`src/Recorders/Recorder.php`](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Recorder.php) (Activity recorders), [`src/Contracts/Storage.php`](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Contracts/Storage.php) (Storage interface), [`src/Livewire/Card.php`](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Livewire/Card.php) (Livewire cards), [`src/Recorders/Queries.php`](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Queries.php) (Query recorder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Capture and ingest"]
  node_recorders["Activity recorders<br/>[Recorder.php]"]
  node_request_recorder["Request recorder<br/>[Requests.php]"]
  node_query_recorder["Query recorder<br/>[Queries.php]"]
  node_cache_recorder["Cache recorder<br/>[Cache.php]"]
  node_database_recorder["Database recorder<br/>[Database.php]"]
  node_ingest_contract["Ingest interface<br/>[Ingest.php]"]
  node_db_ingest["Queued ingestion<br/>[DatabaseIngest.php]"]
end

subgraph group_storage["Storage and metrics"]
  node_storage_contract["Storage interface<br/>[Storage.php]"]
  node_db_storage[("Database storage")]
  node_ch_storage[("ClickHouse storage")]
  node_metrics["Metric histograms<br/>[Histogram.php]"]
end

subgraph group_dashboard["Dashboard and diagnostics"]
  node_dashboard_pages["Dashboard pages<br/>[Pages.php]"]
  node_livewire_cards["Livewire cards<br/>[Card.php]"]
  node_route_card["Route metrics card<br/>[Routes.php]"]
  node_database_health["Database health<br/>[Incidents.php]"]
  node_formatting["Metric formatting<br/>[Format.php]"]
end

subgraph group_alerts["Alerts"]
  node_alert_rules["Alert rules<br/>[Rule.php]"]
  node_alert_runner["Alert evaluation<br/>[Alerts.php]"]
end

subgraph group_assistant["AI assistant"]
  node_assistant["Monitoring assistant<br/>[Assistant.php]"]
  node_chats["Assistant chats<br/>[Chats.php]"]
end

node_app(("Laravel application"))

node_app -->|"emits activity"| node_recorders
node_request_recorder -->|"extends"| node_recorders
node_query_recorder -->|"extends"| node_recorders
node_cache_recorder -->|"extends"| node_recorders
node_database_recorder -->|"extends"| node_recorders
node_recorders -.->|"flushes via"| node_ingest_contract
node_db_ingest -->|"implements"| node_ingest_contract
node_db_ingest -->|"writes batches"| node_db_storage
node_storage_contract -->|"implemented by"| node_db_storage
node_storage_contract -->|"implemented by"| node_ch_storage
node_query_recorder -->|"uses histograms"| node_metrics
node_dashboard_pages -->|"provides dashboard"| node_livewire_cards
node_route_card -->|"extends"| node_livewire_cards
node_route_card -->|"reads request metrics"| node_request_recorder
node_livewire_cards -->|"queries stored data"| node_storage_contract
node_database_recorder -->|"tracks incidents"| node_database_health
node_database_health -->|"uses formatting"| node_formatting
node_alert_runner -->|"evaluates rules"| node_alert_rules
node_alert_runner -->|"checks storage"| node_storage_contract
node_assistant -->|"supports conversations"| node_chats
node_chats -->|"stores chats"| node_storage_contract
node_assistant -.->|"interprets monitoring data"| node_metrics

click node_recorders "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Recorder.php"
click node_request_recorder "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Requests.php"
click node_query_recorder "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Queries.php"
click node_cache_recorder "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Cache.php"
click node_database_recorder "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Database.php"
click node_ingest_contract "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Contracts/Ingest.php"
click node_db_ingest "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Ingest/DatabaseIngest.php"
click node_storage_contract "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Contracts/Storage.php"
click node_db_storage "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Storage/DatabaseStorage.php"
click node_ch_storage "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Storage/ClickHouseStorage.php"
click node_metrics "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Metrics/Histogram.php"
click node_dashboard_pages "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Dashboard/Pages.php"
click node_livewire_cards "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Livewire/Card.php"
click node_route_card "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Cards/Routes.php"
click node_database_health "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Database/Incidents.php"
click node_formatting "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Support/Format.php"
click node_alert_rules "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Alerts/Rule.php"
click node_alert_runner "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Alerts/Alerts.php"
click node_assistant "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Assistant/Assistant.php"
click node_chats "https://github.com/mohammed-mojaly/laralyze/blob/main/src/Assistant/Chats.php"

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_recorders,node_request_recorder,node_query_recorder,node_cache_recorder,node_database_recorder,node_ingest_contract,node_db_ingest toneBlue
class node_storage_contract,node_db_storage,node_ch_storage,node_metrics toneAmber
class node_dashboard_pages,node_livewire_cards,node_route_card,node_database_health,node_formatting toneMint
class node_alert_rules,node_alert_runner toneRose
class node_assistant,node_chats,node_app toneIndigo
```

## Components

### Capture and ingest

- [Activity recorders](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Recorder.php): `src/Recorders/Recorder.php`
- [Request recorder](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Requests.php): `src/Recorders/Requests.php`
- [Query recorder](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Queries.php): `src/Recorders/Queries.php`
- [Cache recorder](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Cache.php): `src/Recorders/Cache.php`
- [Database recorder](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Recorders/Database.php): `src/Recorders/Database.php`
- [Ingest interface](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Contracts/Ingest.php): `src/Contracts/Ingest.php`
- [Queued ingestion](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Ingest/DatabaseIngest.php): `src/Ingest/DatabaseIngest.php`

### Storage and metrics

- [Storage interface](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Contracts/Storage.php): `src/Contracts/Storage.php`
- [Database storage](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Storage/DatabaseStorage.php): `src/Storage/DatabaseStorage.php`
- [ClickHouse storage](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Storage/ClickHouseStorage.php): `src/Storage/ClickHouseStorage.php`
- [Metric histograms](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Metrics/Histogram.php): `src/Metrics/Histogram.php`

### Dashboard and diagnostics

- [Dashboard pages](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Dashboard/Pages.php): `src/Dashboard/Pages.php`
- [Livewire cards](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Livewire/Card.php): `src/Livewire/Card.php`
- [Route metrics card](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Cards/Routes.php): `src/Cards/Routes.php`
- [Database health](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Database/Incidents.php): `src/Database/Incidents.php`
- [Metric formatting](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Support/Format.php): `src/Support/Format.php`

### Alerts

- [Alert rules](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Alerts/Rule.php): `src/Alerts/Rule.php`
- [Alert evaluation](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Alerts/Alerts.php): `src/Alerts/Alerts.php`

### AI assistant

- [Monitoring assistant](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Assistant/Assistant.php): `src/Assistant/Assistant.php`
- [Assistant chats](https://github.com/mohammed-mojaly/laralyze/blob/main/src/Assistant/Chats.php): `src/Assistant/Chats.php`

### Other components

- **Laravel application**

## Connections

- Laravel application → Activity recorders: emits activity (evidence: `README.md`)
- Request recorder → Activity recorders: extends (evidence: `src/Recorders/Requests.php`)
- Query recorder → Activity recorders: extends (evidence: `src/Recorders/Queries.php`)
- Cache recorder → Activity recorders: extends (evidence: `src/Recorders/Cache.php`)
- Database recorder → Activity recorders: extends (evidence: `src/Recorders/Database.php`)
- Activity recorders → Ingest interface: flushes via
- Queued ingestion → Ingest interface: implements (evidence: `src/Ingest/DatabaseIngest.php`)
- Queued ingestion → Database storage: writes batches (evidence: `src/Ingest/DatabaseIngest.php`)
- Storage interface → Database storage: implemented by (evidence: `src/Storage/DatabaseStorage.php`)
- Storage interface → ClickHouse storage: implemented by (evidence: `src/Storage/ClickHouseStorage.php`)
- Query recorder → Metric histograms: uses histograms (evidence: `src/Recorders/Queries.php`)
- Dashboard pages → Livewire cards: provides dashboard (evidence: `src/Dashboard/Pages.php`)
- Route metrics card → Livewire cards: extends (evidence: `src/Cards/Routes.php`)
- Route metrics card → Request recorder: reads request metrics (evidence: `src/Cards/Routes.php`)
- Livewire cards → Storage interface: queries stored data (evidence: `src/Livewire/Card.php`)
- Database recorder → Database health: tracks incidents (evidence: `src/Recorders/Database.php`)
- Database health → Metric formatting: uses formatting (evidence: `src/Database/Incidents.php`)
- Alert evaluation → Alert rules: evaluates rules (evidence: `src/Alerts/Alerts.php`)
- Alert evaluation → Storage interface: checks storage (evidence: `src/Alerts/Alerts.php`)
- Monitoring assistant → Assistant chats: supports conversations (evidence: `src/Assistant/Chats.php`)
- Assistant chats → Storage interface: stores chats (evidence: `src/Assistant/Chats.php`)
- Monitoring assistant → Metric histograms: interprets monitoring data
