Herramientas de Redis
Herramientas de Redis: vista de claves y streams, IntelliSense, Cluster y Sentinel, Profiler, Pub/Sub, análisis de memoria, acciones masivas, usuarios de ACL y formatos de valores.
Redis tiene su propio conjunto de herramientas además del explorador de claves. Dos vigilan el servidor en vivo mediante una conexión dedicada, y el resto responden a las preguntas de administración que más hacen los usuarios de Redis: a dónde fue a parar la memoria, cómo limpiar claves por miles, qué contiene realmente un valor binario y si el registro lento está capturando algo.
Funcionan en Redis y en los servidores que hablan su protocolo: Valkey, KeyDB, DragonflyDB, Amazon ElastiCache y Amazon MemoryDB, y en Redis Cluster (incluyendo el modo de clúster de ElastiCache y MemoryDB), donde los comandos se envían al nodo que posee la ranura de cada clave, véase Clúster de Redis.
Diagnóstico de conexión
Probar conexión en una conexión Redis recorre la conexión paso a paso y va escribiendo cada paso en el registro de diagnóstico a medida que lo completa, así que puedes ver exactamente hasta dónde llegó. Abre el registro con ⌘⇧L (Ctrl+Shift+L); establece Preferencias › Avanzado › Nivel de registro a Verbose para ver cada paso, un paso fallido también se registra solo en Errores. Cuando un paso falla, el error en el editor de conexiones empieza con ese paso - TLS falló: …, AUTH falló: … - en lugar de un genérico «no se pudo conectar».
| Paso | Lo que te dice |
|---|---|
| Base de datos | Nueva consulta, Filtrar claves…, Borrar filtro de claves, Escanear más; un Edición masiva submenú con Eliminar claves por patrón… y Establecer TTL por patrón…; Importar / Exportar con Importar archivo de comandos… y Exportar como archivo de comandos…; Herramientas con Analizador de memoria…, Topología de clúster… (en un clúster), Generador de perfiles…, Pub/Sub…, Panel del servidor, Monitor de actividad, Información de consultas, Uso de disco, Historial de consultas y Seguridad (la página de ACL); luego Copiar nombre, Cambiar nombre… y Mostrar solo bases de datos… para poner nombre y elegir las bases de datos que ves, y Actualizar. |
| Carpeta de claves | Copiar comando SCAN, Escanear más, Eliminar claves en carpeta…, Establecer TTL en carpeta…, Exportar carpeta como archivo de comando…. |
| Clave | Abrir valor (la vista de la clave), Abrir en pestaña de consulta; Cambiar nombre…, un Caducidad submenú con Establecer TTL… y Quitar expiración (PERSIST), y Copiar en con Copiar a Base de Datos… y Copiar a Conexión…; Copiar con Copiar nombre y Copiar comando; Eliminar clave…. |
| Índice de búsqueda | Abrir (FT.INFO), Consultar…, Explicar…, Perfil…, Eliminar índice…. |
| Nota de fila | Cargar más, Escanear más. |
Cómo se comportan las conexiones de SQLly
- RESP3 cuando el servidor lo tiene. SQLly pide el protocolo RESP3 y se queda en RESP2 en silencio si el servidor no lo ofrece. Los resultados se ven igual en ambos casos.
SQLLY.SERVERINFOinforma cuál usa la conexión. - Cada conexión tiene un nombre. Las pestañas de consulta, el Profiler y el visor Pub/Sub ponen nombre a sus conexiones
sqlly:<connection name>:<process id>, así queCLIENT LISTy la pestaña Sesiones del Monitor de actividad muestran cuáles son de SQLly - incluidas las del propio ProfilerMONITORconexión. Un servidor o ACL que rechazaCLIENT SETNAMEsimplemente los deja sin nombre. (En un servidor sin RESP3, no se puede poner nombre a la conexión del visor de Pub/Sub.) - Un tiempo de espera de comando. Un comando que no recibe respuesta dentro del Tiempo de espera de consulta - 30 segundos cuando está en blanco, sin límite cuando es 0 - falla con un mensaje que indica el comando y el límite. Los comandos bloqueantes reciben además la espera que hayas pedido, así que
BLPOP jobs 20nunca se corta. El comando aún puede terminar en el servidor, por lo que SQLly nunca lo ejecuta de nuevo por ti. El Profiler y el visor de Pub/Sub esperan sin límite. - Los túneles SSH permanecen activos. Un túnel envía un keepalive de SSH cada 30 segundos de silencio (ajusta Keepalive (segundos) en los ajustes del túnel; 0 lo desactiva), así los túneles inactivos sobreviven a los firewalls y a los tiempos de espera de NAT. Si aun así la sesión SSH se cae, la siguiente ejecución abre un túnel nuevo y en sus Mensajes se lee Túnel restablecido. No se vuelve a ejecutar nada en tu nombre; comprueba si el comando que iba corriendo cuando se cayó el túnel llegó a surtir efecto antes de repetirlo.
El explorador de claves
Redis no tiene un catálogo, por lo que su parte del explorador se construye a partir de las claves mismas. Expande un servidor Redis y obtienes sus bases de datos lógicas - db0,
db1, y así sucesivamente, cada una con un recuento de claves. Expande una base de datos y SQLly lista sus claves con un recorrido acotado SCAN (nunca KEYS *), organizándolas en carpetas según los delimitadores de claves de la conexión: user:42:profile cae en usuario › 42. El delimitador es : a menos que configures otros en el campo Delimitadores de clave del editor de conexión. Escribe varios caracteres para dividir por cada uno de ellos - :| pliega ambos user:42 y
cache|en|home - o separar con espacios los delimitadores más largos (:: |); un solo carácter, o uno repetido como ::, sigue significando exactamente eso. Cada clave muestra su tipo y, si tiene, su tiempo de vida.
Un listado puede acortarse de dos maneras, y una fila de nota abajo cubre ambas. Un recorrido se detiene en las 10.000 claves, y el árbol muestra las primeras 2.000 filas de lo escaneado. La nota indica qué parte de lo escaneado se muestra y si el escaneo en sí se detuvo, por ejemplo Mostrando 2.000 de 7.350 filas de 10.000 claves exploradas; el SCAN se detuvo ahí. Haz clic en la nota para cargar más filas (sin reescaneo, ya fueron recorridas), o elige Escanear más en la nota, la base de datos o una carpeta para continuar lo mismo SCAN desde donde se detuvo; las nuevas claves se unen a las filas ya mostradas y se actualizan los conteos de la carpeta. Usa
Filtrar claves… para restringir la lista a un patrón y
Quitar filtro de claves para regresar. El filtro se recuerda por base de datos en la conexión, por lo que volverá a estar activo la próxima vez que abras la aplicación, y el diálogo Filtrar claves… ofrece los últimos cinco patrones que escribiste en esa conexión en un
Recientes desplegable. Las carpetas vuelven a escanear su propio prefijo cuando se expanden, por lo que los árboles profundos se cargan un nivel a la vez.
Filtrar claves compara los Nombres con un patrón glob como user:*; nunca mira dentro de los valores. Si escribes algo que se lee como una consulta de valores - JSON como
{"name": "bob"} o una consulta de búsqueda como @name:bob - el diálogo lo dice en lugar de quedarse callado con una lista vacía, y ofrece Buscar valores con FT.SEARCH…. En un servidor con el módulo de búsqueda y un índice, eso abre una pestaña de consulta con un FT.SEARCH sobre el primer índice (los demás se mencionan en un comentario), convirtiendo campos JSON en @field:"value" Hashtags de clúster como {user1}:* son patrones normales y nunca activan la sugerencia.
Listados de claves en una pestaña de consulta
Cuando quieras ordenar o filtrar claves en lugar de explorarlas, ejecuta
SQLLY.KEYS <pattern> <limit> en una pestaña de consulta, por ejemplo
SQLLY.KEYS session:* 5000. Recorre el espacio de claves con el mismo límite
SCAN que el explorador y devuelve una cuadrícula normal con key,
type y ttl_seconds columnas, de manera que puedes hacer clic en el encabezado de
ttl_seconds para ordenar por tiempo de vida o usar Filtrar filas… para mantener, por ejemplo, claves sin caducidad o con menos de una hora restante.
Luego actúa sobre lo que encontraste: selecciona filas (o toda la key columna), haz clic derecho y abre Herramientas › Claves de Redis para Eliminar las claves seleccionadas…, Establecer TTL en las claves seleccionadas… o
Quitar la expiración de las claves seleccionadas…. El diálogo lista primero las claves seleccionadas, un borrado te pide teclear de nuevo cuántas claves hay, y no se escribe nada en una conexión de producción de solo lectura o bloqueada: las mismas barreras que las
acciones masivas. El mismo menú aparece en el informe de claves principales del Analizador de Memoria (SQLLY.TOPKEYS) y en
SQLLY.KEYINFO; resultados cuya key columna no es un nombre de clave, como INFO, nunca lo ofrecen. Las claves actúan sobre la conexión y la base de datos en que corre la pestaña.
Cada fila de la base de datos muestra su número de claves y, cuando alguna clave tiene caducidad, cuántas - 120 claves · caduca: 7 - directamente de las estadísticas del espacio de claves del servidor. Abrir una lista, un conjunto ordenado o un stream lee sus primeros 1.000 elementos, y la pestaña se llama así (orders — primeros 1.000) para que un valor largo nunca se confunda con todo el contenido.


Lo que ofrecen los menús de clic derecho
| En un… | Puedes |
|---|---|
| Base de datos | Nueva consulta, Filtrar claves…, Borrar filtro de claves, Escanear más; Edición masiva (Borrar claves por patrón…, Establecer TTL por patrón…); Importar / Exportar (Importar archivo de comandos…, Exportar como archivo de comandos…); y Herramientas con Analizador de memoria…, Generador de perfiles…, Pub/Sub…, Panel del servidor, Monitor de actividad, Información de consultas, Uso de disco e Historial de consultas. |
| Carpeta de claves | Copiar comando SCAN, Escanear más, Eliminar claves en carpeta…, Establecer TTL en carpeta…. |
| Clave | Abrir valor, Abrir en pestaña de consulta; Cambiar nombre…, Caducidad (Establecer TTL…, Quitar caducidad (PERSIST)), Copiar en; Copiar (Copiar nombre, Copiar comando); Borrar clave…. |
| Nota de fila | Cargar más, Escanear más. |
Las entradas de escritura - eliminaciones, cambios de TTL, cambios de nombre, copias e importaciones - se muestran deshabilitadas en una conexión configurada para Bloquear todo excepto SELECT, y una conexión de producción bloqueada te pide desbloquear primero las escrituras.
En una pestaña de consulta, una conexión Redis ejecuta un comando por línea. IntelliSense de comandos completa comandos, opciones, subcomandos y nombres de claves; la validación SQL y el formateador no se aplican.
Leer y cambiar claves
Abrir una clave en la vista de claves para hojear su valor y editarlo con el comando mostrado primero; una clave de flujo añade pestañas para sus grupos de consumidores y entradas pendientes. En una pestaña de consulta, IntelliSense de comandos completa comandos, opciones y nombres de claves, y las respuestas de Redis Stack regresan como tablas.
- Vista de clave
- Abrir una clave como vista: encabezado, valor paginado y ediciones por tipo que muestran el comando exacto antes de ejecutarlo.
- Streams y grupos de consumidores
- Navega por un stream, ve los grupos, consumidores, entradas pendientes y el lag, y ejecuta comandos de stream revisados desde la vista de la clave.
- IntelliSense de comandos
- Completa comandos, opciones, subcomandos y nombres de claves escaneadas, con insignias de sintaxis y seguridad al pasar el cursor.
- Módulos de Redis Stack
- JSON, Search, TimeSeries y los tipos probabilísticos como cuadrículas reales, además del navegador de índices de búsqueda en el explorador.
Conéctate a clústeres y Sentinel
Una conexión puede enrutar comandos a través de un Clúster de Redis, incluidos el modo clúster de ElastiCache y MemoryDB, o encontrar el maestro actual a través de Sentinel y seguir las conmutaciones por error.
- Clúster de Redis
- Redis Cluster, modo clúster de ElastiCache y MemoryDB: enrutamiento por ranuras, un mapa de nodos para direcciones inalcanzables, reenvíos SSH por nodo y topología.
- Sentinel
- Conéctate a través de Redis Sentinel por nombre del nodo principal, lee de las réplicas y sobrevive a las conmutaciones por error.
Obsérvalo en vivo
Recurre a estos cuando necesites ver el tráfico en tiempo real: el Profiler para averiguar qué cliente está sobrecargando una clave, el Visor de Pub/Sub para verificar que los mensajes se están publicando donde esperas. Ambos son pestañas en el Monitor de Actividad y solo se ejecutan en la aplicación de escritorio.
- Profiler
- Una captura MONITOR acotada y con límite de tiempo en su propia conexión, con pausa, filtros y una parada forzosa.
- Visor de Pub/Sub
- Suscríbete a canales, patrones, o a cada evento de clave en una base de datos y observa los mensajes llegar en vivo.
Cuídalo
Comienza con Herramientas › Uso de disco para la memoria por base de datos, luego el analizador de memoria para ver qué tipos y claves la provocan. Acciones masivas limpia lo que encuentres, formatos de valor decodifica lo que realmente contiene una clave, y el registro lento la página cubre el umbral que decide qué comandos se registran.
- Analizador de memoria
- Memoria por tipo de datos, las claves más grandes y un histograma TTL de una muestra limitada.
- Acciones masivas
- Eliminar o hacer caducar claves por patrón con un conteo de prueba previo, e importar archivos de comandos.
- Usuarios de ACL
- Ver cada usuario ACL y los accesos denegados recientes, y generar como script cambios revisados de ACL SETUSER / ACL DELUSER.
- Formatos de valor
- Ver un valor como UTF-8, JSON, hexadecimal, MessagePack, Base64, Protobuf, o descomprimido en gzip, zstd y LZ4; tu elección se recuerda para cada clave.
- Umbral del registro lento
- Ver el umbral de registro lento y cambiarlo a través de un CONFIG SET revisado.
Las herramientas en vivo abren su propia conexión y siempre tienen un tope y un botón de parar, así que dejar una abierta no llenará tu memoria ni acaparará la conexión que usan tus consultas. La muestra del analizador de memoria y el recuento de la ejecución de prueba de las acciones masivas tienen un Detener también: una muestra detenida mantiene los informes anteriores en pantalla, y un conteo detenido se etiqueta como parcial.