适用于 Google Home 生态系统的 Cloud Logging

<ph type="x-smartling-placeholder"></ph> 云到云    诉讼或调查

您可以从以下位置访问集成的事件日志： Google Cloud Logging。 使用 Cloud Logging 浏览日志、创建指标和提醒，或者 使用命令行将日志导出到其他应用 Google Cloud Pub/Sub。

访问日志记录

如需从以下位置访问 Cloud Logging： Google Cloud Console, 点击查看所有产品，然后前往操作 >日志记录。

转到 Cloud Logging

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

日志条目会根据 Cloud Logging 保留 30 天 保留政策，则 已安排删除。您也可以使用 Logs Explorer 界面。

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

Cloud Logging 提供以下资源类型：

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

事件日志

Cloud-to-cloud 个项目支持 Cloud 中的以下事件 日志记录：

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 操作，包含发送到 受支持 trait 的执行方式，例如 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。

日志排除项

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

您可以按照以下网址中的步骤创建排除过滤器： 本指南 （为 _Default 接收器配置排除过滤器）。

基于日志的指标

开发者可以使用 基于日志的指标 来跟踪和分析其日志中的模式您还可以使用 创建自定义图表 和设置提醒 到这里就结束了

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

相关资源

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

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