As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Monitore o uso do armazenamento de índices
<a name="index-usage-monitoring"></a>

Os registros de uso do índice fornecem visibilidade de como o armazenamento de índices do Amazon Quick é consumido em todas as bases de conhecimento e espaços, incluindo uploads de arquivos. Você pode usar esses registros para rastrear tendências de crescimento, identificar as maiores fontes, detectar picos inesperados e planejar a capacidade.

Antes de consultar os dados de uso do índice, você deve configurar a `INDEX_USAGE_LOGS` entrega. Para obter instruções sobre como configurar a entrega, consulte[Monitorando o uso do Amazon Quick usando CloudWatch registros](monitoring-quicksuite-chat-feedback-cloudwatch.md).

## Esquema de logs
<a name="index-usage-monitoring-schema"></a>

Cada evento de registro de uso do índice inclui os campos comuns que são compartilhados entre todos os tipos de log do Amazon Quick `resource_arn``event_timestamp`, como`log_type`,`account_id`,, `user_arn` e. O evento também inclui os seguintes campos específicos do índice:


**Campos do registro de uso do índice**  

| Campo | Tipo | Description | 
| --- | --- | --- | 
| consumed\_index\_size | Inteiro | Tamanho total (em bytes) consumido por todo o índice. Esse é o total autorizado. | 
| source\_type | String | SPACE ou KB. | 
| source\_name | String | Nome de exibição do Espaço ou da base de conhecimento. | 
| source\_arn | String | ARN completo da fonte. | 
| consumed\_source\_size | Inteiro | Tamanho (em bytes) consumido por essa fonte individual. | 
| consumed\_source\_doc\_count | Inteiro | Número de documentos nessa fonte. | 

**nota**  
Os eventos são publicados por fonte em caso de mudança. Nem todas as fontes emitem eventos todos os dias. Para reconstruir o estado atual, use o evento mais recente por. `source_arn`

## CloudWatch Consultas do Logs Insights
<a name="index-usage-monitoring-queries"></a>

As seguintes consultas do CloudWatch Logs Insights ajudam você a analisar os dados de uso do índice. Todas as consultas usam o padrão `stats latest(field) by source_arn` para obter o estado mais recente por fonte. Em seguida, as consultas são agregadas conforme necessário. {{YOUR\_LOG\_GROUP}}Substitua pelo nome do seu grupo de registros.

### Tamanho por tipo de fonte (bases de conhecimento em comparação com Spaces)
<a name="index-usage-query-kb-vs-spaces"></a>

Mostra o tamanho total dividido entre bases de conhecimento e espaços.

```
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
```

### Tamanho total do índice ao longo do tempo
<a name="index-usage-query-total-over-time"></a>

Mostra a tendência do tamanho do índice usando o `consumed_index_size` campo.

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

### Principais bases de conhecimento por tamanho
<a name="index-usage-query-top-kb"></a>

Mostra as 20 principais bases de conhecimento classificadas por tamanho.

```
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
```

### Melhores espaços por tamanho
<a name="index-usage-query-top-spaces"></a>

Mostra os 20 melhores espaços classificados por tamanho.

```
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
```

### Detalhe de todas as fontes
<a name="index-usage-query-all-sources"></a>

Mostra o estado mais recente de cada fonte com tamanho, tipo, nome, contagem de documentos e horário da última atualização.

```
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
```

### Principais usuários por tamanho total
<a name="index-usage-query-top-users"></a>

Mostra os 20 principais usuários classificados pelo tamanho total da fonte em todas as fontes.

```
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
```

## Crie um CloudWatch painel
<a name="index-usage-monitoring-dashboard"></a>

Você pode criar um CloudWatch painel para visualizar as métricas de uso do índice. Use o CloudWatch console para criar um painel e adicionar widgets do Logs Insights usando as consultas da seção anterior.

1. Abra o [console do CloudWatch](https://console.aws.amazon.com/cloudwatch).

1. No painel de navegação, escolha **Painéis**.

1. Escolha **Criar painel** e insira um nome (por exemplo,`IndexUsageMetrics`).

1. Adicione widgets usando o tipo de widget **Logs**. Selecione seu grupo de registros de uso do índice e cole as consultas da seção anterior.

**dica**  
Use a visualização do gráfico circular para o detalhamento do tipo de fonte. Use o gráfico de linhas para ver o tamanho ao longo do tempo. Use o gráfico de barras para ver as principais fontes. A visualização da tabela funciona bem para a consulta detalhada de todas as fontes.