# Surveiller les alertes HDS

> Consultez les alertes de votre espace HDS (quota de stockage, refus en série, sauvegardes, accès d'urgence), lancez un contrôle et acquittez-les.

Le module contrôle chaque jour à 6 h quelques seuils de l'espace et en tire des alertes. L'administrateur HDS les consulte, peut lancer le contrôle à la demande et acquitte celles qu'il a traitées.

## Avant de commencer

- Vous portez le rôle `HDS_ADMIN`.

## Les alertes possibles

| Type | Gravité | Déclencheur |
|---|---|---|
| `STORAGE_QUOTA_WARNING` | `MEDIUM` | Stockage utilisé au-delà de 80 % du quota. |
| `STORAGE_QUOTA_CRITICAL` | `CRITICAL` | Stockage utilisé au-delà de 95 % du quota. |
| `SECURITY_FAILED_ACCESS_SPIKE` | `CRITICAL` | Plus de 10 opérations refusées en 5 minutes. |
| `BACKUP_FAILURE` | `CRITICAL` | Au moins une sauvegarde en échec sur 24 heures. |
| `BREAK_GLASS_ACTIVE` | `CRITICAL` | Au moins un accès d'urgence encore actif. |

Une alerte reste visible 24 heures. Une même alerte n'est pas recréée pendant l'heure qui suit.

## Lancer un contrôle

```bash
curl -X POST "https://api.wakastart.app/api/hds/admin/alerts/check" \
  -H "Authorization: Bearer $USER_TOKEN"
```

Le contrôle s'exécute immédiatement sur votre espace. La réponse `{ "triggered": 1, "alerts": [ … ] }` donne le nombre et le détail des alertes créées.

## Consulter les alertes

```bash
curl "https://api.wakastart.app/api/hds/admin/alerts" \
  -H "Authorization: Bearer $USER_TOKEN"
```

Réponse attendue :

```json
[
  {
    "alertId": "alt_Cv3Bn6MqW2eR",
    "networkWid": "EXCLI1",
    "severity": "CRITICAL",
    "type": "BREAK_GLASS_ACTIVE",
    "message": "1 active break-glass access(es)",
    "triggeredAt": "2026-10-23T06:00:02.000Z",
    "acknowledged": false
  }
]
```

## Acquitter une alerte

```bash
curl -X POST "https://api.wakastart.app/api/hds/admin/alerts/alt_Cv3Bn6MqW2eR/acknowledge" \
  -H "Authorization: Bearer $USER_TOKEN"
```

La réponse renvoie l'alerte avec `"acknowledged": true`, `acknowledgedBy` et `acknowledgedAt`. Si l'alerte a expiré, la réponse est `{ "message": "Alert not found or expired" }`.

## Vérifier le résultat

- Après traitement de la cause (révocation d'un accès d'urgence, par exemple), un nouveau contrôle ne recrée pas l'alerte.

## Voir aussi

- [Activer un accès d'urgence](/v1.0/hds/activer-un-acces-d-urgence)
- [Sauvegarder et restaurer les métadonnées](/v1.0/hds/sauvegarder-et-restaurer)
