> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nxtsight.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Monitoring

> Monitor nxtStore cluster health, OSD status, and I/O performance through nxtRadar integration — key metrics, alert thresholds, and observability configuration.

## Overview

nxtStore cluster health and performance data is exported to nxtRadar for centralized monitoring
and alerting. This page covers the key metrics to monitor, recommended alert thresholds,
and how to configure the integration.

<Warning>
  **Administrator Access Required** — This operation requires the `admin` role. Contact your
  NxtSight administrator if you do not have sufficient permissions.
</Warning>

<Note>
  **Prerequisites**

  * Administrator credentials with the `admin` role
  * nxtRadar deployed and accessible (see [nxtRadar Admin Guide](/services/monitoring/admin-guide))
  * Metric scrape target configured for the nxtStore cluster metrics endpoint
</Note>

***

## Key Metrics and Alert Thresholds

| Metric                  | Namespace                               | Alert Threshold      | Action                              |
| ----------------------- | --------------------------------------- | -------------------- | ----------------------------------- |
| Cluster health          | `NxtSight_storage_health`               | `HEALTH_WARN`        | Investigate immediately             |
| OSD `down` count        | `NxtSight_storage_osd_down`             | > 0                  | Replace or recover failed OSD       |
| Pool used %             | `NxtSight_storage_pool_used_pct`        | > 70%                | Plan capacity expansion             |
| Recovery I/O rate       | `NxtSight_storage_recovery_bytes_sec`   | Sustained > 200 MB/s | Consider I/O throttling             |
| PG `inconsistent` count | `NxtSight_storage_pg_inconsistent`      | > 0                  | Run `ceph health detail` and repair |
| Replication lag (RGW)   | `NxtSight_storage_rgw_sync_lag_sec`     | Sustained > 30s      | Check network bandwidth to RGW      |
| OSD apply latency       | `NxtSight_storage_osd_apply_latency_ms` | > 20 ms              | Investigate OSD or disk health      |

***

## Configuring nxtRadar Integration

<Steps titleSize="h3">
  <Step title="Verify metrics endpoint" icon="activity">
    The nxtStore cluster exposes metrics on the management node. Verify the endpoint
    is reachable:

    ```bash title="Check metrics endpoint" theme={null}
    curl http://<MGMT_NODE_IP>:9283/metrics | head -20
    ```

    Port `9283` is the default metrics exporter port deployed by nxtDeploy.
  </Step>

  <Step title="Add scrape target in nxtRadar" icon="plus">
    Navigate to **Monitoring → Administration → Scrape Targets → Add Target**:

    | Field               | Value                                                    |
    | ------------------- | -------------------------------------------------------- |
    | **URL**             | `http://<MGMT_NODE_IP>:9283/metrics`                     |
    | **Scrape Interval** | `60s` (storage metrics don't need sub-minute resolution) |
    | **Labels**          | `service=nxtStore`, `cluster=<CLUSTER_NAME>`             |

    Or via CLI:

    ```bash title="Add nxtStore scrape target" theme={null}
    nxtradar target add \
      --url http://<MGMT_NODE_IP>:9283/metrics \
      --interval 60s \
      --label service=nxtStore \
      --label cluster=prod-storage
    ```
  </Step>

  <Step title="Create alert rules" icon="bell">
    Navigate to **Monitoring → Alerting → Alert Rules** and create rules for each
    threshold in the table above.

    Example alert rule for pool utilization:

    ```yaml title="alert-storage-capacity.yaml" theme={null}
    name: nxtStore-pool-capacity-warning
    metric: NxtSight_storage_pool_used_pct
    condition: ">"
    threshold: 70
    evaluation_period: 10m
    severity: warning
    notification_channels:
      - ops-email
    ```

    <Check>Alert rules appear in the Active Rules list and evaluate against live storage metrics.</Check>
  </Step>
</Steps>

***

## Built-In Dashboards

The nxtRadar portal includes pre-built nxtStore dashboards. Navigate to
**Monitoring → Dashboards** and search for "nxtStore" or "Storage":

| Dashboard                     | Shows                                                 |
| ----------------------------- | ----------------------------------------------------- |
| **nxtStore Cluster Overview** | Health state, OSD counts, capacity, recovery activity |
| **nxtStore Pool Utilization** | Per-pool used %, available bytes, PG counts           |
| **nxtStore OSD Performance**  | Per-OSD latency, IOPS, throughput                     |
| **nxtStore Recovery**         | Active recovery operations, estimated completion time |

<Tip>
  Pin the "nxtStore Cluster Overview" dashboard to your nxtRadar home screen for constant
  visibility during on-call rotations.
</Tip>

***

## Cluster CLI Health Check

For quick health checks without opening the nxtRadar portal, use the management CLI
directly from a cluster node:

```bash title="Quick health overview" theme={null}
ceph status
```

```bash title="OSD performance snapshot" theme={null}
ceph osd perf
```

```bash title="Pool I/O statistics (5-second window)" theme={null}
ceph osd pool stats
```

```bash title="Active slow requests" theme={null}
ceph health detail | grep -i slow
```

***

## Next Steps

<CardGroup cols={2}>
  <Card title="nxtRadar Admin Guide" href="/services/monitoring/admin-guide" color="#0b5ed7">
    Configure the monitoring platform that collects and displays nxtStore metrics
  </Card>

  <Card title="Capacity Planning" href="/services/sds/admin-guide/capacity-planning" color="#0b5ed7">
    Use utilization metrics to plan cluster expansion before thresholds are reached
  </Card>

  <Card title="Troubleshooting" href="/services/sds/admin-guide/troubleshooting" color="#0b5ed7">
    Diagnose the issues surfaced by monitoring alerts
  </Card>

  <Card title="nxtRadar Alert Rules" href="/services/monitoring/admin-guide/alert-channels" color="#0b5ed7">
    Configure notification channels for storage health alerts
  </Card>
</CardGroup>