From ea8cde3dfc043700713819c96564d4236f008542 Mon Sep 17 00:00:00 2001
From: Chase Dumphord <60725859+ced4568@users.noreply.github.com>
Date: Tue, 28 Apr 2026 10:53:43 -0500
Subject: [PATCH] Add observability architecture documentation

This document outlines the architecture of Ced's Observability Stack, detailing its components and their interactions.
---
 architecture/observability-architecture.md | 51 ++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/architecture/observability-architecture.md b/architecture/observability-architecture.md
index e69de29..c1f38cc 100644
--- a/architecture/observability-architecture.md
+++ b/architecture/observability-architecture.md
@@ -0,0 +1,51 @@
+```markdown
+# Observability Architecture
+
+## Purpose
+
+This document explains the architecture of Ced’s Observability Stack.
+
+The observability stack collects, stores, and visualizes metrics from Ced’s HomeLab infrastructure.
+
+---
+
+## High-Level Design
+
+```mermaid
+flowchart LR
+    subgraph Infrastructure
+        PVE[Proxmox HA Cluster]
+        K3S[12-Node K3s Cluster]
+        TN[TrueNAS]
+        NPM[Nginx Proxy Manager]
+        SVC[Homelab Services]
+    end
+
+    subgraph Metrics
+        NE[Node Exporter]
+        PME[Proxmox Exporter]
+        KSM[Kube-State-Metrics]
+        HC[Health Check Scripts]
+    end
+
+    subgraph Observability
+        PROM[Prometheus]
+        GRAF[Grafana]
+        ALERT[Alertmanager]
+    end
+
+    PVE --> PME
+    K3S --> KSM
+    SVC --> HC
+    TN --> HC
+    NPM --> HC
+
+    PME --> PROM
+    KSM --> PROM
+    NE --> PROM
+    HC --> PROM
+
+    PROM --> GRAF
+    PROM --> ALERT
+
+    GRAF --> NOC[Ced's NOC]