Traçage des journaux en temps réel - Tair (Redis® OSS-Compatible)

Le traçage des journaux en temps réel est une fonctionnalité légère de traçage des requêtes qui prend en charge le filtrage multidimensionnel et l'arrêt automatique, permettant d'identifier rapidement les comportements d'accès anormaux.

Présentation

Utilisez cette fonctionnalité pour le diagnostic en temps réel. Configurez des règles afin de tracer des requêtes spécifiques selon divers critères de filtrage. Une fois activée, le système génère des journaux d'accès détaillés pour toutes les requêtes correspondantes. Les principales caractéristiques incluent :

Résultats en temps réel : le traçage démarre immédiatement et diffuse les journaux en continu.
Filtrage multidimensionnel : permet des combinaisons flexibles de conditions, telles que le type de commande, l'adresse IP du client, la taille de la requête ou des clés spécifiques.
Contrôle de l'exécution : définissez une durée maximale (en secondes) ou une limite du nombre d'entrées de journal pour arrêter automatiquement la tâche de traçage.
Faible surcharge : la fonctionnalité ne journalise que les requêtes correspondant à vos règles, ce qui entraîne un impact sur les performances nettement inférieur à celui de la fonctionnalité Audit Log.

Cas d'utilisation

Identifier les sources des clés très sollicitées (hot keys) et des clés volumineuses : déterminez quels clients accèdent à ces clés pour optimiser vos stratégies de mise en cache.
Tracer les commandes anormales : identifiez rapidement des activités telles que des analyses malveillantes ou un abus de ressources.

Remarque

Cette fonctionnalité est destinée aux diagnostics temporaires en temps réel. Pour l'audit à long terme, nous vous recommandons d'utiliser la fonctionnalité Audit Log.

Prérequis de version

Votre instance doit être une instance Tair (Enterprise Edition) optimisée pour la mémoire, exécutant la version mineure 25.10.1.0 ou ultérieure.

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 l'instance est déployée. Localisez ensuite l'instance et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur CloudDBA > Instance Session.
Cliquez sur l'onglet Instance Tracing, puis sur Create Tracing Rule.

Remarque
Vous pouvez avoir jusqu'à cinq règles de traçage actives simultanément.

Dans le panneau qui s'affiche, configurez les règles de traçage et de filtrage.

Dans cet exemple, pour identifier quels clients accèdent à la clé volumineuse « bighash », configurez les paramètres suivants et laissez les autres avec leurs valeurs par défaut.

Rule Name : bighashKey.
Command Settings - Input : saisissez +@hash.

Remarque
Plus la règle est spécifique, plus la surcharge est faible. Par exemple, +hset engendre une surcharge inférieure à celle de +@hash.
Key Match : sélectionnez Key Pattern et saisissez bighash.

Paramètres (facultatifs)

Le paramètre Rule Name est le seul obligatoire. Toutes les autres conditions sont facultatives et sont combinées à l'aide de l'opérateur logique ET.

Catégorie	Paramètre	Description
Nom	Rule Name (obligatoire)	Nom de la règle de traçage.
Conditions de correspondance	Command Settings - Select	Ajoutez ou excluez des groupes de commandes ou des commandes spécifiques à tracer. Les combinaisons personnalisées sont prises en charge.
	Command Settings - Input	Vous pouvez également saisir des règles de commande de traçage dans cette zone de texte. La syntaxe est similaire à celle de la liste de contrôle d'accès (ACL) Redis. Par exemple, `+@write +@hash +@string -hsetnx` trace les commandes d'écriture pour les types Hash et String, mais exclut la commande HSETNX.
	Key Match	Sélectionnez All Keys ou spécifiez un Key Pattern. La correspondance par caractère générique est prise en charge.
	Channel Match	Utilisé uniquement pour le traçage des canaux des commandes Pub/Sub. Sélectionnez All Channels ou spécifiez un Channel Pattern. La correspondance par caractère générique est prise en charge.
	Client IP Match	Sélectionnez All IPs ou spécifiez un IP Pattern. Le paramètre IP Pattern prend en charge la notation CIDR. Par exemple, 192.168.1.0/24 couvre les adresses de 192.168.1.0 à 192.168.1.255.
	Response Size Limit	Unité : octets. La valeur 0 indique qu'il n'y a aucune limite.
	Request Size Limit	Unité : octets. La valeur 0 indique qu'il n'y a aucune limite.
Conditions de fin	End by Log Count	La tâche de traçage se termine lorsque l'une des conditions de fin est remplie.
Conditions de fin	Monitoring Duration

Cliquez sur Create And Run.

La tâche de traçage démarre.
Actualisez la liste Real-time Tracing Log pour afficher les journaux de requêtes correspondant à la règle. Une fois la tâche exécutée, la page Real-time Tracing Log affiche les résultats correspondants. Dans cet exemple, les journaux correspondent à la règle nommée bighash Key. Le tableau des journaux comprend les colonnes Time, Shard, Client IP address, Type, Request, Reply et Engine latency. Consultez les détails des requêtes HGET pour la clé bighash ainsi que la latence moteur correspondante. Cliquez sur View Details pour développer la réponse complète.

La tâche de traçage se termine automatiquement lorsque l'une des conditions de fin configurées est remplie. Vous pouvez ensuite modifier, supprimer ou relancer la règle de traçage.
Avertissement
- La relance d'une règle de traçage supprime les journaux d'origine. Pour conserver les journaux, exportez-les au préalable.
- La suppression d'une règle entraîne également la suppression des journaux correspondants.

Dépannage

Utilisez l'adresse IP du client et le comportement des commandes pour déboguer la logique de votre service ou configurer les paramètres de contrôle d'accès.