Pub/Sub-Viewer
funktionalAbonniere Kanäle, Muster oder jedes Schlüsselereignis einer Datenbank und sieh zu, wie Nachrichten live eintreffen.
Der Pub/Sub-Viewer abonniert Kanäle und Muster und zeigt jede Nachricht, sobald sie ankommt: eine Zeile pro Nachricht mit dem Zeitpunkt, an dem SQLly sie empfangen hat, dem Kanal, dem Muster, auf das sie passte (bei Muster-Abos), Ereignis und Schlüssel, wenn die Nachricht eine Keyspace-Benachrichtigung ist, und dem Payload. Er ist zu finden im Aktivitätsmonitor als der Pub/Sub Tab auf Redis- und Redis-kompatiblen Verbindungen (Valkey, KeyDB, Dragonfly, Amazon ElastiCache, Amazon MemoryDB). Die Redis Pub/Sub-Viewer… und Pub/Sub… im Rechtsklick-Menü einer Redis-Datenbank öffnen den Monitor direkt darauf.
Abonnieren
Gib einen oder mehrere Namen ein, durch Kommas getrennt, und drücke Abonnieren. Ein einfacher Name (orders) abonniert mit SUBSCRIBE; ein Name mit Glob-Zeichen (alerts.*, metrics.[ab], job?) abonniert mit PSUBSCRIBE. Um einen Kanal zu abonnieren, dessen Name selbst Glob-Zeichen enthält, starte ihn mit =: =orders[eu]
abonniert den Kanal buchstäblich mit dem Namen orders[eu] (schreibe
==x für einen Kanal namens =x). Namen dürfen keine Kommas enthalten, da das Komma sie trennt. Wie beim Profiler öffnet der Viewer eine
dedizierte Verbindung dafür, der Editor weigert sich jedoch immer noch
SUBSCRIBE, da eine abonnierte Verbindung keine gewöhnlichen Befehle mehr ausführen kann. Ein Abonnement hat kein Zeitlimit: Stoppen, der Tabwechsel, das Schließen des Monitors (angedockt oder gelöst), das Trennen der Verbindung oder das Löschen beendet diese Verbindung sofort. Um einen geshardeten Kanal zu beobachten, beginne seinen Namen mit
#: #orders abonniert mit SSUBSCRIBE, direkt auf einem eigenständigen Redis 7-Server und in einem Cluster beim Master, der den Slot des Kanals besitzt. In einem Cluster benennt jede Zeile auch den Knoten, von dem sie stammt.
Da der Viewer die Verbindung zum Server selbst aufbaut, benötigt er eine direkte Verbindung. Bei einer Verbindung, die über eine Relay-Bridge geleitet wird, erklärt der Tab das und Abonnieren bleibt deaktiviert.
Schlüsselereignisse
Redis kann eine Benachrichtigung veröffentlichen, jedes Mal wenn sich ein Schlüssel ändert – gesetzt, gelöscht, abgelaufen, verdrängt, umbenannt und so weiter, als normale Pub/Sub-Nachrichten auf zwei Kanalfamilien:
__keyevent@<db>__:<event> trägt den Schlüssel als seine Nutzlast und
__keyspace@<db>__:<key> trägt das Ereignis. Die Schlüsselereignisse
Schaltfläche abonniert jedes Tastenereignis auf der logischen Datenbank der Verbindung (__keyevent@3__:* auf Datenbank 3) und füllt das Kanalfeld mit diesem Muster, sodass du siehst und bearbeiten kannst, was abonniert wurde. Tippe zuerst ein Schlüsselmuster ein - user:* - und das Preset überwacht diese Schlüssel auch namentlich (__keyspace@3__:user:*), womit du einem einzelnen Schlüssel oder einem Präfix folgst statt der ganzen Datenbank. Beide Kanal-Familien kannst du auch von Hand eintippen.
Egal, welche Familie sie zugestellt hat, eine Benachrichtigung füllt die Ereignis und
Schlüssel Spalten - abgelaufen user:42 zeigt expired und
user:42 - während normale Nachrichten sie leer lassen. Die Spalten Kanal, Muster und Nutzlast bleiben, wie sie sind, sodass ein gemischtes Abonnement sich genauso liest wie vorher.
Benachrichtigungen sind auf einem Redis-Standardserver ausgeschaltet, daher steht im Tab
notify-keyspace-events wenn es sich öffnet und sagt, was es gefunden hat. Wenn die Einstellung leer ist oder die Tasten-Ereignisklasse fehlt, auf die die Voreinstellung angewiesen ist, zeigt der Tab
Key Events (KEA) aktivieren…: sie merkt vor
CONFIG SET notify-keyspace-events KEA im selben Überprüfungsstreifen wie der Slow-Log-Schwellenwert siehst du die genaue Anweisung, dann drückst du Ausführen oder
Abbrechen - und liest die Einstellung danach erneut ein. KEA schaltet beide Kanalfamilien für jede Ereignisklasse ein, was auf einem stark ausgelasteten Server etwas CPU kostet. Die Änderung gilt nur für den laufenden Server; Persistieren (CONFIG REWRITE)… Auf der Teuer-Registerkarte schreibt es in die Konfigurationsdatei. Bei einer Produktionsverbindung mit gesperrten Schreibvorgängen ist die Schaltfläche deaktiviert und die Leiste zeigt den Grund an, und ein ACL-Benutzer benötigt +config|get
um die Einstellung zu lesen und +config|set um sie zu ändern.
Nachrichten lesen
Die Nachrichtenliste zeigt die neuesten zuerst. Pause stoppt die Aufzeichnung, ohne das Abonnement zu löschen (Nachrichten kommen weiterhin an und werden gezählt), und Löschen
leert die Liste. Die Liste ist standardmäßig auf 1.000 Nachrichten begrenzt, auf bis zu 100.000 einstellbar - und ist sie voll, werden die ältesten Nachrichten verworfen; die Statuszeile zählt, wie viele. Die Tabelle zeigt höchstens die neuesten 2.000 davon, und die Statuszeile sagt Bescheid, wenn die Liste mehr enthält. Die Tabelle behält deine Position, während Nachrichten eintreffen: Die ausgewählte Nachricht bleibt ausgewählt (bis sie aus der Liste entfernt wird), und wenn du nach unten scrollst, bleiben die Zeilen, die du liest, an ihrem Platz, sodass du eine Zeile auf einem stark frequentierten Kanal auswählen und Vorschau Nutzlast öffnet diese Nachricht im Wert-Viewer, wo der Formatwähler sie als Text, hübsches JSON, Hex oder dekodiertes MessagePack anzeigen kann. Binäre Nutzdaten werden byte-genau beibehalten und als Hex dargestellt, anstatt als kaputter Text angezeigt zu werden, und ein Kanal- oder Mustername ohne gültiges UTF-8 zeigt seine Bytes als
\xHH Escape-Sequenzen.
Eine Nachricht kann bis zu 512 MB groß sein, daher behält der Viewer höchstens die ersten 64 KiB jeder Nutzlast (und die ersten 1 KiB eines Kanal- oder Musternamens). Eine abgeschnittene Nutzlast wird in der Tabelle so angezeigt, … (truncated, N bytes) mit ihrer vollen Größe, und Vorschau Nutzlast öffnet den Teil, der behalten wurde, mit einem Hinweis, der beide Größen angibt. Die gesamte Liste wird ebenfalls auf 64 MB begrenzt: Überschreitet sie dies, werden die ältesten Nachrichten gelöscht und gezählt, auf die gleiche Weise wie beim Erreichen des Nachrichtenlimits.


Pub/Sub-Nachrichten sind Fire-and-Forget: Der Viewer sieht nur, was veröffentlicht wird, solange er abonniert ist, und nichts wird wiedergegeben. Ein ACL-Benutzer benötigt die +subscribe / +psubscribe Berechtigungen und Zugriff auf die Kanäle (&pattern).