这是仅与 Recommendations AI 相关的文档。如需在受限 GA 阶段试用 Retail Search 和统一 Retail 控制台,请与 Cloud 销售人员联系如果您不打算使用 Retail Search,请保留在 Recommendations 控制台上,直到收到进一步的通知。

如果您使用的是 v1beta 版 Recommendations AI,请迁移到 Retail API 版本

排查集成问题

本页介绍如何获取有关数据加载(目录和用户事件)和预测中发生的错误的信息。

如需有关设置提醒的帮助,请参阅设置提醒

简介

向 Recommendations AI 提供准确的目录信息和用户事件对于获得最高质量的推荐非常重要。了解数据加载和预测错误的来源有助于您查找和修复网站中的任何错误。

查看汇总的集成错误

如需查看数据上传流程和预测请求产生的汇总错误,请使用“错误”页面

“错误”标签页

点击相应标签页以选择商品清单错误用户事件错误预测错误。系统还会记录用户事件/目录导入中的错误,例如 Google Cloud Storage 文件中格式错误的行。我们的系统为每个导入文件最多记录 100 个错误。您可以定义错误显示的时间段,并根据错误类型进行过滤。

您可以点击单个错误以在 Cloud Logging 中查看该错误的日志。

以下是单个错误的日志示例:

错误日志

您可以通过展开单个错误日志来打开该日志。错误日志提供有关请求的更多详细信息,包括请求和响应载荷以及错误详情。此信息可帮助您确定错误的方法调用在网站中的位置。

例如,以下是展开的错误日志,以显示请求载荷信息:

日志明细视图

对于无效的 JSON 错误,您可以通过展开 status 字段来获取有关该问题的更多信息:

JSON 错误日志的详细视图

查看特定集成操作的状态

您可以使用集成活动面板查看特定集成操作的状态:

  1. 转到 Google Cloud Console 中的“Recommendations AI 数据”页面。
    转到“Recommendations AI 数据”页面

  2. 点击按钮栏右侧的查看导入活动以打开导入活动面板。

    您可以检查特定集成操作出现的错误。

  3. 在任何发生错误的操作的“详细信息”列中点击查看日志,可检查 Cloud Logging 中的相应日志文件。

导入活动面板

错误类型

  • MISSING_FIELD:未设置必填字段值。例如,目录项缺少标题。
  • INVALID_TIMESTAMP:时间戳无效,例如遥远的未来,或者格式不正确。
  • FIELD_VALUE_TOO_SMALL:字段中的值低于所需的最小值;例如负数价格。
  • INCORRECT_JSON_FORMAT:请求中的 JSON 格式不正确;例如缺少 { 括号。
  • INVALID_LANGUAGE_CODE:语言代码格式不正确。
  • FIELD_VALUE_EXCEEDED:字段中的值大于允许的最大值。
  • INVALID_RESOURCE_ID:资源 ID 无效;例如,资源名称中的 catalog_id 不存在。
  • FIELD_SIZE_EXCEEDED:字段中的条目数超出上限。
  • UNEXPECTED_FIELD:本该留空的字段包含一个值;例如,详情页面查看事件对应的事务。
  • INVALID_FORMAT:字段格式不正确,例如字符串格式不正确
  • RESOURCE_ALREADY_EXISTS:您尝试创建已存在的资源,例如先前创建的目录商品。
  • INVALID_API_KEY:API 密钥与请求中的项目不匹配。
  • INSUFFICIENT_PERMISSIONS:您无权执行请求;此错误通常与缺少必要的 IAM 权限有关。
  • UNJOINED_WITH_CATALOG:请求中包括目录中不存在的目录项 ID。确保您的目录为最新状态。
  • BATCH_ERROR:请求中包含多个错误;例如,内嵌导入内容中有10 件商品因不同原因未通过验证。
  • INACTIVE_RECOMMENDATION_MODEL:您查询的模型目前无法提供服务。
  • ABUSIVE_ENTITY:与请求关联的访问者 ID 或用户 ID 在短时间内发送的事件次数异常。
  • FILTER_TOO_STRICT:预测请求过滤条件阻止了所有预测结果。返回一般(非个性化)热门项,除非调用将 strictFiltering 指定为 false(在这种情况下,不返回任何项)。导致此问题的一些常见原因:

    • 您所指定的过滤标记在您的目录中不存在。过滤标记更新最长可能需要一天才会生效。
    • 您的过滤条件范围太小。

直接查看日志

您也可以直接在 Logging 中打开日志文件。例如,以下链接会打开过去一小时内所有 Recommendations AI 错误的日志:

打开 Recommendations AI 日志

查看概要数据加载指标

数据上传系统成功运行后,您还可以使用“Recommendations AI 数据”页面上的“目录”和“事件”标签页来查看数据提取的概要错误指标以确保系统一切正常。

您还可以添加提醒,以便系统在数据上传系统出现问题时通知您。

目录数据摘要

“目录”标签页中的概要数据统计信息会显示您已导入多少项、多少项有库存,以及您上次导入目录项的时间。

您还可以查看您上传的目录商品的预览,并根据目录商品 ID 进行过滤。

目录导入数据

用户事件记录统计信息

对于每种用户事件,您可以在事件标签页中查看已记录多少个事件,以及有多少事件无法与目录商品关联(未联接事件),以及这些数字与上一时间段相比如何。您可以选择一天、一周和一个月的时间段,也可以输入自定义的时间范围。

您可以查看一段时间内提取的用户事件图表,并按用户事件类型过滤事件。

用户事件统计信息

未联接的事件

如果用户事件或预测请求是指尚未上传到 Recommendations AI 的目录项,则为未联接的事件。未联接的用户事件仍将被记录下来,并且系统会处理未联接的预测请求,但两者都无法用于进一步改进模型以用于将来的预测。因此,对于用户事件和预测请求而言,您应确保未记录的事件百分比极低。

您可以在“数据”页面的“事件”标签页中查看未联接的用户事件百分比:

未联接的用户事件

您可以在“展示位置”页面上查看未联接的预测请求百分比:

未联接的预测请求

API 错误

您可以点击“错误”页面按钮栏上的查看 API 指标,以查看一段时间内的 API 错误图表(按方法名称显示)。

后续步骤