本文档介绍了如何通过流式传输和 Live Tailing 实时查看日志条目。借助流式日志,您可以实时查看日志条目,该功能可在日志浏览器中使用。借助实时跟踪功能,您可以实时查看日志条目。该功能以 gcloud CLI 命令 gcloud alpha logging tail
和 Cloud Logging API 方法 entries.tail
提供。
使用日志浏览器、gcloud logging read
或 API 方法 entries.list
查看和分析日志时,您查看的是 Cloud Logging 已存储的日志条目。如果您流式传输或实时跟踪日志条目,则在应用将日志条目写入 Cloud Logging API 后,您就可以查看日志条目。
在日志浏览器中流式传输日志
在日志浏览器中,您可以使用流式传输日志实时查看日志数据。使用流式传输日志时,您可以添加查询,以仅流式传输与查询匹配的日志。如需流式传输日志,请执行以下操作:
-
在 Google Cloud 控制台中,转到 Logs Explorer 页面。
如果您使用搜索栏查找此页面,请选择子标题为 Logging 的结果。
在查询文本框中,输入查询,然后点击流式传输日志。
当 Logging 写入日志数据时,查询结果窗格中仅显示与查询匹配的日志。如果未提供查询,则 Logging 会显示最近存储的日志条目。日志会继续流式传输,直到您选择日志面板上的滚动条。流式传输停止后,系统会显示重新开始流式传输按钮。
如需了解查询,请参阅在日志浏览器中构建查询。
在 Google Cloud CLI 中使用 Live Tailing
借助实时跟踪功能,您可以在 Cloud Logging 写入日志条目时使用 Google Cloud CLI 或 Cloud Logging API 实时查看日志条目。
具有字段级访问权限控制的日志存储分区不支持实时跟踪,但您可以在 Logs Explorer 中为这些存储分区流式传输日志。
如需了解 Live Tailing 的 API 方法,请参阅 entries.tail 方法。
安装 gcloud alpha logging tail
如需使用 gcloud alpha logging tail
,您需要安装 Python 3 和 grpcio
Python 软件包。
如需了解如何安装 Python,请参阅 Python 页面。如需了解如何安装 grpcio
软件包安装所需的 Python 软件包管理器 pip
,请参阅 Python 软件包安装程序页面。
完成以下步骤以安装 gcloud alpha logging tail
:
确认您已安装 Google Cloud CLI。如需了解如何安装 Google Cloud CLI,请参阅安装 Google Cloud CLI。
确认您使用的是 gcloud CLI 的 302.0.0 或更高版本。
gcloud version
如需了解如何更新 gcloud CLI,请参阅
gcloud components update
。安装 gcloud CLI Alpha 版组件:
gcloud components install alpha
对于 MacOS、Linux 和 Cloud Shell 用户:
安装 gRPC 客户端库:
sudo pip3 install grpcio
将环境变量
CLOUDSDK_PYTHON_SITEPACKAGES
设置为任意值:export CLOUDSDK_PYTHON_SITEPACKAGES=1
使用以下命令设置 Google Cloud 项目 ID 并进行身份验证:
gcloud config set project PROJECT_ID gcloud auth login
如需获取项目 ID,请参阅创建和管理项目。
通过运行以下命令来验证是否已安装
gcloud alpha logging tail
:gcloud alpha logging tail
该命令会显示以下消息:
Initializing tail session.
现在,您可以在 Logging 写入 Google Cloud 项目的日志条目时查看日志条目。
如需详细了解如何使用 Live Tailing,请参阅 gcloud alpha logging tail
参考指南。
缓冲和排序
由于 Logging 可以不按时间顺序接收日志条目,因此 Live Tailing 提供缓冲时段设置,以便您适当选择在系统写入日志条目时查看日志条目以及按升序查看日志条目。您可以将缓冲时段设置为 0
到 60
秒。
请注意缓冲时段的以下特性:
默认缓冲时段为 2 秒。
Logging 会将将日志条目写入日志存储分区的操作延迟一段时间(即缓冲区时段)。
如果系统在缓冲时段之外写入日志条目,则 Logging 会在收到日志条目时返回日志条目。
配置缓冲时段时,您需要适当选择在系统写入日志时查看日志以及不按顺序查看条目。
缓冲时段 | 权衡 |
---|---|
0 秒 |
返回的最新日志条目,但可能不按顺序返回。 |
60 秒 |
延迟 60 秒才能看到返回的条目,但大多数日志都按升序返回。 |
限制和配额
下表列出了 Live Tailing 的限制和配额:
限制和配额 | 值 |
---|---|
每分钟返回的条目数 | 60,000 如果与过滤条件匹配的条目数超过 60,000,则 Logging 会在响应中返回条目数。 |
每个 Google Cloud 项目打开的 Live-Tailing 会话数 | 10 |
客户端限制
对于快速写入大量条目的 Google Cloud 项目,您的客户端可能无法在系统写入条目时使用这些条目。在这种情况下,Logging 会限制发送的条目总数,并优先处理最近的条目。在 Live Tail 结束时,Logging 会返回由于客户端限制而未显示的条目数。
将 Live Tailing 与客户端库搭配使用
借助 Live Tailing,您可以在 Cloud Logging 写入日志条目时实时查看日志条目。如需了解 Live Tailing 的 API 方法,请参阅 entries.tail 方法。
具有字段级访问权限控制的日志存储分区不支持实时跟踪,但您可以在 Logs Explorer 中为这些存储分区流式传输日志。
此示例演示了给定 Logger 的 Live Tailing 日志条目。
Go
如需了解如何安装和使用 Logging 客户端库,请参阅 Logging 客户端库。
如需向 Logging 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Java
如需了解如何安装和使用 Logging 客户端库,请参阅 Logging 客户端库。
如需向 Logging 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。
Node.js
如需了解如何安装和使用 Logging 客户端库,请参阅 Logging 客户端库。
如需向 Logging 进行身份验证,请设置应用默认凭据。 如需了解详情,请参阅为本地开发环境设置身份验证。