本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 同步报告和可观察性
<a name="sync-reports-observability"></a>

借助 Amazon Quick，您可以查看每个知识库的同步计划、同步活动日志和详细的同步报告。如果您的知识库启用了文档级访问控制 (ACL)，则还可以验证单个文档的权限。

## 同步日程安排和活动
<a name="sync-reports-schedules"></a>

要查看同步计划和活动，请打开知识库并选择**同步计划**选项卡。

同步日程安排  
显示配置的同步频率和时间。该表显示了发生次数（例如 “每日”）、下次计划同步的开始时间以及电子邮件通知状态。您可以添加或修改同步计划。要接收同步失败的电子邮件通知，请打开 “**同步失败时发送电子邮件”**。

同步活动  
显示所有过去同步的历史日志。您可以按时间范围（例如，过去 90 天）和同步状态（例如 “全部”、“已完成”、“失败”）进行筛选。

下表描述了同步活动列：


**同步活动列**  

| 列 | 说明 | 
| --- | --- | 
| 开始时间 | 开始同步的日期和时间。 | 
| 同步状态 | 同步结果：已排队（等待运行）、已完成（所有项目已处理）、已完成但存在问题（某些项目被跳过或失败）或失败。 | 
| Duration | 同步花了多长时间才完成。 | 
| 扫描的商品总数 | 同步期间处理的项目数。 | 
| Type | 同步是预定（自动）还是手动（通过选择 “立即同步” 按钮启动）。 | 
| 同步报告 | 查看报告链接，用于打开该运行的详细同步报告。 | 

**提示**  
要开始按需同步，请在知识库详细信息页面上选择 “**立即同步**”。

## 查看同步报告
<a name="sync-reports-review"></a>

要查看特定同步的详细结果，请打开知识库并选择**同步报告**选项卡。

使用 **“选择同步”** 下拉列表选择要检查的同步运行。

### 概述
<a name="sync-reports-overview"></a>

概述部分提供了所选同步的摘要。下表描述了概述字段：


**同步报告概述字段**  

| 字段 | 说明 | 
| --- | --- | 
| 同步状态 | 总体结果（例如，“已完成”、“已完成” 但存在问题）。 | 
| 同步类型 | 同步是定时同步还是手动同步。 | 
| 同步时长 | 同步所用的总时间。 | 
| 同步开始时间 | 同步何时开始。 | 
| 同步结束时间 | 同步完成时。 | 

### 同步项目
<a name="sync-reports-items"></a>

同步项目部分显示了同步期间处理的所有项目，这些项目分为以下类别：

可用物品  
同步后知识库中存在并已编入索引的项目：  
+ **未修改**-已编制索引但自上次同步以来未更改的项目。
+ **已修改**-先前已编入索引、已更新并重新编制索引的项目。
+ **已添加**-首次编入索引的新项目。

缺货商品  
同步后知识库中不可用的项目：  
+ 已@@ **跳过** — 已筛选的项目（例如，空文件、不支持的格式或日期筛选范围之外的项目）。
+ **失败**-由于错误而无法处理的项目。
+ **已删除**-以前已编入索引但已从来源中移除的项目。

### 筛选和检查单个物品
<a name="sync-reports-filter"></a>

**所有项目**选项卡显示同步期间处理的项目的完整列表。您可以使用以下筛选器来缩小结果范围：


**同步项目过滤器**  

| 筛选条件 | 说明 | 
| --- | --- | 
| 按状态筛选 | 按同步状态（例如 “已添加”、“已修改”、“未修改”、“已跳过”、“失败”、“已删除”）筛选项目。 | 
| 按错误类型筛选 | 按特定错误类型筛选失败或跳过的项目。 | 
| 按商品标题筛选 | 按名称搜索特定项目。 | 

设置过滤器后，选择 “**应用过滤器**” 以更新结果。

下表描述了同步项目列：


**同步项目列**  

| 列 | 说明 | 
| --- | --- | 
| 物品标题 | 文件、页面或项目的名称。 | 
| 物品状态 | 此项目的同步状态。 | 
| 错误类型 | 错误类别（如果适用）。 | 
| 错误消息 | 详细描述商品失败或被跳过的原因。 | 

### 下载报告
<a name="sync-reports-download"></a>

要导出完整同步结果以供离线分析，请在 “同步项目” 部分中选择 “**下载详细报告 (.csv)**”。CSV 文件包括所有项目及其状态、错误类型和错误消息。

## 检查文档访问权限（ACL 验证）
<a name="sync-reports-acl-verification"></a>

如果您的知识库启用了文档级访问控制 (ACL)，则可以验证特定用户是否有权访问特定文档。使用此功能可以在用户无法看到您期望他们访问的文档时进行故障排除，或者确认敏感文档是否受到适当限制。

**注意**  
ACL 验证适用于管理员管理的知识库 SharePoint 和启用 ACL 管理的 Google 云端硬盘知识库。此功能不包括带有文档级 ACL 的 Amazon S3 知识库。由于 ACL 配置文件由客户管理，因此您可以直接在 Amazon S3 中对其进行验证。

1. 打开知识库并选择 “**同步报告**” 选项卡。

1. **在同步项目列表中，为项目选择操作菜单 ()。**

1. 选择 “**查看访问详细信息”**。

**访问详细信息**面板显示：
+ 文档名称、状态和上次同步的时间戳。
+ **权限检查器**-输入用户的电子邮件地址并选择 “**检查访问权限**” 以验证该用户是否可以访问文档。
+ **用户和群组成员资格**-列出有权访问文档的所有用户和群组。

下表描述了权限检查器的结果：


**权限检查器结果**  

| 结果 | 含义 | 
| --- | --- | 
| 用户有访问权限 | 用户的身份与文档的 ACL 相匹配。他们在 “快速回复” 中看到了此文档。 | 
| [用户] 无权访问此文档 | 用户不在文档的 ACL 中。Quick 不会为他们显示此文档。 | 
| 未找到访问控制列表 | 未搜索本文档的 ACL。要么是 ACL 管理未启用，要么所需权限配置不正确。 | 

如果您看到 “未找到访问控制列表”，请执行以下步骤：
+ 确认知识库设置中已启用 ACL 管理。
+ 确认应用程序注册具有您的数据源所需的 ACL 权限。
+ 修复权限后，运行完全同步。