Outils Redis

Outils Redis : vue de clé et streams, IntelliSense, Cluster et Sentinel, profileur, Pub/Sub, analyse de la mémoire, actions en masse, utilisateurs ACL et formats de valeurs.

Redis dispose de son propre ensemble d'outils à côté du navigateur de clés. Deux surveillent le serveur en direct via une connexion dédiée, et le reste répond aux questions administratives que les utilisateurs de Redis posent le plus : où la mémoire est allée, comment nettoyer des milliers de clés, ce qu'une valeur binaire contient réellement, et si le journal lent capture quelque chose.

Ils fonctionnent avec Redis et les serveurs qui parlent son protocole - Valkey, KeyDB, DragonflyDB, Amazon ElastiCache et Amazon MemoryDB -, ainsi qu'avec Redis Cluster (y compris le mode cluster d'ElastiCache et MemoryDB), où les commandes sont acheminées vers le nœud qui possède le slot de chaque clé, voir Cluster Redis.

Diagnostics de connexion

Tester la connexion sur une connexion Redis parcourt la connexion étape par étape et écrit chaque étape dans le journal de diagnostic au fur et à mesure, afin que vous puissiez voir exactement jusqu'où elle est allée. Ouvrez le journal avec ⌘⇧L (Ctrl+Shift+L); définissez Préférences › Avancé › Niveau de journalisation sur Détail pour voir chaque étape ; une étape qui échoue est aussi consignée au niveau Erreurs. Lorsqu'une étape échoue, l'erreur dans l'éditeur de connexion commence par cette étape - Échec de TLS : …, Échec AUTH : … - au lieu d'un « impossible de se connecter » générique.

ÉtapeCe que cela vous indique
Base de donnéesNouvelle requête, Filtrer les clés…, Effacer le filtre de clés, Scanner plus ; un Modification en masse sous-menu avec Supprimer les clés par motif… et Définir le TTL par motif… ; Importer / Exporter avec Importer le fichier de commandes… et Exporter en fichier de commandes… ; Outils avec Analyseur de mémoire…, Topologie de cluster… (sur un cluster), Profileur…, Pub/Sub…, Tableau de bord du serveur, Moniteur d'activité, Informations sur les requêtes, Utilisation du disque, Historique des requêtes et Sécurité (la page ACL) ; puis Copier le nom, Renommer… et Afficher uniquement les bases de données… pour la nommer et choisir les bases de données que vous voyez, et Actualiser.
Dossier de clésCopier la commande SCAN, Scanner plus, Supprimer les clés dans le dossier…, Définir le TTL dans le dossier…, Exporter le dossier en tant que fichier de commandes….
CléOuvrir la valeur (la vue clé), Ouvrir dans un onglet de requête ; Renommer…, un Expiration sous-menu avec Définir le TTL… et Supprimer l'expiration (PERSIST), et Copier vers avec Copier vers la base de données… et Copier vers la connexion… ; Copier avec Copier le nom et Copier la commande ; Supprimer la clé….
Rechercher dans l'indexOuvrir (FT.INFO), Requête…, Expliquer…, Profiler…, Supprimer l'index….
Noter la ligneCharger plus, Scanner plus.

Comment se comportent les connexions de SQLly

  • RESP3 lorsque le serveur le propose. SQLly demande le protocole RESP3 et reste silencieusement sur RESP2 lorsque le serveur ne l'offre pas. Les résultats semblent les mêmes dans les deux cas. SQLLY.SERVERINFO signale lequel la connexion utilise.
  • Chaque connexion a un nom. Les onglets de requête, le Profileur et le visualiseur Pub/Sub nomment leurs connexions sqlly:<connection name>:<process id>, donc CLIENT LIST et l'onglet Sessions du Moniteur d'activité montrent lesquels sont ceux de SQLly - y compris ceux du Profiler MONITOR connexion. Un serveur ou une ACL qui refuse CLIENT SETNAME les laisse tout simplement sans nom. (Sur un serveur sans RESP3, la connexion du visualiseur Pub/Sub ne peut pas être nommée.)
  • Un délai d'attente de commande. Une commande qui ne reçoit aucune réponse dans la connexion Délai d'expiration de la requête - 30 secondes lorsqu'il est vide, pas de limite lorsqu'il est 0 - échoue avec un message nommant la commande et la limite. Les commandes bloquantes obtiennent le temps d'attente que vous avez demandé en plus, donc BLPOP jobs 20 n'est jamais interrompu prématurément. La commande peut encore se terminer sur le serveur, donc SQLly ne l'exécute jamais à nouveau pour vous. Le Profiler et le visualiseur Pub/Sub attendent sans limite.
  • Les tunnels SSH restent actifs. Un tunnel envoie un keepalive SSH toutes les 30 secondes de silence (configurable via Keepalive (secondes) dans les paramètres du tunnel ; 0 le désactive), donc les tunnels inactifs survivent aux pare-feux et aux délais d'expiration NAT. Si la session SSH tombe quand même, l'exécution suivante ouvre un nouveau tunnel et ses Messages disent Tunnel rétabli. Rien n'est relancé en votre nom, vérifiez si la commande qui était en cours d'exécution lorsque le tunnel s'est interrompu a été prise en compte avant de la relancer.

Le navigateur de clés

Redis n'a pas de catalogue, si bien que sa partie de l'explorateur est construite à partir des clés elles-mêmes. Développez un serveur Redis et vous obtenez ses bases de données logiques - db0, db1, et ainsi de suite, chacune avec un nombre de clés. Développez une base de données et SQLly liste ses clés avec un parcours borné SCAN parcours (jamais KEYS *), les regroupant en dossiers selon les délimiteurs de clé de la connexion : user:42:profile atterrit dans utilisateur › 42. Le délimiteur est : à moins que vous n'en définissiez d'autres dans l'éditeur de connexion Délimiteurs de clés champ. Tapez plusieurs caractères pour les séparer sur chacun d'eux - :| plie les deux user:42 et cache|en|home - ou séparez des délimiteurs plus longs avec des espaces (:: |); un seul caractère, ou un répété comme ::, garde exactement cette signification. Chaque clé montre son type et, lorsqu'elle en a une, sa durée de vie.

Un listage peut être tronqué de deux manières, et une seule ligne de note en bas couvre les deux. Un parcours s’arrête à 10 000 clés, et l’arborescence montre les 2 000 premières lignes de ce qu’elle a scanné. La note précise ce qui est affiché parmi ce qui a été scanné et si le scan lui-même s’est interrompu, par exemple Affichage de 2 000 lignes sur 7 350, provenant de 10 000 clés scannées ; le SCAN s'est arrêté là. Cliquez sur la note pour charger plus lignes (pas de nouvelle analyse, elles ont déjà été parcourues), ou choisissez Analyser davantage sur la note, la base de données ou un dossier pour reprendre la même SCAN où cela s'est arrêté ; les nouvelles clés s'ajoutent aux lignes déjà affichées et les comptes des dossiers se mettent à jour. Utilisez Filtrer les clés… pour restreindre la liste à un modèle et Effacer le filtre de clés pour revenir en arrière. Le filtre est mémorisé par base de données sur la connexion, il est donc de nouveau en vigueur à la prochaine ouverture de l'application, et la boîte de dialogue Filtrer les clés… propose les cinq derniers motifs tapés sur cette connexion dans un Récent menu déroulant. Les dossiers réanalysent leur propre préfixe quand vous les développez, donc les arbres profonds se chargent un niveau à la fois.

Filtrer les clés fait correspondre les noms avec un glob tel que user:*; il ne regarde jamais à l'intérieur des valeurs. Si vous tapez quelque chose qui ressemble à une requête de valeur - JSON tel que {"name": "bob"} ou une requête de recherche telle que @name:bob - le dialogue le signale au lieu de ne rien lister silencieusement, et propose Rechercher des valeurs avec FT.SEARCH…. Sur un serveur avec le module de recherche et un index, cela ouvre un onglet de requête avec un FT.SEARCH sur le premier index (les autres sont nommés dans un commentaire), transformant les champs JSON en @field:"value" clauses que vous pouvez examiner et exécuter ; sans index ni module, la boîte de dialogue explique ce qui manque. Étiquettes de hachage de cluster comme {user1}:* sont des motifs ordinaires et ne déclenchent jamais l'indication.

Listes de clés dans un onglet de requête

Lorsque vous voulez trier ou filtrer les clés plutôt que de les parcourir, exécutez SQLLY.KEYS <pattern> <limit> dans un onglet de requête, par exemple SQLLY.KEYS session:* 5000. Cela parcourt l'espace de clés avec le même SCAN que l'explorateur et renvoie une grille normale avec key, type et ttl_seconds colonnes, afin que vous puissiez cliquer sur l'en-tête ttl_seconds pour trier par durée de vie restante ou utiliser Filtrer les lignes… pour conserver, par exemple, les clés sans expiration ou avec moins d'une heure restante.

Ensuite, agissez sur ce que vous avez trouvé : sélectionnez des lignes (ou toute la colonne key colonne), faites un clic droit et ouvrez Outils › Clés Redis pour Supprimer les clés sélectionnées…, Définir le TTL sur les clés sélectionnées… ou Supprimer l’expiration des clés sélectionnées…. La boîte de dialogue liste d'abord les clés sélectionnées, une suppression vous demande de retaper le nombre de clés, et rien ne s'écrit sur une connexion en lecture seule ou de production verrouillée, les mêmes protections que les actions groupées. Le même menu apparaît sur le rapport des principales clés de l'Analyseur de mémoire (SQLLY.TOPKEYS) et sur SQLLY.KEYINFO; les résultats dont la colonne key colonne n'est pas un nom de clé, comme INFO, ne l'offrent jamais. Les clés agissent sur la connexion et la base de données contre lesquelles l'onglet s'exécute.

Chaque ligne de base de données montre son nombre de clés et, lorsqu'une clé a une expiration, combien - 120 clés · expire : 7 - directement à partir des statistiques de l'espace de clés du serveur. L'ouverture d'une liste, d'un ensemble trié ou d'un flux lit ses 1 000 premiers éléments, et l'onglet est nommé ainsi (orders — 1 000 premiers) de sorte qu'une longue valeur ne soit jamais confondue avec l'ensemble.

SQLly
Explorateur de clés SQLLY listant les bases de données Redis 0 à 15 pour Session Cache, avec le nombre de clésExplorateur de clés SQLLY listant les bases de données Redis 0 à 15 pour Session Cache, avec le nombre de clés
Le navigateur de clés pour Session Cache : chaque base de données Redis avec son nombre de clés et son résumé d’expiration.

Ce que les menus contextuels offrent

Sur un…Vous pouvez
Base de donnéesNouvelle requête, Filtrer les clés…, Effacer le filtre de clés, Scanner plus ; Modification en masse (Supprimer les clés par motif…, Définir le TTL par motif…) ; Importer / Exporter (Importer un fichier de commande…, Exporter en tant que fichier de commande…); et Outils avec Analyseur de mémoire…, Profileur…, Pub/Sub…, Tableau de bord du serveur, Moniteur d'activité, Informations sur les requêtes, Utilisation du disque et Historique des requêtes.
Dossier de clésCopier la commande SCAN, Scanner plus, Supprimer les clés dans le dossier…, Définir le TTL dans le dossier….
CléOuvrir la valeur, Ouvrir dans un onglet de requête ; Renommer…, Expiration (Définir le TTL…, Supprimer l'expiration (PERSIST)), Copier vers; Copier (Copier le nom, Copier la commande); Supprimer la clé….
Noter la ligneCharger plus, Scanner plus.

Les entrées d'écriture - suppressions, modifications de TTL, renommages, copies et importations - sont grisées sur une connexion réglée sur Bloquer tout sauf SELECT, et une connexion de production verrouillée vous demande de déverrouiller les écritures d'abord.

Dans un onglet de requête, une connexion Redis exécute une commande par ligne. IntelliSense des commandes complète les commandes, les options, les sous-commandes et les noms de clés ; la validation SQL et le formateur ne s'appliquent pas.

Lire et modifier les clés

Ouvrir une clé dans la vue des clés pour parcourir sa valeur et la modifier avec la commande indiquée en premier ; une clé de flux ajoute des onglets pour ses groupes de consommateurs et les entrées en attente. Dans un onglet de requête, IntelliSense des commandes complète les commandes, les options et les noms de clés, et les réponses de Redis Stack reviennent sous forme de tableaux.

Vue des clés
Ouvrez une clé en tant que vue : bandeau d'en-tête, valeur paginée et modifications par type qui montrent la commande exacte avant son exécution.
Flux et groupes de consommateurs
Parcourez un flux, consultez les groupes, les consommateurs, les entrées en attente et le retard, et exécutez depuis la vue de la clé des commandes de flux revues avant exécution.
IntelliSense des commandes
Commandes complètes, options, sous-commandes et noms de clés scannés, avec syntaxe et badges de sécurité au survol.
Modules Redis Stack
JSON, Search, TimeSeries et les types probabilistes sous forme de véritables grilles, plus le navigateur d'index de recherche dans l'explorateur.

Connexion aux clusters et à Sentinel

Une connexion peut acheminer les commandes à travers un Cluster Redis, y compris le mode cluster ElastiCache et MemoryDB, ou trouver le maître actuel via Sentinelle et suivre les basculements.

Cluster Redis
Redis Cluster, mode cluster ElastiCache et MemoryDB : routage des slots, carte des nœuds pour les adresses de nœuds inaccessibles, transferts SSH par nœud et topologie.
Sentinelle
Se connecter via Redis Sentinel par le nom du maître, lire depuis les réplicas et survivre aux basculements.

Regardez-le en direct

Faites appel à ces outils quand vous voulez voir le trafic en direct : le Profileur pour trouver quel client martèle une clé, le Visionneuse Pub/Sub pour vérifier que les messages sont publiés là où vous vous y attendez. Les deux sont des onglets dans le Moniteur d'activité et s'exécutent uniquement dans l'application de bureau.

Profileur
Une capture MONITOR bornée, limitée dans le temps, sur sa propre connexion, avec pause, filtres et arrêt net.
Visionneuse Pub/Sub
Abonnez-vous aux canaux, aux motifs ou à chaque événement de clé d'une base de données et regardez les messages arriver en direct.

Entretenez-le

Commencer par Outils › Utilisation du disque pour la mémoire par base de données, puis le analyseur de mémoire pour voir quels types et clés en sont responsables. Actions en masse nettoyez ce que vous trouvez, formats de valeurs décoder ce que contient réellement une clé, et le journal lent la page couvre le seuil qui décide quelles commandes sont consignées.

Analyseur de mémoire
Mémoire par type de données, les plus grandes clés et un histogramme TTL à partir d'un échantillon limité.
Actions en masse
Supprimez des clés par motif ou faites-les expirer, avec un décompte de simulation d’abord, et importez des fichiers de commandes.
Utilisateurs ACL
Voir chaque utilisateur ACL et les refus d'accès récents, et générer le script des modifications ACL SETUSER / ACL DELUSER pour révision.
Formats de valeurs
Affichez une valeur en UTF-8, JSON, hexadécimal, MessagePack, Base64, Protobuf, ou en gzip, zstd et LZ4 décompressés, avec votre choix mémorisé par clé.
Seuil du journal des requêtes lentes
Voir le seuil du journal lent et le modifier via un CONFIG SET examiné.

Les outils en direct ouvrent leur propre connexion et ont toujours un plafond et un bouton d’arrêt, donc en laisser un ouvert ne peut ni remplir votre mémoire ni accaparer la connexion que vos requêtes utilisent. L’échantillon de l’analyseur de mémoire et le décompte de simulation des actions en masse ont un Arrêter aussi : un échantillon arrêté conserve les rapports précédents à l'écran, et un compte arrêté est étiqueté partiel.