Update tunnel health checks frequency

By default, Cloudflare servers send health checks to each GRE, Cloudflare Network Interconnect (CNI), or IPsec tunnel endpoint you configure to receive traffic from Magic Transit.

You can configure the health check frequency through the dashboard or the API to suit your use case. For example, if you are connecting a lower-traffic site that does not need immediate failover and you prefer a lower volume of health check traffic, set the frequency to low. On the other hand, if you are connecting a site that is extremely sensitive to any issues and you want proactive failover at the earliest sign of a potential problem, set this to high.

Available options are low, mid, and high.

Dashboard

1. Refer to Add tunnels to learn how to create or edit your tunnel.
2. Change the Health check rate to your desired rate. For example, Low.
3. Save your changes.

API

You can adjust the health check frequency by updating your GRE, IPsec, or CNI tunnels.

The following example adjusts tunnel health check frequency to low. Note that this command applies to GRE, IPsec and CNI tunnels:

curl "https://api.cloudflare.com/client/v4/accounts/%7Baccount_id%7D/magic/ipsec_tunnels/%7Bipsec_tunnel_id%7D" \
  --request PUT \
  --json '{
    "health_check": {
        "rate": "low"
    }
  }'

Note

Magic Transit customers with Customer Metadata Boundary enabled for the European Union can access GRE, IPsec, and CNI (Cloudflare Network Interconnect) health check and traffic volume data in the Cloudflare dashboard and through the API. This ensures that customers who need to be General Data Protection Regulation (GDPR) compliant can access all Magic Transit features.