# Comprobar la propagación

> Mira si todos los nodos de borde que sirven una zona han aplicado su versión actual y espera a que un cambio se propague.

La propagación compara la versión deseada de la zona con la versión que ha aplicado cada nodo de borde que la sirve. Los estados se explican en [Propagación al borde](https://developers.openwaf.dev/es/change-control/propagation/#statuses).

## Ver en qué punto está cada nodo

**Panel**

Abre el dominio y ve a **Cambios → Propagación**. La página muestra la versión deseada, cuántos nodos están al día, el nodo más lento y una tabla con el estado de cada nodo, la versión aplicada y la deseada, el retraso y la última consulta. Se actualiza cada 5 segundos mientras está abierta; **¿Qué significa cada estado?** explica cada estado.
**CLI**

```sh
openwaf-cloud ctl zones propagation example.com
```
Imprime `Versión deseada: N` y una fila por nodo con su estado, la versión aplicada, desde cuándo está pendiente, el retraso y la última consulta. `--json` imprime la respuesta de la API.
**API**

```sh
curl -sS "https://dash.openwaf.dev/v1/orgs/$ORG/zones/$ZONE/propagation" \
  -H "Authorization: Bearer $OPENWAF_TOKEN"
```
```json
{
  "zone_id": "…",
  "desired_version": 44,
  "nodes": [
    {"node_id": "…", "status": "converged", "applied_version": 44, "pending_since": null,
     "lag_seconds": 41, "last_seen_at": "2026-10-27T10:15:02Z"}
  ]
}
```
El `ETag` de la respuesta es la versión deseada.
**MCP**

Pregunta si el último cambio ha llegado a todos los nodos; el asistente llama a `zone_propagation`.


## Esperar a un cambio

Con la CLI, añade `--wait` al propio cambio. Tras aplicarlo, consulta la propagación hasta que todos los nodos confirman la versión nueva, y enseña cada nodo a medida que lo hace:

```sh
openwaf-cloud ctl zones set example.com waf_level=high --reason "Subir el nivel del WAF" --yes --wait=180s
```

`--wait` sin más espera hasta 120 segundos; `--wait=90s` o `--wait=90` fija otro plazo. Como cada nodo confirma en su siguiente consulta, el tiempo medido ronda el doble del intervalo de consulta. Si al acabar el plazo algún nodo no se ha puesto al día, la CLI enumera los pendientes y sale con el código 4; el cambio sigue aplicado.

En un script que no use la CLI, consulta la ruta de propagación hasta que todos los nodos que no están `revoked` ni `retiring` estén `converged`.

## Cuando un nodo se queda atrás

- `pending` durante hasta un minuto justo después de un cambio es normal.
- `lagging` que se mantiene, u `offline`, es cosa de OpenWAF: los demás nodos siguen sirviendo la versión nueva. Si dura, escribe a support@openwaf.dev con la zona y la versión.
- Los nodos `retiring` están dejando la zona y desaparecen cuando aplican una configuración sin ella.
