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

# 监控索引存储使用情况
<a name="index-usage-monitoring"></a>

索引使用日志可让您了解知识库和空间（包括文件上传）如何使用您的 Amazon Quick 索引存储空间。您可以使用这些日志来跟踪增长趋势、确定最大的来源、检测意外峰值和规划容量。

在查询索引使用情况数据之前，必须配置`INDEX_USAGE_LOGS`传输。有关设置配送的说明，请参阅[使用 CloudWatch 日志监控 Amazon Quick 的使用情况](monitoring-quicksuite-chat-feedback-cloudwatch.md)。

## 日志架构
<a name="index-usage-monitoring-schema"></a>

每个索引使用情况日志事件都包括在所有 Amazon Quick 日志类型之间共享的公共字段`resource_arn`，例如`event_timestamp``log_type`、`account_id`、、和`user_arn`。该事件还包括以下特定于索引的字段：


**索引使用情况日志字段**  

| 字段 | Type | 说明 | 
| --- | --- | --- | 
| consumed\_index\_size | 整数 | 整个索引消耗的总大小（以字节为单位）。这是权威的总数。 | 
| source\_type | 字符串 | SPACE 或 KB。 | 
| source\_name | 字符串 | 显示空间或知识库的名称。 | 
| source\_arn | 字符串 | 来源的完整 ARN。 | 
| consumed\_source\_size | 整数 | 此单个来源消耗的大小（以字节为单位）。 | 
| consumed\_source\_doc\_count | 整数 | 此来源中的文档数量。 | 

**注意**  
活动按变更来源发布。并非所有来源每天都会发出事件。要重建当前状态，请使用最近的事件。`source_arn`

## CloudWatch 记录见解查询
<a name="index-usage-monitoring-queries"></a>

以下 CloudWatch Logs Insights 查询可帮助您分析索引使用情况数据。所有查询都使用该模式`stats latest(field) by source_arn`来获取每个源的最新状态。然后，这些查询将根据需要进行聚合。{{YOUR\_LOG\_GROUP}}替换为您的日志组名称。

### 按源类型划分的大小（知识库与空间的比较）
<a name="index-usage-query-kb-vs-spaces"></a>

显示知识库和空间之间的总大小分布。

```
fields @timestamp, source_type, source_arn, consumed_source_size
| stats latest(consumed_source_size) as latest_size, latest(source_type) as type by source_arn
| stats sum(latest_size) as total_size by type
```

### 一段时间内的索引总大小
<a name="index-usage-query-total-over-time"></a>

使用该`consumed_index_size`字段显示索引大小趋势。

```
fields @timestamp, consumed_index_size
| stats latest(consumed_index_size) as total_index_size by bin(1d) as day
| sort day asc
```

### 按规模排列的热门知识库
<a name="index-usage-query-top-kb"></a>

显示按大小排名的前 20 个知识库。

```
fields @timestamp, source_type, source_arn, source_name, consumed_source_size
| filter source_type = "KB"
| stats latest(consumed_source_size) as latest_size, latest(source_name) as name by source_arn
| sort latest_size desc
| limit 20
```

### 按大小排列的热门空间
<a name="index-usage-query-top-spaces"></a>

显示按大小排名的前 20 个空间。

```
fields @timestamp, source_type, source_arn, source_name, consumed_source_size
| filter source_type = "SPACE"
| stats latest(consumed_source_size) as latest_size, latest(source_name) as name by source_arn
| sort latest_size desc
| limit 20
```

### 所有来源详情
<a name="index-usage-query-all-sources"></a>

显示每个来源的最新状态，包括大小、类型、名称、文档数量和上次更新时间。

```
fields @timestamp, source_type, source_name, consumed_source_size, consumed_source_doc_count, source_arn
| stats latest(consumed_source_size) as latest_size, latest(source_type) as type, latest(source_name) as name, latest(consumed_source_doc_count) as doc_count, latest(@timestamp) as last_updated by source_arn
| sort latest_size desc
| limit 100
```

### 按总规模排列的热门用户
<a name="index-usage-query-top-users"></a>

显示所有来源中按总来源大小排名的前 20 位用户。

```
fields @timestamp, user_arn, source_arn, consumed_source_size
| parse user_arn "*:user/*/*" as @prefix, @namespace, @username
| stats latest(consumed_source_size) as latest_size, latest(@username) as user by source_arn
| stats sum(latest_size) as total_size by user
| sort total_size desc
| limit 20
```

## 创建 CloudWatch 仪表板
<a name="index-usage-monitoring-dashboard"></a>

您可以创建 CloudWatch 仪表板来可视化索引使用指标。使用 CloudWatch 控制台创建仪表板并使用上一节中的查询添加 Logs Insights 微件。

1. 打开 [CloudWatch 控制台](https://console.amazonaws.cn/cloudwatch)。

1. 在导航窗格中，选择**控制面板**。

1. 选择**创建仪表板**并输入名称（例如，`IndexUsageMetrics`）。

1. 使用 “**日志**” 小组件类型添加微件。选择您的索引使用情况日志组，然后粘贴上一节中的查询。

**提示**  
使用饼图可视化来分析来源类型细分。使用折线图来确定一段时间内的尺寸。使用条形图查看热门来源。表格可视化非常适合所有来源的详细信息查询。