From c71ae57cab44d04d97486572976b09f3616a49f9 Mon Sep 17 00:00:00 2001 From: "senol.colak" Date: Mon, 8 Jun 2026 14:27:24 +0200 Subject: [PATCH 1/7] docs: group cloud storage components under architecture/cloud-storage MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Move Ceph, Rook, Chorus, Arbiter, and Prysm into a dedicated `architecture/cloud-storage/` section so the sidebar reflects the logical relationship between these components — they are all part of the same storage stack rather than independent top-level topics. Add `cloud-storage/index.md` as the section landing page with a summary table linking all five components and describing their roles. Update `architecture/index.md` to point to the new group instead of linking Ceph directly. Internal cross-links between the moved files are unaffected since they are siblings within the same folder. --- docs/architecture/{ => cloud-storage}/arbiter.md | 0 docs/architecture/{ => cloud-storage}/ceph.md | 0 docs/architecture/{ => cloud-storage}/chorus.md | 0 docs/architecture/cloud-storage/index.md | 15 +++++++++++++++ docs/architecture/{ => cloud-storage}/prysm.md | 0 docs/architecture/{ => cloud-storage}/rook.md | 0 docs/architecture/index.md | 2 +- 7 files changed, 16 insertions(+), 1 deletion(-) rename docs/architecture/{ => cloud-storage}/arbiter.md (100%) rename docs/architecture/{ => cloud-storage}/ceph.md (100%) rename docs/architecture/{ => cloud-storage}/chorus.md (100%) create mode 100644 docs/architecture/cloud-storage/index.md rename docs/architecture/{ => cloud-storage}/prysm.md (100%) rename docs/architecture/{ => cloud-storage}/rook.md (100%) diff --git a/docs/architecture/arbiter.md b/docs/architecture/cloud-storage/arbiter.md similarity index 100% rename from docs/architecture/arbiter.md rename to docs/architecture/cloud-storage/arbiter.md diff --git a/docs/architecture/ceph.md b/docs/architecture/cloud-storage/ceph.md similarity index 100% rename from docs/architecture/ceph.md rename to docs/architecture/cloud-storage/ceph.md diff --git a/docs/architecture/chorus.md b/docs/architecture/cloud-storage/chorus.md similarity index 100% rename from docs/architecture/chorus.md rename to docs/architecture/cloud-storage/chorus.md diff --git a/docs/architecture/cloud-storage/index.md b/docs/architecture/cloud-storage/index.md new file mode 100644 index 0000000..dd266f2 --- /dev/null +++ b/docs/architecture/cloud-storage/index.md @@ -0,0 +1,15 @@ +--- +title: Cloud Storage +--- + +# Cloud Storage + +CobaltCore's cloud storage layer is built on [Ceph](./ceph.md), an open-source, distributed storage system that delivers object, block, and file storage in a single unified platform. The surrounding components manage its lifecycle, replication, observability, and high-availability configuration. + +| Component | Role | +|-----------|------| +| [Ceph](./ceph.md) | Distributed storage engine | +| [Rook](./rook.md) | Kubernetes operator that automates Ceph deployment and management | +| [Chorus](./chorus.md) | Data replication across object storage systems | +| [Arbiter](./arbiter.md) | External arbiter monitors for Ceph quorum in stretched clusters | +| [Prysm](./prysm.md) | Observability CLI for Ceph clusters and RGW deployments | diff --git a/docs/architecture/prysm.md b/docs/architecture/cloud-storage/prysm.md similarity index 100% rename from docs/architecture/prysm.md rename to docs/architecture/cloud-storage/prysm.md diff --git a/docs/architecture/rook.md b/docs/architecture/cloud-storage/rook.md similarity index 100% rename from docs/architecture/rook.md rename to docs/architecture/cloud-storage/rook.md diff --git a/docs/architecture/index.md b/docs/architecture/index.md index 5d44602..95e40bc 100644 --- a/docs/architecture/index.md +++ b/docs/architecture/index.md @@ -13,4 +13,4 @@ CobaltCore is built on top of OpenStack and IronCore, leveraging their capabilit - **Greenhouse**: The monitoring and management tool that provides insights into the health and performance of the CobaltCore environment. - [**HA Service**](./cluster#ha-service): The high availability service that ensures critical workloads remain operational even in the event of failures. - [**Cortex**](./cortex): Smart initial placement and scheduling service for compute, storage, and network in cloud-native cloud environments. -- [**Ceph**](./ceph): An all-in-one storage system that provides object, block, and file storage and delivers extraordinary scalability. +- [**Cloud Storage**](./cloud-storage): Ceph-based distributed storage stack including Rook, Chorus, Arbiter, and Prysm for lifecycle management, replication, quorum, and observability. From 9b53667dd1ab1c52e56dace6d4419fecf0922932 Mon Sep 17 00:00:00 2001 From: "senol.colak" Date: Mon, 8 Jun 2026 14:39:26 +0200 Subject: [PATCH 2/7] fix: correct dead links after cloud-storage folder restructure - rook.md: update ../cluster.md path (moved one level deeper) - architecture/index.md: add trailing slash to cloud-storage link --- docs/architecture/cloud-storage/rook.md | 2 +- docs/architecture/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/architecture/cloud-storage/rook.md b/docs/architecture/cloud-storage/rook.md index 3466087..b803e14 100644 --- a/docs/architecture/cloud-storage/rook.md +++ b/docs/architecture/cloud-storage/rook.md @@ -28,7 +28,7 @@ mechanisms. Rook continuously monitors cluster health and automatically responds to failures by restarting failed daemons, replacing unhealthy OSDs, and maintaining desired state as defined in the cluster specifications. It -integrates with [Kubernetes](./cluster.md) monitoring and logging systems, +integrates with [Kubernetes](../cluster.md) monitoring and logging systems, providing visibility into storage operations alongside application workloads. ## See Also diff --git a/docs/architecture/index.md b/docs/architecture/index.md index 95e40bc..1c01177 100644 --- a/docs/architecture/index.md +++ b/docs/architecture/index.md @@ -13,4 +13,4 @@ CobaltCore is built on top of OpenStack and IronCore, leveraging their capabilit - **Greenhouse**: The monitoring and management tool that provides insights into the health and performance of the CobaltCore environment. - [**HA Service**](./cluster#ha-service): The high availability service that ensures critical workloads remain operational even in the event of failures. - [**Cortex**](./cortex): Smart initial placement and scheduling service for compute, storage, and network in cloud-native cloud environments. -- [**Cloud Storage**](./cloud-storage): Ceph-based distributed storage stack including Rook, Chorus, Arbiter, and Prysm for lifecycle management, replication, quorum, and observability. +- [**Cloud Storage**](./cloud-storage/): Ceph-based distributed storage stack including Rook, Chorus, Arbiter, and Prysm for lifecycle management, replication, quorum, and observability. From 9201f7be511dea1a0ac07842f359595361730a52 Mon Sep 17 00:00:00 2001 From: "senol.colak" Date: Tue, 9 Jun 2026 14:47:47 +0200 Subject: [PATCH 3/7] docs: expand cloud-storage section with Overview, Liquid-Ceph, and Observability Enrich the cloud-storage sidebar with: - **Overview** (index.md): rewritten with full architecture description, component table, storage interface summary (RBD/CephFS/RGW), data flow diagram, and HA explanation. Replaces the previous thin component list. - **Liquid-Ceph** (liquid-ceph.md): new page introducing the dynamic storage allocation component with a placeholder for upcoming detail. - **Observability/** (new subfolder): dedicated subsection covering the monitoring stack for cloud storage. - index.md: overview of key metric categories and alerting strategy - prometheus.md: exporter sources, retention, and alert rule catalogue - perses.md: dashboard inventory and dashboard-as-code approach Sidebar will now render: Cloud Storage > Overview, Ceph, Rook, Prysm, Chorus, Arbiter, Liquid-Ceph, Observability > (Overview, Prometheus, Perses) --- docs/architecture/cloud-storage/index.md | 79 ++++++++++++++++--- .../architecture/cloud-storage/liquid-ceph.md | 16 ++++ .../cloud-storage/observability/index.md | 35 ++++++++ .../cloud-storage/observability/perses.md | 30 +++++++ .../cloud-storage/observability/prometheus.md | 37 +++++++++ 5 files changed, 187 insertions(+), 10 deletions(-) create mode 100644 docs/architecture/cloud-storage/liquid-ceph.md create mode 100644 docs/architecture/cloud-storage/observability/index.md create mode 100644 docs/architecture/cloud-storage/observability/perses.md create mode 100644 docs/architecture/cloud-storage/observability/prometheus.md diff --git a/docs/architecture/cloud-storage/index.md b/docs/architecture/cloud-storage/index.md index dd266f2..2ec1a11 100644 --- a/docs/architecture/cloud-storage/index.md +++ b/docs/architecture/cloud-storage/index.md @@ -1,15 +1,74 @@ --- -title: Cloud Storage +title: Overview --- -# Cloud Storage +# Cloud Storage Overview -CobaltCore's cloud storage layer is built on [Ceph](./ceph.md), an open-source, distributed storage system that delivers object, block, and file storage in a single unified platform. The surrounding components manage its lifecycle, replication, observability, and high-availability configuration. +CobaltCore's cloud storage layer is built on [Ceph](./ceph.md), a distributed storage system that delivers object, block, and file storage in a single unified platform. The surrounding components handle lifecycle automation, data replication, high-availability quorum, observability, and liquid storage allocation — each with a focused responsibility. -| Component | Role | -|-----------|------| -| [Ceph](./ceph.md) | Distributed storage engine | -| [Rook](./rook.md) | Kubernetes operator that automates Ceph deployment and management | -| [Chorus](./chorus.md) | Data replication across object storage systems | -| [Arbiter](./arbiter.md) | External arbiter monitors for Ceph quorum in stretched clusters | -| [Prysm](./prysm.md) | Observability CLI for Ceph clusters and RGW deployments | +## Architecture + +The storage stack is organized into three layers: + +**Foundation** — Ceph provides the core distributed storage engine. All other components either operate it, extend it, or observe it. + +**Operations** — [Rook](./rook.md) runs as a Kubernetes operator and manages the full lifecycle of Ceph daemons (monitors, managers, OSDs, MDS, RGW) as containerized workloads. [Arbiter](./arbiter.md) extends quorum into stretched cluster topologies by deploying external Ceph monitors that Rook does not manage directly. + +**Data Services** — [Chorus](./chorus.md) provides zero-downtime data replication and migration between object storage systems (S3 and Swift). [Liquid-Ceph](./liquid-ceph.md) enables dynamic, on-demand storage allocation across the cluster. [Prysm](./prysm.md) delivers a CLI-based observability layer over Ceph clusters and RGW deployments. + +## Components + +| Component | Layer | Role | +|-----------|-------|------| +| [Ceph](./ceph.md) | Foundation | Distributed storage engine — block (RBD), file (CephFS), object (RGW) | +| [Rook](./rook.md) | Operations | Kubernetes operator for Ceph lifecycle management | +| [Arbiter](./arbiter.md) | Operations | External Ceph monitors for quorum in stretched clusters | +| [Chorus](./chorus.md) | Data Services | Zero-downtime object storage replication and migration | +| [Liquid-Ceph](./liquid-ceph.md) | Data Services | Dynamic storage allocation across the Ceph cluster | +| [Prysm](./prysm.md) | Data Services | Observability CLI for Ceph clusters and RGW | +| [Observability](./observability/) | Observability | Metrics, dashboards, and alerting for the storage stack | + +## Storage Interfaces + +Ceph exposes three storage interfaces that CobaltCore services consume: + +- **RBD (RADOS Block Device)** — thin-provisioned, resizable block volumes used by virtual machines and databases. Striped across OSDs for parallel I/O and backed by RADOS snapshots and replication. +- **CephFS** — POSIX-compliant distributed filesystem. Metadata is managed by a dedicated MDS cluster; data is striped across OSDs. Supports snapshots, quotas, and multiple active MDS daemons for horizontal metadata scaling. +- **RGW (RADOS Gateway)** — S3 and Swift-compatible object storage gateway. Supports multi-tenancy, versioning, lifecycle policies, server-side encryption, and multi-site active-active replication. + +## Data Flow + +``` +Applications / VMs + │ +┌───────┴────────────────────┐ +│ RBD │ CephFS │ RGW │ ← Ceph interfaces +└───────┴────────────────────┘ + │ + RADOS (Reliable Autonomic Distributed Object Store) + │ + OSDs across cluster nodes + │ + ┌────┴─────┐ + │ Rook │ ← manages daemon lifecycle via Kubernetes CRDs + └──────────┘ + │ + ┌────┴──────┐ ┌─────────┐ ┌────────────┐ + │ Arbiter │ │ Chorus │ │ Liquid-Ceph│ + └───────────┘ └─────────┘ └────────────┘ + (quorum) (replication) (allocation) + │ + ┌────┴──────┐ + │ Prysm │ ← observability CLI + └───────────┘ +``` + +## High Availability + +Ceph achieves HA through monitor quorum (typically 3 or 5 monitors), OSD replication or erasure coding, and MDS standby daemons. In stretched deployments that span two sites, [Arbiter](./arbiter.md) deploys a third monitor at a tiebreaker site so that quorum is maintained even if one full site goes offline. + +## See Also + +- [Observability](./observability/) — Prometheus metrics and Perses dashboards for the storage stack +- [Ceph upstream architecture docs](https://docs.ceph.com/en/latest/architecture/) +- [Rook documentation](https://rook.io/docs/rook/latest-release/Getting-Started/intro/) diff --git a/docs/architecture/cloud-storage/liquid-ceph.md b/docs/architecture/cloud-storage/liquid-ceph.md new file mode 100644 index 0000000..7b1943f --- /dev/null +++ b/docs/architecture/cloud-storage/liquid-ceph.md @@ -0,0 +1,16 @@ +--- +title: Liquid-Ceph +--- + +# Liquid-Ceph + +Liquid-Ceph enables dynamic, on-demand storage allocation across the CobaltCore Ceph cluster. It abstracts the complexity of pool and quota management, allowing workloads to claim storage capacity fluidly without manual pre-provisioning steps. + +::: info +Detailed documentation for Liquid-Ceph is in progress. This page will be updated as the component matures. +::: + +## See Also + +- [Ceph](./ceph.md) — the underlying distributed storage engine +- [Rook](./rook.md) — Kubernetes operator managing Ceph lifecycle diff --git a/docs/architecture/cloud-storage/observability/index.md b/docs/architecture/cloud-storage/observability/index.md new file mode 100644 index 0000000..1685b4f --- /dev/null +++ b/docs/architecture/cloud-storage/observability/index.md @@ -0,0 +1,35 @@ +--- +title: Overview +--- + +# Observability Overview + +CobaltCore monitors the cloud storage stack through a combination of Prometheus-based metrics collection and Perses dashboards. Together they provide real-time visibility into Ceph cluster health, OSD performance, RGW throughput, and storage capacity trends. + +## Stack + +| Component | Role | +|-----------|------| +| [Prometheus](./prometheus.md) | Scrapes and stores time-series metrics from Ceph, Rook, and RGW exporters | +| [Perses](./perses.md) | Dashboard platform for visualizing storage metrics and defining alerts | + +## Key Metrics + +The following signal categories are covered by the observability stack: + +- **Cluster health** — overall Ceph health status, OSD up/in counts, monitor quorum state +- **Capacity** — raw and usable capacity, per-pool usage, growth rate projections +- **Performance** — OSD read/write latency, IOPS, throughput per interface (RBD, CephFS, RGW) +- **RGW** — request rates, error rates, bandwidth per bucket and user +- **Replication** — Chorus replication lag, sync success/failure rates +- **Availability** — Arbiter monitor reachability, MDS active/standby state + +## Alerting + +Alerts are defined as Prometheus rules and surfaced through the CobaltCore alerting pipeline. Critical thresholds include OSD near-full (85%), cluster degraded state, monitor quorum loss, and RGW error rate spikes. + +## See Also + +- [Prometheus](./prometheus.md) +- [Perses](./perses.md) +- [Prysm](../prysm.md) — CLI-based observability for Ceph and RGW diff --git a/docs/architecture/cloud-storage/observability/perses.md b/docs/architecture/cloud-storage/observability/perses.md new file mode 100644 index 0000000..36d1f5c --- /dev/null +++ b/docs/architecture/cloud-storage/observability/perses.md @@ -0,0 +1,30 @@ +--- +title: Perses +--- + +# Perses + +Perses is the dashboard platform used in CobaltCore to visualize cloud storage metrics collected by [Prometheus](./prometheus.md). It provides pre-built dashboards for Ceph cluster health, OSD performance, RGW traffic, and capacity planning. + +## Dashboards + +| Dashboard | Purpose | +|-----------|---------| +| Ceph Cluster Overview | Health status, OSD counts, monitor quorum, capacity summary | +| OSD Performance | Per-OSD read/write latency, IOPS, throughput | +| Pool Usage | Capacity and object counts per Ceph pool | +| RGW Traffic | Request rate, error rate, bandwidth per bucket and user | +| Replication Status | Chorus sync lag and success/failure rates | + +## Dashboard-as-Code + +Dashboards are managed as code using the Perses CUE SDK and deployed via CI. This ensures dashboards are version-controlled alongside the rest of the CobaltCore configuration. + +::: info +Dashboard definitions and deployment configuration are in progress. +::: + +## See Also + +- [Prometheus](./prometheus.md) — metrics source for all dashboards +- [Observability Overview](./index.md) diff --git a/docs/architecture/cloud-storage/observability/prometheus.md b/docs/architecture/cloud-storage/observability/prometheus.md new file mode 100644 index 0000000..c85bb54 --- /dev/null +++ b/docs/architecture/cloud-storage/observability/prometheus.md @@ -0,0 +1,37 @@ +--- +title: Prometheus +--- + +# Prometheus + +Prometheus collects and stores time-series metrics from the CobaltCore cloud storage stack. It scrapes exporters provided by Ceph, Rook, and the RADOS Gateway, making storage metrics available for alerting and dashboard queries. + +## Exporters + +| Exporter | Source | Metrics | +|----------|--------|---------| +| `ceph-exporter` | Ceph daemons | OSD stats, pool usage, cluster health, latency histograms | +| `rook-ceph-mgr` | Rook Ceph manager | Operator status, daemon lifecycle events | +| `radosgw-exporter` | RGW | Request rates, error rates, per-user and per-bucket bandwidth | + +## Retention and Storage + +Metrics are retained according to the cluster-wide Prometheus retention policy. Long-term storage is handled by the remote-write pipeline configured in the CobaltCore monitoring stack. + +## Alert Rules + +Storage-specific alert rules are maintained alongside the other CobaltCore alerting rules. Key rules include: + +- `CephHealthWarning` / `CephHealthError` — cluster health degradation +- `CephOSDNearFull` — OSD usage exceeding 85% +- `CephMonQuorumLost` — loss of monitor quorum +- `RGWHighErrorRate` — elevated 5xx rate on the gateway + +::: info +Detailed rule definitions and Prometheus configuration are in progress. +::: + +## See Also + +- [Perses](./perses.md) — dashboard platform consuming these metrics +- [Observability Overview](./index.md) From 10da036ed983f2c346b3be2f4d2c928ad0bb7db2 Mon Sep 17 00:00:00 2001 From: "senol.colak" Date: Tue, 9 Jun 2026 15:25:42 +0200 Subject: [PATCH 4/7] docs: move Prysm into Observability & Audit subsection - Move prysm.md into cloud-storage/observability/ so it sits alongside Prometheus and Perses as part of the unified observability story - Rename the observability section to "Observability & Audit" to reflect Prysm's audit and compliance capabilities (log analysis, access audit) - Update observability/index.md: add Prysm to the stack table, add Audit to the key metrics list, fix See Also links - Update cloud-storage/index.md: remove standalone Prysm row, update component table, data flow diagram, and See Also links accordingly - Fix prysm.md internal link: ceph.md path updated for new folder depth --- docs/architecture/cloud-storage/index.md | 14 +++++++------- .../cloud-storage/observability/index.md | 10 ++++++---- .../cloud-storage/{ => observability}/prysm.md | 2 +- 3 files changed, 14 insertions(+), 12 deletions(-) rename docs/architecture/cloud-storage/{ => observability}/prysm.md (96%) diff --git a/docs/architecture/cloud-storage/index.md b/docs/architecture/cloud-storage/index.md index 2ec1a11..f498afe 100644 --- a/docs/architecture/cloud-storage/index.md +++ b/docs/architecture/cloud-storage/index.md @@ -14,7 +14,7 @@ The storage stack is organized into three layers: **Operations** — [Rook](./rook.md) runs as a Kubernetes operator and manages the full lifecycle of Ceph daemons (monitors, managers, OSDs, MDS, RGW) as containerized workloads. [Arbiter](./arbiter.md) extends quorum into stretched cluster topologies by deploying external Ceph monitors that Rook does not manage directly. -**Data Services** — [Chorus](./chorus.md) provides zero-downtime data replication and migration between object storage systems (S3 and Swift). [Liquid-Ceph](./liquid-ceph.md) enables dynamic, on-demand storage allocation across the cluster. [Prysm](./prysm.md) delivers a CLI-based observability layer over Ceph clusters and RGW deployments. +**Data Services** — [Chorus](./chorus.md) provides zero-downtime data replication and migration between object storage systems (S3 and Swift). [Liquid-Ceph](./liquid-ceph.md) enables dynamic, on-demand storage allocation across the cluster. ## Components @@ -25,8 +25,7 @@ The storage stack is organized into three layers: | [Arbiter](./arbiter.md) | Operations | External Ceph monitors for quorum in stretched clusters | | [Chorus](./chorus.md) | Data Services | Zero-downtime object storage replication and migration | | [Liquid-Ceph](./liquid-ceph.md) | Data Services | Dynamic storage allocation across the Ceph cluster | -| [Prysm](./prysm.md) | Data Services | Observability CLI for Ceph clusters and RGW | -| [Observability](./observability/) | Observability | Metrics, dashboards, and alerting for the storage stack | +| [Observability & Audit](./observability/) | Observability | Metrics, dashboards, alerting, and audit — Prometheus, Perses, Prysm | ## Storage Interfaces @@ -58,9 +57,10 @@ Applications / VMs └───────────┘ └─────────┘ └────────────┘ (quorum) (replication) (allocation) │ - ┌────┴──────┐ - │ Prysm │ ← observability CLI - └───────────┘ + ┌────┴──────────────────────────┐ + │ Observability & Audit │ + │ Prometheus · Perses · Prysm │ + └───────────────────────────────┘ ``` ## High Availability @@ -69,6 +69,6 @@ Ceph achieves HA through monitor quorum (typically 3 or 5 monitors), OSD replica ## See Also -- [Observability](./observability/) — Prometheus metrics and Perses dashboards for the storage stack +- [Observability & Audit](./observability/) — Prometheus metrics, Perses dashboards, and Prysm CLI for the storage stack - [Ceph upstream architecture docs](https://docs.ceph.com/en/latest/architecture/) - [Rook documentation](https://rook.io/docs/rook/latest-release/Getting-Started/intro/) diff --git a/docs/architecture/cloud-storage/observability/index.md b/docs/architecture/cloud-storage/observability/index.md index 1685b4f..7889b71 100644 --- a/docs/architecture/cloud-storage/observability/index.md +++ b/docs/architecture/cloud-storage/observability/index.md @@ -1,10 +1,10 @@ --- -title: Overview +title: Observability & Audit --- -# Observability Overview +# Observability & Audit Overview -CobaltCore monitors the cloud storage stack through a combination of Prometheus-based metrics collection and Perses dashboards. Together they provide real-time visibility into Ceph cluster health, OSD performance, RGW throughput, and storage capacity trends. +CobaltCore monitors the cloud storage stack through a combination of Prometheus-based metrics collection, Perses dashboards, and the Prysm observability CLI. Together they provide real-time visibility into Ceph cluster health, OSD performance, RGW throughput, storage capacity trends, and audit compliance. ## Stack @@ -12,6 +12,7 @@ CobaltCore monitors the cloud storage stack through a combination of Prometheus- |-----------|------| | [Prometheus](./prometheus.md) | Scrapes and stores time-series metrics from Ceph, Rook, and RGW exporters | | [Perses](./perses.md) | Dashboard platform for visualizing storage metrics and defining alerts | +| [Prysm](./prysm.md) | CLI-based observability tool for Ceph clusters and RGW — real-time monitoring, SMART disk health, log compliance | ## Key Metrics @@ -23,6 +24,7 @@ The following signal categories are covered by the observability stack: - **RGW** — request rates, error rates, bandwidth per bucket and user - **Replication** — Chorus replication lag, sync success/failure rates - **Availability** — Arbiter monitor reachability, MDS active/standby state +- **Audit** — log compliance analysis and access audit via Prysm consumers ## Alerting @@ -32,4 +34,4 @@ Alerts are defined as Prometheus rules and surfaced through the CobaltCore alert - [Prometheus](./prometheus.md) - [Perses](./perses.md) -- [Prysm](../prysm.md) — CLI-based observability for Ceph and RGW +- [Prysm](./prysm.md) diff --git a/docs/architecture/cloud-storage/prysm.md b/docs/architecture/cloud-storage/observability/prysm.md similarity index 96% rename from docs/architecture/cloud-storage/prysm.md rename to docs/architecture/cloud-storage/observability/prysm.md index 2b9553b..47b02b6 100644 --- a/docs/architecture/cloud-storage/prysm.md +++ b/docs/architecture/cloud-storage/observability/prysm.md @@ -5,7 +5,7 @@ title: Prysm # Prysm Prysm is a comprehensive observability CLI tool developed by CobaltCore for -monitoring [Ceph](./ceph.md) storage clusters and RADOS Gateway (RGW) +monitoring [Ceph](../ceph.md) storage clusters and RADOS Gateway (RGW) deployments. Prysm provides a multi-layered architecture designed to deliver real-time monitoring, data collection, and analysis across Ceph environments. From e45c001aebc61b1c2b4893c31697e60119db4ca3 Mon Sep 17 00:00:00 2001 From: "senol.colak" Date: Tue, 9 Jun 2026 16:08:27 +0200 Subject: [PATCH 5/7] fix: add language tag to fenced code block (MD040) --- docs/architecture/cloud-storage/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/cloud-storage/index.md b/docs/architecture/cloud-storage/index.md index f498afe..b9e592d 100644 --- a/docs/architecture/cloud-storage/index.md +++ b/docs/architecture/cloud-storage/index.md @@ -37,7 +37,7 @@ Ceph exposes three storage interfaces that CobaltCore services consume: ## Data Flow -``` +```text Applications / VMs │ ┌───────┴────────────────────┐ From 5e94a354bb80b567c50d0a8563aaf5dc6f34422a Mon Sep 17 00:00:00 2001 From: Senol Colak Date: Fri, 12 Jun 2026 16:44:59 +0200 Subject: [PATCH 6/7] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/architecture/cloud-storage/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/architecture/cloud-storage/index.md b/docs/architecture/cloud-storage/index.md index b9e592d..896c7c3 100644 --- a/docs/architecture/cloud-storage/index.md +++ b/docs/architecture/cloud-storage/index.md @@ -1,8 +1,8 @@ --- -title: Overview +title: Cloud Storage --- -# Cloud Storage Overview +# Cloud Storage CobaltCore's cloud storage layer is built on [Ceph](./ceph.md), a distributed storage system that delivers object, block, and file storage in a single unified platform. The surrounding components handle lifecycle automation, data replication, high-availability quorum, observability, and liquid storage allocation — each with a focused responsibility. From c2e5c73b4e66aea17c55f66428e9012475c123e7 Mon Sep 17 00:00:00 2001 From: Senol Colak Date: Fri, 12 Jun 2026 16:45:18 +0200 Subject: [PATCH 7/7] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/architecture/cloud-storage/observability/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/cloud-storage/observability/index.md b/docs/architecture/cloud-storage/observability/index.md index 7889b71..b01cb1a 100644 --- a/docs/architecture/cloud-storage/observability/index.md +++ b/docs/architecture/cloud-storage/observability/index.md @@ -11,7 +11,7 @@ CobaltCore monitors the cloud storage stack through a combination of Prometheus- | Component | Role | |-----------|------| | [Prometheus](./prometheus.md) | Scrapes and stores time-series metrics from Ceph, Rook, and RGW exporters | -| [Perses](./perses.md) | Dashboard platform for visualizing storage metrics and defining alerts | +| [Perses](./perses.md) | Dashboard platform for visualizing storage metrics (alert rules are defined as Prometheus rules) | | [Prysm](./prysm.md) | CLI-based observability tool for Ceph clusters and RGW — real-time monitoring, SMART disk health, log compliance | ## Key Metrics