隧道日志记录了 cloudflared 实例与 Cloudflare 全球网络之间的所有活动,以及 cloudflared 与您的源服务器之间的所有活动。这些日志使您能够调查 Cloudflare Tunnel 的连接或性能问题。您可以配置服务器以存储持久日志,也可以从任何客户端机器流式传输实时日志。
如果可以访问源站服务器,可以在启动隧道时使用 --loglevel 标志启用日志记录。默认情况下,cloudflared 将日志写入标准错误(stderr),不会在服务器上存储日志。
要将每条日志格式化为 JSON 对象,请在 run 前添加 --output json:
cloudflared tunnel --output json run <UUID>此格式适用于 Kubernetes 部署和使用 JSON 的日志收集系统。
对于常规持久化日志记录,请使用 --log-directory <PATH> 运行隧道。此标志将日志写入指定目录中的 cloudflared.log,文件达到 1 MB 时轮转,最多保留五份备份。它不会根据日志的存放时间将其删除。
cloudflared tunnel --loglevel info --log-directory <PATH> run <UUID>对于短期排查,或由其他工具管理轮转时,请改用 --logfile 标志。cloudflared 不会轮转 --logfile 指定的文件。如果同时设置两个标志,--logfile 优先。
您可以通过仪表板或从安装了 cloudflared 的任何机器查看 Cloudflare Tunnel 的实时日志。使用远程日志流,您无需 SSH 登录到运行隧道的服务器。要获取远程日志,隧道必须处于活动状态且能够接收请求。
要从仪表板流式传输 Tunnel 日志:
-
在 Cloudflare 仪表板中,前往 Networking(网络) > Tunnels(隧道),选择你的隧道。
前往 Tunnels(隧道) ↗ -
前往 Live logs(实时日志) 选项卡。
-
选择 Live(实时) 开始流式查看。
如果为同一个隧道运行多个 cloudflared 实例(也称为副本),所有已连接副本的日志会自动流式传输,并按主机名分组,便于识别每条日志由哪台主机产生。
要将日志流筛选为特定副本,请选择 Filter(筛选) 图标,并展开 Replicas(副本) 部分。还可以按 Log Level(日志级别) 和 Event Type(事件类型) 筛选。
cloudflared 守护程序可以将您账户中任何隧道的日志流式传输到本地命令行。cloudflared 必须同时安装在本地机器和源服务器上。
cloudflared 守护进程可以将您账户中任何 Tunnel 的日志流式传输到本地命令行。您的本地机器和源服务器上都必须安装 cloudflared。
-
在本地机器上,向您的 Cloudflare 账户身份验证
cloudflared:cloudflared tunnel login -
针对特定的 Tunnel 运行
cloudflared tail:cloudflared tail <UUID>为了更结构化地查看 JSON 消息,您可以将输出管道传输到类似 jq ↗ 的工具:
cloudflared tail --output=json <UUID> | jq .
您可以按事件类型 (--event)、事件级别 (--level) 或采样率 (-sampling) 过滤日志,以减少从源站流式传输的日志量。这有助于减轻对源站的性能影响,尤其是在源站通常处于高负载的情况下。例如:
cloudflared tail --level debug <UUID>| 标志 | 描述 | 允许的值 | 默认值 |
|---|---|---|---|
--event |
按事件/请求的类型进行过滤。 | cloudflared, http, tcp, udp |
所有事件 |
--level |
返回此级别及以上的日志。独立于服务器上的 --loglevel 设置运行。 |
debug, info, warn, error, fatal |
debug |
--sampling |
对总日志的一部分进行采样。 | 0.0 到 1.0 之间的数字 |
1.0 |
如果您在同一个隧道运行了多个 cloudflared 实例(也称为副本),您必须指定一个单独的实例来流式传输日志:
-
在 Cloudflare 仪表板中,前往 Networking(网络) > Tunnels(隧道),选择你的隧道。
前往 Tunnels(隧道) ↗ -
找到您要查看的
cloudflared实例的 Connector ID(连接器 ID)。 -
在
cloudflared tail中指定 Connector ID:cloudflared tail --connector-id <CONNECTOR ID> <UUID>
- 日志会话将仅保持开启一小时。所有日志系统都会引入一定程度的性能开销,此限制有助于防止对您隧道的端到端延迟造成长期影响。
- 对高吞吐量隧道进行日志流式传输时,Cloudflare 会优先保障服务稳定性。要减少丢弃的日志数量,可尝试 请求更少的日志。要确保查看到所有日志,请 在服务器上查看日志,而不是远程流式传输日志。
Zero Trust 网络会话日志记录 Cloudflare 路由到隧道的每个私有网络会话。路由到 Cloudflare Tunnel 的会话将 Offramp 报告为 TUNNEL。以下两个字段显示会话的确切发送位置:
| 字段 | 描述 |
|---|---|
DestinationTunnelID |
接收会话的隧道。 |
DestinationReplicaID |
接收会话的 cloudflared 副本。此值与仪表板中副本的 Connector ID(连接器 ID) 一致。 |
如果运行多个副本,请使用这些字段确认哪个隧道和副本接收了特定会话的流量。要进一步调查该副本,使用 cloudflared tail --connector-id <DESTINATION_REPLICA_ID> <TUNNEL_ID> 流式查看其日志。
可通过 Logpush 获取网络会话日志。