# peviss/smartlog-analyzer architecture

> Architecture diagram of the GitHub repository peviss/smartlog-analyzer, 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/peviss/smartlog-analyzer
- Repository: https://github.com/peviss/smartlog-analyzer

## Overview

SmartLog Analyzer centralizes ECS-formatted microservice logs, supports ingestion, search and statistics, and produces AI summaries, problem categories, and suggested actions. Users move through the React UI to a FastAPI endpoint; log ingestion validates and stores documents, while analysis preprocesses matching logs and invokes a configurable LLM. The README documents mock and hosted/local providers. Some backend handlers and analysis modules were not excerpted, so their internal call relationships are shown only where the README or indexed references support them.

Main entry points: [`src/frontend/src/pages`](https://github.com/peviss/smartlog-analyzer/tree/main/src/frontend/src/pages) (Product views), [`src/api/main.py`](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/main.py) (FastAPI application), [`src/api/services/analysis.py`](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/analysis.py) (Analysis service), [`src/api/services/ingestion.py`](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/ingestion.py) (Ingestion service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_pages["Product views"]
  node_ui_client["Typed API client<br/>[client.ts]"]
  node_filter_state["Shared filters<br/>[filters.ts]"]
  node_ingest_ui["Ingest interface<br/>[IngestPage.tsx]"]
  node_import_ui["File import<br/>[ImportPanel.tsx]"]
  node_ui_results["Result display<br/>[IngestResults.tsx]"]
  node_ui_storage["Recent analyses<br/>[storage.ts]"]
end

subgraph group_api["API and use cases"]
  node_api["FastAPI application<br/>[main.py]"]
  node_log_routes["Log endpoints<br/>[logs.py]"]
  node_analysis_routes["Analysis endpoints<br/>[analysis.py]"]
  node_health_routes["Health endpoint<br/>[health.py]"]
  node_ingestion["Ingestion service<br/>[ingestion.py]"]
end

subgraph group_domain["Log domain"]
  node_raw_import["Raw log import"]
  node_ecs["ECS mapping<br/>[ecs.py]"]
  node_log_schema["Log validation<br/>[logs.py]"]
end

subgraph group_data["Persistence"]
  node_log_repository["Log repository<br/>[logs.py]"]
  node_database[("PostgreSQL")]
  node_tables["Log and analysis tables<br/>[tables.py]"]
end

subgraph group_ai["Analysis and AI"]
  node_analysis_service["Analysis service<br/>[analysis.py]"]
  node_patterns["Pattern extraction<br/>[patterns.py]"]
  node_llm_agent["Typed LLM agent<br/>[agent.py]"]
  node_llm_provider["LLM providers<br/>[providers.py]"]
end

node_user(("Operator"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_pages
node_app -->|"shares filters"| node_filter_state
node_pages -->|"requests data"| node_ui_client
node_pages -->|"builds queries"| node_filter_state
node_ingest_ui -->|"posts logs"| node_ui_client
node_import_ui -->|"submits imports"| node_ui_client
node_ingest_ui -->|"renders"| node_import_ui
node_ingest_ui -->|"shows outcomes"| node_ui_results
node_pages -->|"remembers analyses"| node_ui_storage
node_ui_client -->|"calls HTTP API"| node_api
node_api -->|"registers routes"| node_log_routes
node_api -->|"registers routes"| node_analysis_routes
node_api -->|"registers routes"| node_health_routes
node_log_routes -->|"delegates ingest"| node_ingestion
node_log_routes -->|"parses imports"| node_raw_import
node_ingestion -->|"validates records"| node_log_schema
node_ingestion -->|"stores valid logs"| node_log_repository
node_raw_import -.->|"supplies records"| node_ingestion
node_log_repository -->|"queries and writes"| node_tables
node_tables -->|"persists records"| node_database
node_log_schema -->|"normalizes ECS"| node_ecs
node_analysis_routes -.->|"delegates analysis"| node_analysis_service
node_analysis_service -.->|"extracts patterns"| node_patterns
node_analysis_service -.->|"requests analysis"| node_llm_agent
node_llm_agent -.->|"uses configured model"| node_llm_provider
node_analysis_service -.->|"persists outcomes"| node_database

click node_app "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/App.tsx"
click node_pages "https://github.com/peviss/smartlog-analyzer/tree/main/src/frontend/src/pages"
click node_ui_client "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/api/client.ts"
click node_filter_state "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/lib/filters.ts"
click node_ingest_ui "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/pages/IngestPage.tsx"
click node_import_ui "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/components/ImportPanel.tsx"
click node_ui_results "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/components/IngestResults.tsx"
click node_ui_storage "https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/lib/storage.ts"
click node_api "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/main.py"
click node_log_routes "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/logs.py"
click node_analysis_routes "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/analysis.py"
click node_health_routes "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/health.py"
click node_ingestion "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/ingestion.py"
click node_analysis_service "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/analysis.py"
click node_raw_import "https://github.com/peviss/smartlog-analyzer/tree/main/src/api/domain/raw_logs"
click node_ecs "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/domain/ecs.py"
click node_log_schema "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/schemas/logs.py"
click node_patterns "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/domain/patterns.py"
click node_llm_agent "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/llm/agent.py"
click node_llm_provider "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/llm/providers.py"
click node_log_repository "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/repositories/logs.py"
click node_tables "https://github.com/peviss/smartlog-analyzer/blob/main/src/api/database/tables.py"

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_app,node_pages,node_ui_client,node_filter_state,node_ingest_ui,node_import_ui,node_ui_results,node_ui_storage toneBlue
class node_api,node_log_routes,node_analysis_routes,node_health_routes,node_ingestion toneAmber
class node_raw_import,node_ecs,node_log_schema toneMint
class node_log_repository,node_database,node_tables toneRose
class node_analysis_service,node_patterns,node_llm_agent,node_llm_provider,node_user toneIndigo
```

## Components

### Web interface

- [App shell](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/App.tsx): `src/frontend/src/App.tsx`
- [Product views](https://github.com/peviss/smartlog-analyzer/tree/main/src/frontend/src/pages): `src/frontend/src/pages`
- [Typed API client](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/api/client.ts): `src/frontend/src/api/client.ts`
- [Shared filters](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/lib/filters.ts): `src/frontend/src/lib/filters.ts`
- [Ingest interface](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/pages/IngestPage.tsx): `src/frontend/src/pages/IngestPage.tsx`
- [File import](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/components/ImportPanel.tsx): `src/frontend/src/components/ImportPanel.tsx`
- [Result display](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/components/IngestResults.tsx): `src/frontend/src/components/IngestResults.tsx`
- [Recent analyses](https://github.com/peviss/smartlog-analyzer/blob/main/src/frontend/src/lib/storage.ts): `src/frontend/src/lib/storage.ts`

### API and use cases

- [FastAPI application](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/main.py): `src/api/main.py`
- [Log endpoints](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/logs.py): `src/api/routers/logs.py`
- [Analysis endpoints](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/analysis.py): `src/api/routers/analysis.py`
- [Health endpoint](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/routers/health.py): `src/api/routers/health.py`
- [Ingestion service](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/ingestion.py): `src/api/services/ingestion.py`

### Log domain

- [Raw log import](https://github.com/peviss/smartlog-analyzer/tree/main/src/api/domain/raw_logs): `src/api/domain/raw_logs`
- [ECS mapping](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/domain/ecs.py): `src/api/domain/ecs.py`
- [Log validation](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/schemas/logs.py): `src/api/schemas/logs.py`

### Persistence

- [Log repository](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/repositories/logs.py): `src/api/repositories/logs.py`
- **PostgreSQL**
- [Log and analysis tables](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/database/tables.py): `src/api/database/tables.py`

### Analysis and AI

- [Analysis service](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/services/analysis.py): `src/api/services/analysis.py`
- [Pattern extraction](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/domain/patterns.py): `src/api/domain/patterns.py`
- [Typed LLM agent](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/llm/agent.py): `src/api/llm/agent.py`
- [LLM providers](https://github.com/peviss/smartlog-analyzer/blob/main/src/api/llm/providers.py): `src/api/llm/providers.py`

### Other components

- **Operator**

## Connections

- Operator → App shell: uses (evidence: `README.md`)
- App shell → Product views: renders (evidence: `src/frontend/src/App.tsx`)
- App shell → Shared filters: shares filters (evidence: `src/frontend/src/App.tsx`)
- Product views → Typed API client: requests data (evidence: `src/frontend/src/api/client.ts`)
- Product views → Shared filters: builds queries (evidence: `src/frontend/src/lib/filters.ts`)
- Ingest interface → Typed API client: posts logs (evidence: `src/frontend/src/pages/IngestPage.tsx`)
- File import → Typed API client: submits imports (evidence: `src/frontend/src/components/ImportPanel.tsx`)
- Ingest interface → File import: renders (evidence: `src/frontend/src/components/ImportPanel.tsx`)
- Ingest interface → Result display: shows outcomes (evidence: `src/frontend/src/pages/IngestPage.tsx`)
- Product views → Recent analyses: remembers analyses (evidence: `src/frontend/src/pages/AnalysisPage.tsx`)
- Typed API client → FastAPI application: calls HTTP API (evidence: `src/frontend/src/api/client.ts`)
- FastAPI application → Log endpoints: registers routes
- FastAPI application → Analysis endpoints: registers routes
- FastAPI application → Health endpoint: registers routes
- Log endpoints → Ingestion service: delegates ingest (evidence: `src/api/routers/logs.py`)
- Log endpoints → Raw log import: parses imports (evidence: `src/api/routers/logs.py`)
- Ingestion service → Log validation: validates records (evidence: `src/api/services/ingestion.py`)
- Ingestion service → Log repository: stores valid logs (evidence: `src/api/services/ingestion.py`)
- Raw log import → Ingestion service: supplies records
- Log repository → Log and analysis tables: queries and writes (evidence: `src/api/repositories/logs.py`)
- Log and analysis tables → PostgreSQL: persists records (evidence: `src/api/database/tables.py`)
- Log validation → ECS mapping: normalizes ECS (evidence: `src/api/schemas/logs.py`)
- Analysis endpoints → Analysis service: delegates analysis
- Analysis service → Pattern extraction: extracts patterns
- Analysis service → Typed LLM agent: requests analysis
- Typed LLM agent → LLM providers: uses configured model
- Analysis service → PostgreSQL: persists outcomes
