使用 Cloud Logging 访问事件日志

您可以通过 Google Cloud Logging 访问集成的事件日志。使用 Cloud Logging 可以浏览日志、创建指标和提醒,还可以使用 Google Cloud Pub/Sub 将日志导出到其他应用。

访问 Logging

如需从 Google Cloud Console访问 Cloud Logging,请点击查看所有产品,然后转到操作 > 日志记录

转到 Cloud Logging

通过 Identity and Access Management (IAM) 管理你的 Actions 项目用户对日志记录数据的访问权限。如需详细了解日志记录数据的角色和权限,请参阅 Cloud Logging 访问权限控制

根据 Cloud Logging 保留政策,日志条目会保留 30 天,然后系统会安排将其删除。您也可以使用日志浏览器界面按需删除条目。

您可以参阅问题排查指南的“搜索日志”部分,详细了解如何有效地使用日志。

Cloud Logging 提供以下资源类型:

资源类型 显示名 说明 标签
assistant_action_project Google 助理 Action 项目 与 Google 助理 Action 关联的 Google Cloud 项目的容器。
  • project_id:与此资源关联的当前项目的标识符,例如 my-project

事件日志

Cloud-to-cloud 项目支持 Cloud Logging 中的以下事件:

Cloud Logging 资源 事件
Google 助理 Action 项目 SYNC intent 错误
QUERY intent 错误
EXECUTE intent 错误
通知错误
帐号关联错误
Local Home SDK HandlerError

同步日志

下表列出了 syncLog 条目的架构:

媒体资源 说明
requestId 智能家居 intent 请求 ID。
httpLatencyMsec 收到响应所用的时间。
status 指示 intent 响应的状态。

执行日志

下表列出了 executionLog 条目的架构:

媒体资源 说明
requestId 唯一的请求 ID,例如 5325511189174727525
latencyMsec 收到响应所用的时间,例如 6000
executionType 用于请求的传输,例如 CLOUDMATTER,具体取决于您的集成。
actionType 所做用户操作的可选指示,例如 QUERYEXECUTE。对于 EXECUTE Action,包括针对受支持特征向执行方式发出的命令,例如 ONOFF_OFF
trait 与此用户 Action 相关联的可选特征。
deviceTypes 受该事件影响的设备类型的列表,例如 LIGHT
isSuccess 请求是否收到成功响应。
fallbackToCloud 在本地执行方式出错后是否将请求传递到云执行方式。
statusType 指示 intent 响应的状态,如 SUCCESSPENDINGOFFLINE。对于 ERROR 响应,此属性包含执行方式提供的 errorCode
externalDebugString 与此用户 Action 关联的可选详细调试消息。
locale 与请求关联的语言代码。

通知日志

下表列出了 notificationLog 条目的架构:

媒体资源 说明
requestId 通知请求 ID。
structName 通知结构体的名称,例如“ObjectDetection”。
status 指示通知的状态

日志级设置

Cloud-to-cloud 项目默认设置为接收错误日志,开发者也可以选择接收成功日志。如果您计划从几个代理处获取所有日志,这在开发阶段尤其有用。如果超出日志记录配额,您的项目可能会产生额外费用。

你可以通过以下方式控制项目的日志级别:

  1. Actions on Google Console 中,转到“项目”页面。

    前往 Actions on Google 控制台

  2. 选择你的智能家居项目。

  3. 选择 Develop 标签页,然后点击侧边栏中的 Actions

  4. Log control ingestion 下拉列表中选择 All

日志排除项

开发者可以使用日志记录查询语言创建日志排除项,从而以更灵活的方式进一步自定义其日志。日志浏览器也会使用日志记录查询语言,因此您可以使用日志浏览器帮助创建查询。

您可以按照此指南中的步骤创建排除过滤器(为 _Default 接收器配置排除过滤器)。

基于日志的指标

开发者可以使用基于日志的指标来跟踪和分析其日志中的模式。您还可以针对基于日志的指标创建自定义图表设置提醒

如需开始为智能家居使用基于日志的指标,请查看创建计数器基于日志的指标指南

如需详细了解如何在项目中使用 Cloud Logging,请参阅以下文档

  • 价格:有关配额和超额费用的详细信息。
  • 配额和限制:有关日志记录用量限制和保留政策的详细信息。
  • 高级日志查询:使用高级表达式来查询和分析日志数据的指南。