diff --git a/README.md b/README.md index 084e470..c508295 100644 --- a/README.md +++ b/README.md @@ -39,10 +39,10 @@ Zero-data-loss **Appliance Setup & Migration Wizard** safely detecting and impor ![NaxOS Migration Wizard](docs/images/migration-wizard.png) -### 4. Embedded CNCF Perses Native Analytics -CNCF Perses embedded dashboards replacing standalone Grafana for real-time ZFS ARC hit ratios (98.6%), IOPS latency, 10GbE network traffic with BBR congestion control, and CPU distribution. +### 4. Seamless Integrated Real-Time Telemetry +Embedded live telemetry replacing standalone Grafana for real-time ZFS ARC hit ratios (98.6%), storage pool I/O bandwidth, multi-core CPU load, and dynamic RAM footprint directly woven into the appliance interface. -![NaxOS Perses Analytics](docs/images/perses-analytics.png) +![NaxOS System Telemetry](docs/images/system-telemetry.png) ### 5. App Store & Tri-Tier Workload Runtime Engine Curated 1-click self-hosted application catalog with hardware-accelerated Immich (Intel QuickSync QSV / OpenCL), Nextcloud, Jellyfin, and Vaultwarden. Supports runtime toggling between **Native Systemd**, **Rootless Docker**, and **K3s**. diff --git a/docs/architecture/perses-analytics.md b/docs/architecture/perses-analytics.md index 8cd49f2..070956b 100644 --- a/docs/architecture/perses-analytics.md +++ b/docs/architecture/perses-analytics.md @@ -1,18 +1,19 @@ -# CNCF Perses Native Analytics Architecture +# Integrated Real-Time Telemetry & Metrics Architecture -## Why Perses over Standalone Grafana? +## Seamless In-App Telemetry vs. Standalone Grafana -Traditional NAS appliances that provide telemetry either bundle a heavy standalone Grafana instance (which requires its own SQLite/PostgreSQL database, user accounts, and separate session cookies) or write rudimentary, un-configurable charts into their dashboard. +Traditional NAS appliances that provide telemetry either bundle a heavy standalone Grafana instance (which requires its own SQLite/PostgreSQL database, user accounts, and separate session cookies) or isolate graphs into a disconnected, foreign tab. -NaxOS takes a pioneering approach by integrating **Perses** (a Cloud Native Computing Foundation project): +NaxOS takes a pioneering approach by integrating **Perses** (a Cloud Native Computing Foundation project) as the underlying declarative telemetry engine, weaving real-time metrics directly into the core appliance dashboard and storage views: 1. **GitOps & Declarative Native**: - - Perses dashboards and datasources are written in clean JSON/CUE manifests. + - Perses dashboards and datasources are written in clean declarative JSON/CUE manifests. - Dashboards are checked into `/var/lib/perses/projects/naxos/dashboards` as code. 2. **Embedded Direct Visualization**: - - The NaxOS Web Dashboard communicates with the internal Perses metrics API. + - The NaxOS Web Dashboard seamlessly communicates with the internal Perses metrics API. - Eliminates Grafana's multi-megabyte bundle overhead, auth barriers, and database schema migrations. + - Telemetry widgets live naturally alongside storage pool management, active workloads, and system status. 3. **Optimized for OpenZFS Metrics**: - Out-of-the-box panels monitor OpenZFS ARC hits, misses, ARC target sizing, IOPS, and disk latencies scraped from Prometheus and Node Exporter. -![Embedded CNCF Perses Analytics](../images/perses-analytics.png) +![Seamless Integrated Telemetry in NaxOS](../images/system-telemetry.png) diff --git a/docs/images/app-store.png b/docs/images/app-store.png index b5dccc4..8f9ac61 100644 Binary files a/docs/images/app-store.png and b/docs/images/app-store.png differ diff --git a/docs/images/dashboard-overview.png b/docs/images/dashboard-overview.png index 3df57f0..cb0c6fa 100644 Binary files a/docs/images/dashboard-overview.png and b/docs/images/dashboard-overview.png differ diff --git a/docs/images/gitops-sync.png b/docs/images/gitops-sync.png index b71dc4e..13ab350 100644 Binary files a/docs/images/gitops-sync.png and b/docs/images/gitops-sync.png differ diff --git a/docs/images/migration-wizard.png b/docs/images/migration-wizard.png index fc96472..da43874 100644 Binary files a/docs/images/migration-wizard.png and b/docs/images/migration-wizard.png differ diff --git a/docs/images/perses-analytics.png b/docs/images/perses-analytics.png index 7c8963d..5fe3edd 100644 Binary files a/docs/images/perses-analytics.png and b/docs/images/perses-analytics.png differ diff --git a/docs/images/shares-management.png b/docs/images/shares-management.png index 1bebfb1..496e0cd 100644 Binary files a/docs/images/shares-management.png and b/docs/images/shares-management.png differ diff --git a/docs/images/storage-management.png b/docs/images/storage-management.png index 6fbc729..d5b5f97 100644 Binary files a/docs/images/storage-management.png and b/docs/images/storage-management.png differ diff --git a/docs/images/system-logs.png b/docs/images/system-logs.png index 850e05d..9a8f568 100644 Binary files a/docs/images/system-logs.png and b/docs/images/system-logs.png differ diff --git a/docs/images/system-telemetry.png b/docs/images/system-telemetry.png new file mode 100644 index 0000000..5eadf70 Binary files /dev/null and b/docs/images/system-telemetry.png differ