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 天,然后系统会安排将其删除。您也可以使用日志浏览器界面按需删除条目。

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

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 响应的状态,如 SUCCESSPENDINGOFFLINE。对于 ERROR 响应,此属性包含执行方式提供的 errorCode
externalDebugString 与此用户 Action 关联的可选详细调试消息。
locale 与请求关联的语言代码。

日志排除项

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

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

基于日志的指标

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

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

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

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