跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

日志流

最后更新 查看 MarkdownAgent 设置

隧道日志记录了 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 日志:

  1. 在 Cloudflare 仪表板中,前往 Networking(网络) > Tunnels(隧道),选择你的隧道。

    前往 Tunnels(隧道) ↗
  2. 前往 Live logs(实时日志) 选项卡。

  3. 选择 Live(实时) 开始流式查看。

查看副本(replica)的日志

如果为同一个隧道运行多个 cloudflared 实例(也称为副本),所有已连接副本的日志会自动流式传输,并按主机名分组,便于识别每条日志由哪台主机产生。

要将日志流筛选为特定副本,请选择 Filter(筛选) 图标,并展开 Replicas(副本) 部分。还可以按 Log Level(日志级别) 和 Event Type(事件类型) 筛选。

命令行接口 (CLI)

cloudflared 守护程序可以将您账户中任何隧道的日志流式传输到本地命令行。cloudflared 必须同时安装在本地机器和源服务器上。

cloudflared 守护进程可以将您账户中任何 Tunnel 的日志流式传输到本地命令行。您的本地机器和源服务器上都必须安装 cloudflared。

  1. 在本地机器上,向您的 Cloudflare 账户身份验证 cloudflared:

    cloudflared tunnel login
  2. 针对特定的 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 实例(也称为副本),您必须指定一个单独的实例来流式传输日志:

  1. 在 Cloudflare 仪表板中,前往 Networking(网络) > Tunnels(隧道),选择你的隧道。

    前往 Tunnels(隧道) ↗
  2. 找到您要查看的 cloudflared 实例的 Connector ID(连接器 ID)。

  3. 在 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 获取网络会话日志。

这篇文档对您有帮助吗?