

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Surveiller l'utilisation du stockage d'index
<a name="index-usage-monitoring"></a>

Les journaux d'utilisation des index fournissent une visibilité sur la façon dont votre stockage d'index Amazon Quick est utilisé dans les bases de connaissances et les espaces, y compris les téléchargements de fichiers. Vous pouvez utiliser ces journaux pour suivre les tendances de croissance, identifier les principales sources, détecter les pics inattendus et planifier les capacités.

Avant d'interroger les données d'utilisation de l'index, vous devez configurer `INDEX_USAGE_LOGS` la livraison. Pour obtenir des instructions sur la configuration de la livraison, consultez[Surveillance de l'utilisation d'Amazon Quick à l'aide CloudWatch des journaux](monitoring-quicksuite-chat-feedback-cloudwatch.md).

## Schéma du journal
<a name="index-usage-monitoring-schema"></a>

Chaque événement du journal d'utilisation de l'index inclut les champs communs qui sont partagés entre tous les types de journaux Amazon Quick`resource_arn`, tels que `event_timestamp``log_type`,`account_id`,, et`user_arn`. L'événement inclut également les champs spécifiques à l'indice suivants :


**Champs du journal d'utilisation de l'index**  

| Champ | Type | Description | 
| --- | --- | --- | 
| consumed\_index\_size | Entier | Taille totale (en octets) consommée par l'index entier. C'est le total qui fait autorité. | 
| source\_type | String | SPACE ou KB. | 
| source\_name | String | Afficher le nom de l'espace ou de la base de connaissances. | 
| source\_arn | String | ARN complet de la source. | 
| consumed\_source\_size | Entier | Taille (en octets) consommée par cette source individuelle. | 
| consumed\_source\_doc\_count | Entier | Nombre de documents contenus dans cette source. | 

**Note**  
Les événements sont publiés par source en fonction des modifications. Toutes les sources n'émettent pas d'événements tous les jours. Pour reconstituer l'état actuel, utilisez l'événement le plus récent par. `source_arn`

## CloudWatch Requêtes Logs Insights
<a name="index-usage-monitoring-queries"></a>

Les requêtes CloudWatch Logs Insights suivantes vous aident à analyser les données d'utilisation de l'index. Toutes les requêtes utilisent le modèle `stats latest(field) by source_arn` pour obtenir l'état le plus récent par source. Les requêtes sont ensuite agrégées selon les besoins. {{YOUR\_LOG\_GROUP}}Remplacez-le par le nom de votre groupe de journaux.

### Taille par type de source (bases de connaissances comparées à Spaces)
<a name="index-usage-query-kb-vs-spaces"></a>

Indique la taille totale répartie entre les bases de connaissances et les espaces.

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

### Taille totale de l'indice au fil du temps
<a name="index-usage-query-total-over-time"></a>

Affiche la tendance de la taille de l'index à l'aide du `consumed_index_size` champ.

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

### Principales bases de connaissances par taille
<a name="index-usage-query-top-kb"></a>

Affiche les 20 meilleures bases de connaissances classées par taille.

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

### Espaces les plus populaires par taille
<a name="index-usage-query-top-spaces"></a>

Affiche les 20 meilleurs espaces classés par taille.

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

### Détail de toutes les sources
<a name="index-usage-query-all-sources"></a>

Affiche l'état le plus récent de chaque source avec la taille, le type, le nom, le nombre de documents et l'heure de la dernière mise à jour.

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

### Principaux utilisateurs par taille totale
<a name="index-usage-query-top-users"></a>

Affiche les 20 meilleurs utilisateurs classés par taille totale des sources, toutes sources confondues.

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

## Création d'un CloudWatch tableau de bord
<a name="index-usage-monitoring-dashboard"></a>

Vous pouvez créer un CloudWatch tableau de bord pour visualiser les mesures d'utilisation de l'index. Utilisez la CloudWatch console pour créer un tableau de bord et ajouter des widgets Logs Insights en utilisant les requêtes de la section précédente.

1. Ouvrez la [CloudWatch console](https://console.aws.amazon.com/cloudwatch).

1. Dans le panneau de navigation, choisissez **Dashboards** (Tableaux de bord).

1. Choisissez **Créer un tableau de bord** et entrez un nom (par exemple,`IndexUsageMetrics`).

1. Ajoutez des widgets en utilisant le type de widget **Logs**. Sélectionnez votre groupe de journaux d'utilisation de l'index et collez les requêtes de la section précédente.

**Astuce**  
Utilisez la visualisation sous forme de graphique circulaire pour la ventilation par type de source. Utilisez le graphique linéaire pour connaître la taille au fil du temps. Utilisez le graphique à barres pour voir les principales sources. La visualisation du tableau fonctionne bien pour la requête détaillée de toutes les sources.