Matter Cloud Logging

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

访问日志记录

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

转到 Cloud Logging

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

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

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

Cloud Logging 提供以下资源类型:

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

执行日志

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

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

日志排除项

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

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

基于日志的指标

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

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

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

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