Visionneuse Pub/Sub

fonctionnel

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.

La visionneuse Pub/Sub s'abonne aux canaux et aux motifs et affiche chaque message dès son arrivée : une ligne par message avec l'heure à laquelle SQLly l'a reçue, le canal, le motif correspondant (pour les abonnements à motifs), l'événement et la clé quand le message est une notification d'espace de clés, et la charge utile. Elle se trouve dans le Moniteur d'activité comme l'onglet Pub/Sub sur les connexions Redis et compatibles Redis (Valkey, KeyDB, Dragonfly, Amazon ElastiCache, Amazon MemoryDB). Depuis la palette de commandes, le Visualiseur Pub/Sub Redis… et Pub/Sub… dans le menu contextuel d'une base de données Redis ouvre le moniteur directement dessus.

Abonnement

Tapez un ou plusieurs noms, séparés par des virgules, et appuyez sur S'abonner. Un nom simple (orders) s'abonne avec SUBSCRIBE; un nom avec des caractères génériques (alerts.*, metrics.[ab], job?) s'abonne avec PSUBSCRIBE. Pour s'abonner à un canal dont le nom contient lui-même des caractères génériques, commencez-le par =: =orders[eu] s'abonne au canal littéralement nommé orders[eu] (écrivez ==x pour un canal nommé =x). Les noms ne peuvent pas contenir de virgules, puisqu'elles les séparent. Comme pour le Profiler, le visionneur ouvre une connexion dédié connexion pour cela, l'éditeur refuse toujours SUBSCRIBE, parce qu'une connexion abonnée ne peut plus exécuter de commandes ordinaires. Un abonnement n'a pas de limite de temps : Arrêter, changer d'onglet, fermer le moniteur (ancré ou détaché), déconnecter la connexion ou la supprimer ferme cette connexion immédiatement. Pour regarder un canal fragmenté, commencez son nom par #: #orders s'abonne avec SSUBSCRIBE, sur un serveur Redis 7 autonome directement et sur un cluster au maître qui possède le slot du canal. Dans un cluster, chaque ligne nomme également le nœud d'où elle provient.

Parce que le visualiseur contacte le serveur lui-même, il a besoin d'une connexion directe. Sur une connexion acheminée via un pont relais, l'onglet l'explique et S'abonner reste désactivé.

Événements de clés

Redis peut publier une notification chaque fois qu'une clé change - écriture, suppression, expiration, éviction, renommage, etc., sous forme de messages Pub/Sub ordinaires sur deux familles de canaux : __keyevent@<db>__:<event> porte la clé comme sa charge utile, et __keyspace@<db>__:<key> porte l'événement. Le Événements de clés bouton s'abonne à chaque événement de clé sur la base de données logique de la connexion (__keyevent@3__:* sur la base de données 3) et remplit la boîte de canal avec ce motif pour que vous puissiez voir et modifier l'abonnement en cours. Tapez d'abord un motif de clé - user:* - et le préréglage surveille également ces clés par nom (__keyspace@3__:user:*), c'est la façon de suivre une seule clé ou un seul préfixe au lieu de toute la base de données. Vous pouvez aussi saisir à la main l'une ou l'autre famille de canaux.

Quelle que soit la famille qui l'a délivré, une notification remplit les événement et clé colonnes - une entrée expirée pour user:42 s'affiche expired et user:42 - tandis que les messages ordinaires les laissent vides. Les colonnes canal, motif et charge utile restent telles quelles, donc un abonnement mixte se lit de la même manière qu'avant.

Les notifications sont désactivées sur un serveur Redis standard, donc l'onglet affiche notify-keyspace-events lorsqu'il s'ouvre et indique ce qu'il a trouvé. Quand le paramètre est vide ou qu'il lui manque la classe d'événements de touches dont dépend le préréglage, l'onglet propose Activer les événements de clés (KEA)…: il met en attente CONFIG SET notify-keyspace-events KEA dans la même bande de révision que le seuil du journal lent, vous voyez l'instruction exacte, puis appuyez sur Exécuter ou Annuler - et relit le paramètre ensuite. KEA active les deux familles de canaux pour chaque classe d'événement, ce qui coûte un peu de CPU sur un serveur occupé. Le changement s'applique uniquement au serveur en cours d'exécution ; Rendre persistant (CONFIG REWRITE)… dans l'onglet Expensive, l'écrit dans le fichier de configuration. Sur une connexion de production avec les écritures verrouillées, le bouton est désactivé et la bande indique pourquoi, et un utilisateur ACL a besoin de +config|get pour lire le paramètre et +config|set pour le modifier.

Lecture des messages

La liste des messages affiche les plus récents en premier. Pause arrête l'enregistrement sans supprimer l'abonnement (les messages continuent d'arriver et sont comptés), et Effacer vide la liste. La liste est limitée - 1 000 messages par défaut, ajustable jusqu'à 100 000 - et lorsqu'elle est pleine, les messages les plus anciens sont supprimés ; la ligne d'état indique combien. La table affiche au maximum les 2 000 derniers messages, et la ligne d'état le mentionne lorsque la liste contient plus de messages. La table conserve votre position pendant l'arrivée des messages : le message sélectionné reste sélectionné (jusqu'à ce qu'il soit supprimé de la liste), et si vous faites défiler les lignes, celles que vous lisez restent en place, vous permettant ainsi de sélectionner une ligne sur un canal actif et Aperçu de la charge utile ouvre ce message dans le visualiseur de valeurs, où le sélecteur de format peut l'afficher comme texte, JSON formaté, hexadécimal ou MessagePack décodé. Les charges utiles binaires sont conservées exactement octet par octet et affichées en hexadécimal plutôt que déformées en texte, et un nom de canal ou de motif qui n'est pas en UTF-8 valide affiche ses octets sous forme de \xHH échappements.

Un message peut atteindre jusqu'à 512 Mo, donc le visualiseur conserve au maximum les 64 premiers Kio de chaque charge utile (et le premier Kio d'un nom de canal ou de motif). Une charge utile tronquée le signale dans le tableau, comme … (truncated, N bytes) avec sa taille complète, et Aperçu de la charge utile ouvre la partie qui a été conservée avec un avis donnant les deux tailles. La liste entière est également limitée à 64 Mo : au-delà, les messages les plus anciens sont supprimés et comptabilisés de la même manière que lorsque le plafond de messages est atteint.

SQLly
Visualiseur Redis Pub/Sub : abonnements aux canaux et aux motifs, messages en direct du plus récent au plus ancien, et le plafond de messages dans la ligne d’état.Visualiseur Redis Pub/Sub : abonnements aux canaux et aux motifs, messages en direct du plus récent au plus ancien, et le plafond de messages dans la ligne d’état.
Visualiseur Redis Pub/Sub : abonnements aux canaux et aux motifs, messages en direct du plus récent au plus ancien, et le plafond de messages dans la ligne d’état.

Les messages Pub/Sub partent sans accusé de réception : la visionneuse ne voit que ce qui est publié pendant qu'elle est abonnée, et rien n'est rejoué. Un utilisateur ACL a besoin du +subscribe / +psubscribe permissions et accès aux canaux (&pattern).