# snippycode101/sysmon architecture

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

- Interactive diagram: https://gitdiagram.com/snippycode101/sysmon
- Repository: https://github.com/snippycode101/sysmon

## Overview

sysmon is a Linux resource-monitoring service: its entrypoint starts periodic `/proc` sampling alongside an HTTP API, and clients retrieve metrics and threshold alerts as JSON. The collector calculates CPU, memory, and load, checks configured thresholds, and writes snapshots and alerts to a synchronized in-memory store; API handlers read that state. The README documents graceful shutdown and all three endpoints. Relationships are shown where supported by the excerpts; `/proc` inputs are external to the repository.

Main entry points: [`internal/collector/collector.go`](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go) (Periodic collector), [`internal/api/api.go`](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go) (Route registration), [`cmd/sysmon/main.go`](https://github.com/snippycode101/sysmon/blob/main/cmd/sysmon/main.go) (Service entrypoint), [`internal/store/store.go`](https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go) (In-memory store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Service runtime"]
  node_entrypoint["Service entrypoint<br/>[main.go]"]
end

subgraph group_collection["Resource collection"]
  node_collector["Periodic collector<br/>[collector.go]"]
  node_cpu["CPU sampling<br/>[collector.go]"]
  node_memory["Memory sampling<br/>[collector.go]"]
  node_load["Load sampling<br/>[collector.go]"]
  node_thresholds["Threshold checks<br/>[collector.go]"]
end

subgraph group_state["Shared state"]
  node_store[("In-memory store<br/>[store.go]")]
  node_snapshot["Latest snapshot<br/>[store.go]"]
  node_history["Alert history<br/>[store.go]"]
end

subgraph group_api["HTTP API"]
  node_api["HTTP server setup<br/>[api.go]"]
  node_router["Route registration<br/>[api.go]"]
  node_logging["Request logging<br/>[api.go]"]
  node_health["Health endpoint<br/>[api.go]"]
  node_metrics["Metrics endpoint<br/>[api.go]"]
  node_alerts["Alerts endpoint<br/>[api.go]"]
end

node_operator(("Operator / client"))
node_procstat["/proc/stat"]
node_procmeminfo["/proc/meminfo"]
node_procloadavg["/proc/loadavg"]

node_entrypoint -->|"creates"| node_store
node_entrypoint -->|"configures and starts"| node_collector
node_entrypoint -->|"starts HTTP server"| node_api
node_collector -->|"samples"| node_cpu
node_collector -->|"samples"| node_memory
node_collector -->|"samples"| node_load
node_cpu -->|"reads"| node_procstat
node_memory -->|"reads"| node_procmeminfo
node_load -->|"reads"| node_procloadavg
node_collector -->|"checks snapshot"| node_thresholds
node_collector -->|"writes snapshot"| node_snapshot
node_thresholds -->|"appends breaches"| node_history
node_store -->|"holds"| node_snapshot
node_store -->|"bounds"| node_history
node_api -->|"builds routes"| node_router
node_router -->|"wraps handler"| node_logging
node_router -->|"routes"| node_health
node_router -->|"routes"| node_metrics
node_router -->|"routes"| node_alerts
node_metrics -->|"reads"| node_snapshot
node_alerts -->|"reads"| node_history
node_operator -->|"requests"| node_health
node_operator -->|"requests"| node_metrics
node_operator -->|"requests"| node_alerts

click node_entrypoint "https://github.com/snippycode101/sysmon/blob/main/cmd/sysmon/main.go"
click node_collector "https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go"
click node_cpu "https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go"
click node_memory "https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go"
click node_load "https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go"
click node_thresholds "https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go"
click node_store "https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go"
click node_snapshot "https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go"
click node_history "https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go"
click node_api "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"
click node_router "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"
click node_logging "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"
click node_health "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"
click node_metrics "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"
click node_alerts "https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go"

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_entrypoint,node_operator toneBlue
class node_collector,node_cpu,node_memory,node_load,node_thresholds toneAmber
class node_store,node_snapshot,node_history toneMint
class node_api,node_router,node_logging,node_health,node_metrics,node_alerts toneRose
class node_procstat,node_procmeminfo,node_procloadavg toneIndigo
```

## Components

### Service runtime

- [Service entrypoint](https://github.com/snippycode101/sysmon/blob/main/cmd/sysmon/main.go): `cmd/sysmon/main.go`

### Resource collection

- [Periodic collector](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go): `internal/collector/collector.go`
- [CPU sampling](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go): `internal/collector/collector.go`
- [Memory sampling](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go): `internal/collector/collector.go`
- [Load sampling](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go): `internal/collector/collector.go`
- [Threshold checks](https://github.com/snippycode101/sysmon/blob/main/internal/collector/collector.go): `internal/collector/collector.go`

### Shared state

- [In-memory store](https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go): `internal/store/store.go`
- [Latest snapshot](https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go): `internal/store/store.go`
- [Alert history](https://github.com/snippycode101/sysmon/blob/main/internal/store/store.go): `internal/store/store.go`

### HTTP API

- [HTTP server setup](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`
- [Route registration](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`
- [Request logging](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`
- [Health endpoint](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`
- [Metrics endpoint](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`
- [Alerts endpoint](https://github.com/snippycode101/sysmon/blob/main/internal/api/api.go): `internal/api/api.go`

### Other components

- **Operator / client**
- **/proc/stat**
- **/proc/meminfo**
- **/proc/loadavg**

## Connections

- Service entrypoint → In-memory store: creates (evidence: `cmd/sysmon/main.go`)
- Service entrypoint → Periodic collector: configures and starts (evidence: `cmd/sysmon/main.go`)
- Service entrypoint → HTTP server setup: starts HTTP server (evidence: `cmd/sysmon/main.go`)
- Periodic collector → CPU sampling: samples (evidence: `internal/collector/collector.go`)
- Periodic collector → Memory sampling: samples (evidence: `internal/collector/collector.go`)
- Periodic collector → Load sampling: samples (evidence: `internal/collector/collector.go`)
- CPU sampling → /proc/stat: reads (evidence: `internal/collector/collector.go`)
- Memory sampling → /proc/meminfo: reads (evidence: `internal/collector/collector.go`)
- Load sampling → /proc/loadavg: reads (evidence: `internal/collector/collector.go`)
- Periodic collector → Threshold checks: checks snapshot (evidence: `internal/collector/collector.go`)
- Periodic collector → Latest snapshot: writes snapshot (evidence: `internal/collector/collector.go`)
- Threshold checks → Alert history: appends breaches (evidence: `internal/collector/collector.go`)
- In-memory store → Latest snapshot: holds (evidence: `internal/store/store.go`)
- In-memory store → Alert history: bounds (evidence: `internal/store/store.go`)
- HTTP server setup → Route registration: builds routes (evidence: `internal/api/api.go`)
- Route registration → Request logging: wraps handler (evidence: `internal/api/api.go`)
- Route registration → Health endpoint: routes (evidence: `internal/api/api.go`)
- Route registration → Metrics endpoint: routes (evidence: `internal/api/api.go`)
- Route registration → Alerts endpoint: routes (evidence: `internal/api/api.go`)
- Metrics endpoint → Latest snapshot: reads (evidence: `internal/api/api.go`)
- Alerts endpoint → Alert history: reads (evidence: `internal/api/api.go`)
- Operator / client → Health endpoint: requests (evidence: `README.md`)
- Operator / client → Metrics endpoint: requests (evidence: `README.md`)
- Operator / client → Alerts endpoint: requests (evidence: `README.md`)
