这是与 Recommendations AI、Retail Search 和新的 Retail 控制台相关的文档。如需在受限 GA 阶段使用 Retail Search,请与 Cloud 销售人员联系

如果您仅使用 Recommendations AI,请保留在 Recommendations 控制台上并参阅 Recommendations AI 文档

监控和问题排查

本页面介绍如何获取目录和用户事件导入中发生的错误以及其他 Retail API 操作。

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

简介

向 Retail API 提供准确的目录信息和用户事件对于获得最高质量的结果非常重要。监控和了解错误来源有助于您查找和修复网站中的所有错误。

查看汇总的集成错误

如需查看数据上传流程和预测或搜索请求产生的聚合错误,请使用“监控”和“分析”页面上的监控标签页。

本页面显示了 Retail API 的所有错误。您可以查看与商品清单、用户事件、Recommendations AI 预测、Retail Search 搜索结果和模型相关的错误。系统还会记录导入操作中的错误,例如 Cloud Storage 文件中格式错误的行。系统为每个导入文件最多记录 100 个错误。您可以定义错误显示的时间段,并根据错误类型进行过滤。

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

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

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

查看特定集成操作的状态

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

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

    转到“数据”页面

  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 中打开日志文件。例如,此链接将打开过去一小时内所有 Retail 错误的日志:Open Retail 日志

查看数据加载指标

数据上传系统成功运行后,您还可以使用 Retail 数据页面上的目录事件标签页来查看数据注入的错误指标以确保一切运行顺畅。

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

目录数据摘要

您可以在数据页面上的目录标签页中查看每个目录分支的概要数据统计信息。此页面显示了您已导入的商品数量、多少商品有库存,以及上次为每个商品清单分支导入产品的时间。

您还可以预览已上传的目录项,并根据产品字段进行过滤。

您可以将数据导入不同分支,以便暂存和预览 Recommendations AI 或 Retail Search 结果。例如,为了为假期做好准备,您可以将新的目录数据上传到非默认分支,并确保零售结果正确生成,然后在您的网站上发布。

用户事件记录统计信息

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

指标图表显示一段时间内提取的用户事件,您可以按用户事件类型过滤。

数据质量指标

数据页面上,点击查看数据质量以打开数据质量面板。

  • 目录标签页会显示您的目录中符合每个质量指标的产品所占的百分比。这些指标可帮助您评估商品数据的搜索质量。

  • 事件标签页显示有多少用户事件满足每个数据质量要求。这些指标可帮助您评估用户事件的搜索质量。您可以按时间范围过滤结果,然后点击每个要求对应的查看日志

未联接的事件

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

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

API 错误

通过点击 Monitoring 和 Analytics(分析)页面 按钮栏上的查看 API 指标,您可以看到 API 错误随时间变化的图表,按方法名称显示。

监控 API 方法活动

如需按 API 方法直观呈现流量、错误和延迟时间,请转到“监控和分析”页面上的监控标签页。您可以选择预设的时间段,也可以输入自定义时间范围。

要查看每个图表的更多详细信息,请执行以下操作:

  • 在图表下方,点击一个方法名称,以便在图表中将其隔离。
  • 将光标悬停在图表上,即可查看标注以及其中包含的各个方法及其相应时间点的值。
  • 点击并拖动图表的任意部分来放大该时间段。

后续步骤