写入应用日志

向 App Engine 中运行的应用发送请求时,系统会自动记录请求和响应详细信息,您可以在 Google Cloud Platform Console Stackdriver 日志查看器中查看这些详细信息。

应用请求和应用日志由 Stackdriver Logging 代理收集。如需了解日志保留政策以及日志条目所占空间的大小上限,请参阅配额政策。如果您需要将日志存储更长时间,可以将日志导出至 Cloud Storage。您还可以将日志导出至 BigQuery 和 Pub/Sub 以供进一步处理。

如需查看您可以使用的日志列表,请参阅 App Engine 柔性环境日志

写入应用日志

当应用处理请求时,可以将自己的日志消息写入 stdoutstderr。写入应用日志时,用 stdout 写入输出,stderr 写入错误。这些文件由系统自动收集,并且可以在日志查看器中查看。请注意,这一方法不提供可用于在日志查看器中进行过滤的日志级别;但是,日志查看器确实提供其他过滤(例如文本和时间戳等)。为了限制日志的大小,系统仅会保留日志查看器中的最新条目。

查看应用日志

您可以使用日志查看器查看应用日志:

  1. 转到 GCP Console 中的 Stackdriver > Logging 页面:

    转到“日志查看器”页面

  2. 在页面顶部选择一个现有 GCP 项目。

  3. 从下拉菜单中选择 GAE 应用作为资源类型,以查看 App Engine 日志。

您可以使用日志查看器的下拉菜单和其他组件来过滤或搜索日志,以便查找相关条目。如需了解详情,请参阅日志查看器过滤条件界面

过滤应用日志

如需在日志查看器中按标签或通过搜索文字过滤日志条目,请参阅基本日志过滤条件

如需编写高级日志过滤器以进一步指定一组日志条目,请参阅高级日志过滤条件

如需查看特定实例、服务或版本的日志,请在日志查看器中按该资源的 ID 进行过滤。如需查找服务和版本 ID,请前往 App Engine 信息中心

在日志查看器中,您可以按“父-子”格式查看由同一 trace 关联的日志条目。

请按照以下说明关联日志条目:

  1. 确定要与 request 日志关联的应用日志。请注意,如需使此关联生效,所选应用日志的类型不能request 日志类型相同。

  2. 在您的应用代码中,查找传入请求的 X-Cloud-Trace-Context HTTP 标头。从该标头中提取跟踪标识符。如需了解详情,请参阅 Stackdriver Trace 支持

  3. 在应用日志条目的 LogEntry trace 字段中设置 trace 标识符。预期格式是 projects/[PROJECT_ID]/traces/[TRACE_ID]

关联日志条目后,下面是查看关联日志条目的说明:

  1. 在日志查看器中打开 App Engine 日志;如需了解详情,请参阅查看应用日志

  2. 点击 request 日志条目左侧的黑色小三角形以展开此日志。您会看到以嵌套格式显示的 request 和应用日志。

此外:

  • “子级”日志条目中的最高 severity 不会自动应用于顶级条目。如果需要该行为,请在顶级条目中手动设置最高 severity
  • 为顶级日志设置 httpRequest.requestUrl 字段。

通过 API 读取日志

目前尚无 API 可用来读取在柔性环境中创建的 App Engine 日志。

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
适用于 Python 的 App Engine 柔性环境文档