监控

Customers who want to receive a notification when Cloudflare Tunnels are created or deleted in their account.

None.

All Cloudflare Zero Trust plans.

No action is needed.

Customers who want to be warned about changes in health status for their Cloudflare Tunnels.

None.

All Cloudflare Zero Trust plans.

Monitor tunnel health over time and consider deploying cloudflared replicas or load balancers.

Refer to Tunnel status to review the list of possible tunnel statuses (Healthy, Inactive, Down and Degraded).

cloudflared 从 Tunnel 指标服务器（tunnel metrics server）读取诊断数据。要获取诊断日志，必须从 Docker 容器中公开指标服务器，并使其可从宿主机访问。

1. 确定在 Docker 中运行的 cloudflared 实例的 指标服务器端口。

2. 确保在部署容器时启用了端口转发。诊断功能将使用本地端口 20241 向 Docker 实例请求信息，因此您应该将端口 20241 转发到步骤 1 中获取的容器端口：

   docker run -d -p 20241:<metrics_port> docker.io/cloudflare/cloudflared tunnel ...

3. 验证您可以从 Docker 宿主环境访问指标服务器地址：

   curl localhost:20241/diag/tunnel

   该命令应返回一个 JSON：

   {
     "tunnelID": "ef96b330-a7f5-4bce-a00e-827ce5be077f",
     "connectorID": "d236670a-9f74-422f-adf1-030f5c5f0523",
     "connections": [
       { "isConnected": true, "protocol": 1, "edgeAddress": "198.41.192.167"},
       {"isConnected": true, "protocol": 1, "edgeAddress": "198.41.200.113", "index": 1},
       {"isConnected": true, "protocol": 1, "edgeAddress": "198.41.192.47", "index": 2},
       {"isConnected": true, "protocol": 1, "edgeAddress": "198.41.200.73", "index": 3}
     ],
     "icmp_sources": ["192.168.1.243", "fe80::c59:bd4a:e815:ed6"]
   }

4. 使用 Docker 容器 ID 运行诊断：

   cloudflared tunnel diag --diag-container-id=<containerID>

   或者，您可以指定容器的名称而不是其 ID：

   cloudflared tunnel diag --diag-container-id=<containerName>

   使用容器 ID 运行诊断命令允许 cloudflared 从 Docker 环境中收集信息，例如日志和容器详细信息。

此命令将输出每个诊断任务的状态，并在您的工作目录中放置一个 cloudflared-diag-YYYY-MM-DDThh-mm-ss.zip 文件。

诊断功能将使用端口 20241 到 20245 从 Tunnel 指标服务器（tunnel metrics server）请求数据。您需要使用端口转发，以允许本地 cloudflared 实例在这些端口之一上连接到指标服务器。

1. 确定 Tunnel 的 指标服务器端口。

2. 启用端口转发：

   kubectl port-forward <pod> <diagnostic_port>:<metrics_port>

   • <pod>：运行 Tunnel 的 pod 的名称
   • <diagnostic_port> 是 20241 到 20245 范围内的任何本地端口。
   • <metrics_port> 是您要诊断的 cloudflared 实例的 Kubernetes pod 端口（在步骤 1 中获取）。

   例如，如果您将指标服务器地址设置为 0.0.0.0:12345：

   kubectl port-forward cloudflared-6d4897585b-r8kfz 20244:12345

   发送到本地端口 20244 的连接将转发到运行 Tunnel 的 pod 的端口 12345。

3. 运行诊断：

   cloudflared tunnel diag --diag-pod-id=<podID>

   如果 pod 运行着多个应用程序/服务，且 cloudflared 不是 pod 中的第一个，您必须指定容器 ID 或名称：

   cloudflared tunnel diag --diag-pod-id=<podID> --diag-container-id=<containerName>

此命令将输出每个诊断任务的状态，并在您的工作目录中放置一个 cloudflared-diag-YYYY-MM-DDThh-mm-ss.zip 文件。