使用 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	用于请求的传输，例如 CLOUD 或 MATTER，具体取决于您的集成。
actionType	所做用户操作的可选指示，例如 QUERY 或 EXECUTE。对于 EXECUTE Action，包括针对受支持特征向执行方式发出的命令，例如 ONOFF_OFF
trait	与此用户 Action 相关联的可选特征。
deviceTypes	受该事件影响的设备类型的列表，例如 LIGHT。
isSuccess	请求是否收到成功响应。
fallbackToCloud	在本地执行方式出错后是否将请求传递到云执行方式。
statusType	指示 intent 响应的状态，如 SUCCESS、PENDING 或 OFFLINE。对于 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，请参阅以下文档：

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