Redis-Tools
Redis-Tools: Schlüsselansicht und Streams, IntelliSense, Cluster und Sentinel, Profiler, Pub/Sub, Speicheranalyse, Massenaktionen, ACL-Benutzer und Werteformate.
Redis erhält ein eigenes Set von Tools neben dem Schlüssel-Browser. Zwei beobachten den Server live über eine eigene Verbindung, und der Rest beantwortet die Verwaltungsfragen, die Redis-Benutzer am häufigsten stellen: wohin der Speicher gegangen ist, wie man Tausende von Schlüsseln bereinigt, was ein binärer Wert tatsächlich enthält und ob das Slow-Log etwas aufzeichnet.
Sie arbeiten mit Redis und den Servern, die sein Protokoll sprechen - Valkey, KeyDB, DragonflyDB, Amazon ElastiCache und Amazon MemoryDB - und mit Redis Cluster (einschließlich ElastiCache-Clustermodus und MemoryDB), bei dem Befehle an den Knoten geroutet werden, dem der Slot jedes Schlüssels gehört, siehe Redis-Cluster.
Verbindungsdiagnose
Verbindung testen auf einer Redis-Verbindung durchläuft die Verbindung Schritt für Schritt und schreibt jeden Schritt in das Diagnoselog, sobald er abgeschlossen ist, sodass du genau siehst, wie weit sie gekommen ist. Öffne das Log mit ⌘⇧L (Strg+Shift+L); setze Einstellungen › Erweitert › Protokollstufe auf Detailliert, um jeden Schritt zu sehen, ein fehlgeschlagener Schritt wird ebenfalls nur unter Fehlern protokolliert. Wenn ein Schritt fehlschlägt, beginnt der Fehler im Verbindungs-Editor mit diesem Schritt - TLS fehlgeschlagen: …, AUTH fehlgeschlagen: … - anstatt der allgemeinen Meldung „Verbindung konnte nicht hergestellt werden“.
| Schritt | Was es dir sagt |
|---|---|
| Datenbank | Neue Abfrage, Schlüssel filtern…, Schlüssel-Filter löschen, mehr scannen; ein Massenbearbeitung Untermenü mit Schlüssel nach Muster löschen… und TTL nach Muster festlegen…; Import / Export mit Befehlsdatei importieren… und Als Befehlsdatei exportieren…; Werkzeuge mit Speicheranalyzer…, Cluster-Topologie… (in einem Cluster), Profiler…, Pub/Sub…, Server-Dashboard, Aktivitätsmonitor, Query Insights, Datenträgernutzung, Abfrageverlauf und Sicherheit (die ACL-Seite); dann Namen kopieren, Umbenennen… und Nur Datenbanken anzeigen…, um zu benennen und auszuwählen, welche Datenbanken du siehst, und Aktualisieren. |
| Schlüsselordner | SCAN-Befehl kopieren, Mehr scannen, Schlüssel im Ordner löschen…, TTL im Ordner festlegen…, Ordner als Befehlsdatei exportieren…. |
| Schlüssel | Wert öffnen (die Schlüsselansicht), Im Abfrage-Tab öffnen; Umbenennen…, ein Ablauf Untermenü mit TTL setzen… und Ablauf entfernen (PERSIST), und Kopieren nach mit In Datenbank kopieren… und In Verbindung kopieren…; Kopieren mit Namen kopieren und Befehl kopieren; Schlüssel löschen…. |
| Suchindex | Öffnen (FT.INFO), Abfrage…, Erklären…, Profil…, Index löschen…. |
| Hinweiszeile | Mehr laden, mehr scannen. |
Wie sich SQLlys Verbindungen verhalten
- RESP3, wenn der Server es hat. SQLly fragt nach dem RESP3-Protokoll und bleibt stillschweigend bei RESP2, wenn der Server es nicht anbietet. Ergebnisse sehen in beiden Fällen gleich aus.
SQLLY.SERVERINFOzeigt an, welche die Verbindung verwendet. - Jede Verbindung hat einen Namen. Abfrage-Tabs, der Profiler und der Pub/Sub-Viewer benennen ihre Verbindungen
sqlly:<connection name>:<process id>, sodassCLIENT LISTund der Sitzungs-Tab des Aktivitätsmonitors zeigen, welche davon SQLlys sind – auch die eigenen des ProfilersMONITORVerbindung. Ein Server oder eine ACL, die das verweigert,CLIENT SETNAMElässt sie einfach unbenannt. (Auf einem Server ohne RESP3 kann die Verbindung des Pub/Sub-Viewers nicht benannt werden.) - Ein Befehls-Timeout. Ein Befehl, der innerhalb des Abfrage-Timeout - 30 Sekunden, wenn es leer ist, keine Begrenzung bei 0 - schlägt mit einer Meldung fehl, die Befehl und Begrenzung nennt. Blockierende Befehle bekommen obendrauf die Wartezeit, die du verlangt hast, also
BLPOP jobs 20nie vorzeitig abgebrochen wird. Der Befehl kann dennoch auf dem Server beendet werden, daher führt SQLly ihn nicht erneut für dich aus. Der Profiler und der Pub/Sub-Betrachter warten unbegrenzt. - SSH-Tunnel bleiben aktiv. Ein Tunnel sendet alle 30 Sekunden Inaktivität ein SSH-Keepalive (einstellbar unter Keepalive (Sekunden) in den Tunneling-Einstellungen; 0 schaltet es aus), sodass inaktive Tunnel Firewalls und NAT-Timeouts überstehen. Falls die SSH-Sitzung dennoch abbricht, öffnet der nächste Lauf einen neuen Tunnel und dessen Nachrichten zeigen Tunnel wiederhergestellt. Nichts wird in deinem Auftrag erneut ausgeführt, prüfe also, ob der Befehl, der lief, als der Tunnel abbrach, Wirkung gezeigt hat, bevor du ihn erneut ausführst.
Der Schlüssel-Browser
Redis hat keinen Katalog, daher baut sich sein Teil des Explorers aus den Schlüsseln selbst auf. Klappst du einen Redis-Server auf, siehst du seine logischen Datenbanken - db0,
db1, und so weiter, jeweils mit einer Schlüsselanzahl. Klapp eine Datenbank auf, und SQLly listet ihre Schlüssel mit einer begrenzten SCAN Durchlauf (niemals KEYS *), und fasst sie anhand der Schlüssel-Trennzeichen der Verbindung in Ordnern zusammen: user:42:profile landet in Benutzer › 42. Das Trennzeichen ist : , es sei denn, du setzt andere im Schlüsseltrennzeichen Feld. Mehrere Zeichen eingeben, um bei jedem von ihnen zu trennen - :| faltet beide user:42 und
cache|en|home - oder längere Trennzeichen mit Leerzeichen trennen (:: |); ein einzelnes Zeichen oder ein wiederholtes wie ::, bedeutet weiterhin genau das. Jeder Schlüssel zeigt seinen Typ und, wenn vorhanden, seine Lebensdauer.
Eine Auflistung kann auf zwei Arten verkürzt werden, und eine Notizzeile am Ende deckt beides ab. Ein Durchlauf stoppt bei 10.000 Schlüsseln, und der Baum zeigt die ersten 2.000 Zeilen dessen, was gescannt wurde. Die Notiz gibt an, was von dem, was gescannt wurde, angezeigt wird und ob der Scan selbst gestoppt wurde, zum Beispiel 2.000 von 7.350 Zeilen aus 10.000 gescannten Schlüsseln werden angezeigt; der SCAN hielt dort an. Klicke auf die Notiz, um Mehr laden Zeilen (kein erneutes Scannen, sie wurden bereits durchlaufen), oder wähle Mehr scannen auf der Notiz, der Datenbank oder einem Ordner, um an derselben Stelle SCAN dort weiter, wo es aufgehört hat; die neuen Schlüssel kommen zu den bereits angezeigten Zeilen dazu, und die Ordnerzahlen werden aktualisiert. Verwende
Schlüssel filtern… um die Liste auf ein Muster einzugrenzen und
Filter für Schlüssel löschen um zurückzugehen. Der Filter wird pro Datenbank auf der Verbindung gespeichert, sodass er beim nächsten Öffnen der App wieder aktiv ist, und der Dialog Filter Keys… bietet die letzten fünf von dir auf dieser Verbindung eingegebenen Muster in einem
Zuletzt Dropdown. Ordner scannen ihr eigenes Präfix neu, wenn du sie aufklappst, sodass tiefe Bäume Ebene für Ebene geladen werden.
Schlüssel filtern gleicht Schlüssel Namen mit einem Glob wie user:*; es sieht nie in die Werte hinein. Wenn du etwas eingibst, das wie eine Wertabfrage aussieht - JSON wie
{"name": "bob"} oder eine Suchabfrage wie @name:bob – sagt der Dialog dies anstatt stillschweigend nichts aufzulisten, und bietet Werte mit FT.SEARCH durchsuchen…. Auf einem Server mit dem Suchmodul und einem Index öffnet das einen Abfrage-Tab mit einer FT.SEARCH über dem ersten Index (die anderen sind in einem Kommentar benannt), wobei JSON-Felder in @field:"value" Klauseln für Sie zur Überprüfung und Ausführung verwandelt werden; ohne Index oder Modul erklärt der Dialog, was benötigt wird. Cluster-Hashtags wie {user1}:* sind gewöhnliche Muster und lösen niemals den Hinweis aus.
Schlüssellisten in einem Abfrage-Tab
Wenn du Schlüssel sortieren oder filtern willst, statt sie nur zu durchsuchen, führe
SQLLY.KEYS <pattern> <limit> in einem Abfrage-Tab aus, zum Beispiel
SQLLY.KEYS session:* 5000. Es durchläuft den Schlüsselbereich mit demselben begrenzten
SCAN wie der Explorer und gibt ein normales Raster mit key,
type und ttl_seconds Spalten zurück, sodass du auf die
ttl_seconds Überschrift klickst, um nach der Restlaufzeit zu sortieren, oder Zeilen filtern… verwenden, um zum Beispiel Schlüssel ohne Ablauf oder mit weniger als einer Stunde Restzeit zu behalten.
Dann arbeite mit dem Ergebnis weiter: markiere Zeilen (oder die ganze key Spalte) aus, klicke mit der rechten Maustaste und öffne Werkzeuge › Redis-Schlüssel für Ausgewählte Schlüssel löschen…, TTL auf ausgewählte Schlüssel setzen… oder
Ablaufdatum von ausgewählten Schlüsseln entfernen…. Der Dialog listet zuerst die ausgewählten Schlüssel auf, ein Löschen verlangt, dass du die Schlüsselanzahl noch einmal eintippst, und auf einer schreibgeschützten oder gesperrten Produktionsverbindung wird nichts geschrieben, dieselben Schranken wie beim
Massenaktionen. Dasselbe Menü erscheint beim Top-Keys-Bericht des Memory Analyzers (SQLLY.TOPKEYS) und auf
SQLLY.KEYINFO; Ergebnisse, deren key Spalte kein Schlüsselname ist, wie zum Beispiel INFO, bieten das nie an. Die Tastenkürzel wirken auf die Verbindung und die Datenbank, gegen die der Tab läuft.
Jede Datenbankzeile zeigt ihre Schlüsselanzahl und, wenn Schlüssel ablaufen, wie viele - 120 Schlüssel · läuft ab: 7 - direkt aus den Keyspace-Statistiken des Servers. Das Öffnen einer Liste, eines sortierten Sets oder Streams liest die ersten 1.000 Elemente, und der Tab wird entsprechend benannt (orders — erste 1.000), sodass ein langer Wert niemals mit dem Ganzen verwechselt wird.


Was die Kontextmenüs bieten
| Auf einem… | Du kannst |
|---|---|
| Datenbank | Neue Abfrage, Schlüssel filtern…, Schlüssel-Filter löschen, mehr scannen; Massenbearbeitung (Schlüssel nach Muster löschen…, TTL nach Muster setzen…); Import / Export (Befehlsdatei importieren…, Als Befehlsdatei exportieren…); und Werkzeuge mit Speicheranalyzer…, Profiler…, Pub/Sub…, Server-Dashboard, Aktivitätsmonitor, Query Insights, Datenträgernutzung und Abfrageverlauf. |
| Schlüsselordner | SCAN-Befehl kopieren, Mehr scannen, Schlüssel im Ordner löschen…, TTL im Ordner festlegen…. |
| Schlüssel | Wert öffnen, Im Abfrage-Tab öffnen; Umbenennen…, Ablauf (TTL setzen…, Ablauf entfernen (PERSIST)), Kopieren nach; Kopieren (Name kopieren, Befehl kopieren); Schlüssel löschen…. |
| Hinweiszeile | Mehr laden, mehr scannen. |
Die Schreib-Einträge - Löschen, TTL-Änderungen, Umbenennungen, Kopien und Importe - sind ausgegraut bei einer Verbindung, die auf Alles außer SELECT blockieren, und eine gesperrte Produktionsverbindung bittet dich, zuerst Schreibzugriffe zu entsperren.
In einem Abfrage-Tab führt eine Redis-Verbindung einen Befehl pro Zeile aus. Befehls-IntelliSense vervollständigt Befehle, Optionen, Unterbefehle und Schlüsselnamen; SQL-Validierung und der Formatierer gelten nicht.
Schlüssel lesen und ändern
Öffne einen Schlüssel in der Schlüsselansicht um durch seinen Wert zu blättern und ihn mit dem zuerst gezeigten Befehl zu bearbeiten; ein Stream-Schlüssel fügt Tabs für seine Consumer-Gruppen und ausstehende Einträge hinzu. In einem Abfrage-Tab Befehl-IntelliSense vervollständigt Befehle, Optionen und Schlüsselnamen, und Antworten von Redis Stack kommen als Tabellen zurück.
- Schlüsselansicht
- Schlüssel als Ansicht öffnen: Kopfleiste, seitenweiser Wert und typspezifische Bearbeitungen, die vor der Ausführung den genauen Befehl zeigen.
- Streams und Consumer Groups
- Seitenweise durch einen Stream blättern, Gruppen, Consumer, ausstehende Einträge und den Lag sehen und geprüfte Stream-Befehle aus der Key-Ansicht ausführen.
- Befehls-IntelliSense
- Vervollständigt Befehle, Optionen, Unterbefehle und gescannte Schlüsselnamen, mit Syntax- und Sicherheitskennzeichen beim Überfahren.
- Redis Stack-Module
- JSON, Search, TimeSeries und die probabilistischen Typen als echte Raster, plus den Suchindex-Browser im Explorer.
Mit Clustern und Sentinel verbinden
Eine Verbindung kann Befehle über ein Redis-Cluster, einschließlich ElastiCache Cluster-Modus und MemoryDB, weiterleiten oder den aktuellen Master finden durch Sentinel und Failovers folgen.
- Redis-Cluster
- Redis Cluster, ElastiCache-Cluster-Modus und MemoryDB: Slot-Routing, eine Knotenkarte für unerreichbare Knotenadressen, pro-Knoten-SSH-Weiterleitungen und Topologie.
- Sentinel
- Über Redis Sentinel mit dem Namen des Masters verbinden, von Replikaten lesen und Failover überstehen.
Live anschauen
Greife darauf zurück, wenn du den Datenverkehr live sehen willst: die Profiler herauszufinden, welcher Client ständig auf einen Schlüssel zugreift, der Pub/Sub-Viewer um zu prüfen, dass Nachrichten dort veröffentlicht werden, wo du sie erwartest. Beide sind Tabs im Aktivitätsmonitor und laufen nur in der Desktop-App.
- Profiler
- Eine abgegrenzte, zeitlich begrenzte MONITOR-Aufzeichnung auf einer eigenen Verbindung, mit Pause, Filtern und einem harten Stopp.
- Pub/Sub-Viewer
- Abonniere Kanäle, Muster oder jedes Schlüsselereignis einer Datenbank und sieh zu, wie Nachrichten live eintreffen.
Kümmere dich darum
Fang an mit Werkzeuge › Datenträgernutzung für Speicher pro Datenbank, dann den Speicheranalysator um zu sehen, welche Typen und Schlüssel ihn verursachen. Massenaktionen Räum auf, was du findest, Wertformate dekodieren, was ein Schlüssel tatsächlich enthält, und die Slow-Log Seite behandelt die Schwelle, die entscheidet, welche Befehle protokolliert werden.
- Speicheranalyse
- Speicher nach Datentyp, die größten Schlüssel und ein TTL-Histogramm aus einer begrenzten Stichprobe.
- Massenaktionen
- Schlüssel per Muster löschen oder ablaufen lassen, zuerst mit einer Probelauf-Zählung, sowie Befehlsdateien importieren.
- ACL-Benutzer
- Sieh dir alle ACL-Benutzer und die letzten Zugriffsverweigerungen an und erstelle geprüfte ACL SETUSER / ACL DELUSER Änderungen als Skript.
- Wertformate
- Sieh dir einen Wert als UTF-8, JSON, Hex, MessagePack, Base64, Protobuf oder dekomprimiertes gzip, zstd und LZ4 an, und deine Wahl wird pro Schlüssel gemerkt.
- Slow-Log-Schwellenwert
- Sieh dir den Slow-Log-Schwellenwert an und ändere ihn über ein geprüftes CONFIG SET.
Die Live-Tools öffnen ihre eigene Verbindung und haben immer ein Limit und einen Stopp, deshalb kann ein offenes Tool weder deinen Arbeitsspeicher füllen noch die Verbindung blockieren, die deine Abfragen nutzen. Die Stichprobe des Speicheranalysators und der Trockenlauf-Zähler der Massenaktionen haben einen Stoppen auch: eine gestoppte Probe behält die vorherigen Berichte auf dem Bildschirm, und ein gestoppter Zähler wird als unvollständig gekennzeichnet.