Identify large keys and hot keys in your Redis instance in real time - Tair (Redis® OSS-Compatible)

Mécanisme d'identification et de classement

Pour éviter de surcharger votre base de données, cette fonctionnalité collecte des statistiques uniquement sur les clés accessibles via les opérations de lecture ou d'écriture des clients. Elle conserve et affiche uniquement un nombre défini de clés principales pour chaque type, au lieu d'analyser toutes les clés de la base de données en temps réel. De plus, après le redémarrage d'une instance ou un basculement de haute disponibilité (HA), les statistiques collectées sont effacées et le processus recommence. Par conséquent, les clés qui n'ont pas été consultées depuis longtemps peuvent ne pas figurer dans les statistiques. Pour analyser l'utilisation de la mémoire et la distribution de toutes les clés de votre base de données, utilisez la fonctionnalité Analyse hors ligne des clés.

Type de clé	Versions applicables	Mécanisme statistique	Description
Clé volumineuse (par nombre d'éléments)	Redis Open-Source Edition 5,0 ou ultérieure. Tair (Enterprise Edition).	Une clé est considérée comme volumineuse si son nombre d'éléments (champs dans un Hash ou membres dans un Set, par exemple) atteint ou dépasse un seuil (par défaut : 2 000). Personnalisez ce seuil en définissant le paramètre `bigkey-threshold`. Remarque Les instances à mémoire persistante ne prennent pas en charge le paramètre `bigkey-threshold`. Si ce paramètre n'est pas affiché dans les paramètres, mettez à niveau la version mineure de votre instance et réessayez.	Affiche jusqu'aux trois clés les plus volumineuses pour chaque type de données. Si plusieurs clés ont le même nombre d'éléments, celle qui a été écrite en premier est prioritaire. Remarque Pour les instances à mémoire persistante de Tair (Enterprise Edition), seules les trois premières clés par nombre d'éléments tous types confondus sont affichées. Pour les autres instances, si seulement trois clés volumineuses sont affichées au total, mettez à niveau la version mineure et réessayez.
Clé volumineuse (par utilisation de la mémoire)	Instances cloud-native optimisées pour la mémoire de Tair (Enterprise Edition) avec une version mineure 25.6.0.0 ou ultérieure.	Une clé est considérée comme volumineuse si son utilisation totale de la mémoire dépasse un seuil (par défaut : 500 Mo). Personnalisez ce seuil en définissant le paramètre `bigkey-mem-threshold`. Une clé est également considérée comme volumineuse si l'utilisation moyenne de la mémoire de ses éléments dépasse 1 Mo. Personnalisez ce seuil en définissant le paramètre `bigkey-field-mem-threshold`. Par exemple, une clé String est considérée comme volumineuse si sa valeur dépasse 1 Mo. Une clé Hash avec 100 paires clé-valeur est considérée comme volumineuse si son utilisation totale de la mémoire entraîne une taille moyenne d'élément supérieure à 1 Mo. À compter du 26 mai 2026, la valeur par défaut de `bigkey-field-mem-threshold` passe de 50 Mo à 1 Mo.	Affiche jusqu'aux trois clés les plus volumineuses pour chaque type de données. Si les clés ont la même utilisation de mémoire, celle qui a été écrite en premier est prioritaire.
Clé très sollicitée (par QPS)	Redis Open-Source Edition 5,0 ou ultérieure. Tair (Enterprise Edition).	Une clé est considérée comme très sollicitée si son nombre de requêtes par seconde (QPS) dépasse 5 000. Personnalisez ce seuil en définissant le paramètre `hotkey-threshold`.	Le système affiche jusqu'aux 50 clés les plus sollicitées et indique leur QPS précis en temps réel. La prise en charge des statistiques sur les clés très sollicitées est limitée dans les versions mineures antérieures. Nous vous recommandons de mettre à niveau vers la dernière version mineure. Dans les versions antérieures à Redis Open-Source Edition 7.0.18, 6.0.2.9 et 5.5.2.9, ou aux versions optimisées pour la mémoire Tair 5.0.50 et 25.2.0.0, le seuil QPS pour les clés très sollicitées était fixé à 3 000 et ne pouvait pas être ajusté. Seule une plage QPS approximative pouvait être affichée, et Redis Open-Source Edition prenait en charge les statistiques pour seulement 20 clés très sollicitées.
Clé très sollicitée (par trafic)	Instances cloud-native optimisées pour la mémoire de Tair (Enterprise Edition) avec une version mineure 25.2.0.0 ou ultérieure.	Une clé est considérée comme très sollicitée si son trafic d'accès dépasse 1 Mo/s. Cette fonctionnalité est désactivée par défaut. Activez-la en définissant le paramètre `#no_loose_high-cost-key-enabled` sur `yes`. Ajustez le seuil de trafic en o/s en définissant le paramètre `#no_loose_high-cost-key-traffic-bytes-threshold`. Utilisez les paramètres `#no_loose_high-cost-key-parse-hashtag` et `#no_loose_high-cost-key-parse-prefix` pour activer les statistiques pour les hashtags et les préfixes. Cela permet au système d'identifier les cas où les clés individuelles ont un faible trafic, mais où le trafic agrégé des clés ayant le même hashtag ou préfixe dépasse le seuil. Cette fonctionnalité nécessite une mise à niveau vers la version mineure 25.9.1.0 ou ultérieure.	Le système affiche jusqu'aux 50 clés les plus sollicitées et indique leur trafic entrant et sortant précis, ainsi que leur fréquence d'accès. Remarque Les statistiques pour les clés inexistantes sont prises en charge. Si le type de données est affiché sous la forme not-exist-key, cela indique que la clé n'existe pas mais est fréquemment consultée.

Cette fonctionnalité prend en charge les structures de données suivantes :

Structures de données Redis natives : String, List, Hash, Set, Zset et Stream
Structures de données développées par Tair : TairString, TairHash, TairGIS, TairBloom, TairDoc, TairCpc, TairZset, TairRoaring, TairTS et TairSearch

Remarque
Les instances à mémoire persistante de Tair (Enterprise Edition) prennent en charge les statistiques uniquement pour TairHash et TairString.

Procédure

Connectez-vous à la console et accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région dans laquelle se trouve l'instance que vous souhaitez gérer. Recherchez ensuite l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche, choisissez CloudDBA > Top Key Statistics.
Sur cette page, consultez les données en temps réel et historiques.
La page Top Key Statistics contient quatre sections : Real-time Large Keys, Historical Large Keys, Real-time Hot Keys et Historical Hot Keys. Définissez les seuils d'identification des clés volumineuses et très sollicitées, cliquez sur Refresh pour récupérer manuellement les dernières données, ou activez Auto-refresh pour mettre à jour automatiquement les résultats.
Remarque
- Si votre instance utilise une architecture en cluster ou une architecture de séparation lecture/écriture, vous pouvez également sélectionner un nœud spécifique dans la liste déroulante Current Node pour consulter ses données.
- Vous pouvez interroger les données historiques des quatre derniers jours. La plage de temps maximale pour une seule requête est de trois heures.

Référence API

API DAS

Description

DescribeHotBigKeys

Récupère les clés très sollicitées et les clés volumineuses en temps réel actuellement en mémoire.

DescribeTopHotKeys

Récupère les 20 clés les plus sollicitées sur une période spécifiée.

DescribeTopBigKeys

Récupère les 20 clés les plus volumineuses sur une période spécifiée.

DescribeHotKeys

Récupère les clés très sollicitées d'une instance Redis.

FAQ

Q : Pourquoi les clés de type String sont-elles affichées sous Large key (by number of elements) ?

R : Dans Redis Open-Source Edition et certaines versions antérieures de Tair, les clés de type String sont affichées si la longueur de leur valeur dépasse le seuil, qui est par défaut de 2 000.
Pourquoi une clé comportant moins de 10 éléments apparaît-elle comme une clé volumineuse ?

La cause la plus probable est que le nom de la clé lui-même est volumineux. Exécutez memory usage key_name pour vérifier son empreinte mémoire réelle. Si le résultat est anormalement élevé, envisagez de renommer ou de restructurer la clé.

Une cause moins courante est une version mineure obsolète. Les instances dont la version mineure est antérieure à 5.2.7 ont un paramètre bigkey-threshold par défaut de 0, ce qui fait apparaître des clés à faible utilisation de mémoire comme des clés volumineuses. Mettez à niveau la version mineure pour résoudre ce problème.

Documents connexes

L'utilisation du client TairJedis simplifie la mise en œuvre de la structure de données propriétaire exZset de Tair pour les classements contenant plus de 100 000 éléments.

En utilisant le client TairJedis, vous pouvez facilement mettre en œuvre une architecture de classement distribué. Il vous suffit de gérer une seule clé, et Tair distribue automatiquement les données et les tâches de calcul sur plusieurs sous-clés. Cette approche empêche efficacement la création de clés volumineuses et de clés très sollicitées.
Pour résoudre les problèmes d'utilisation élevée du CPU dans une instance Redis, consultez Résoudre les problèmes d'utilisation élevée du CPU d'une instance.
Pour résoudre les problèmes d'utilisation élevée de la mémoire dans une instance Redis, consultez Résoudre les problèmes d'utilisation élevée de la mémoire d'une instance.