Инструменты Redis
Инструменты Redis: просмотр ключей и потоков, IntelliSense, Cluster и Sentinel, профайлер, Pub/Sub, анализ памяти, массовые действия, пользователи ACL и форматы значений.
Redis получает собственный набор инструментов рядом с браузером ключей. Два из них наблюдают за сервером в реальном времени через выделенное соединение, а остальные отвечают на административные вопросы, которые чаще всего задают пользователи Redis: куда ушла память, как почистить тысячи ключей, что на самом деле содержит бинарное значение и ловит ли медленный лог что-нибудь.
Они работают с Redis и серверами, поддерживающими его протокол, — Valkey, KeyDB, DragonflyDB, Amazon ElastiCache и Amazon MemoryDB, — а также с Redis Cluster (включая кластерный режим ElastiCache и MemoryDB), где команды направляются узлу, владеющему слотом ключа; см. Redis Cluster.
Диагностика подключения
Проверка подключения для Redis проходит соединение шаг за шагом и пишет каждый завершённый шаг в диагностический журнал, так что видно, докуда оно дошло. Откройте журнал с помощью ⌘⇧L (Ctrl+Shift+L); установите Настройки › Дополнительно › Уровень логирования на «Подробно», чтобы видеть каждый шаг — неудачный шаг и без того попадает в «Ошибки». Когда шаг не удаётся, ошибка в редакторе соединений начинается с этого шага - Сбой TLS: …, Ошибка AUTH: … - вместо обезличенного «не удалось подключиться».
| Шаг | Что это вам говорит |
|---|---|
| База данных | Новый запрос, Фильтр ключей…, Очистить фильтр ключей, Сканировать ещё; Массовое редактирование подменю с Удалить ключи по шаблону… и Установить TTL по шаблону…; Импорт / Экспорт с «Импорт файла команд…» и «Экспорт в файл команд…»; Инструменты с «Анализатор памяти…», «Топология кластера…» (на кластере), «Профайлер…», Pub/Sub…, «Панель мониторинга сервера», «Монитор активности», «Анализ запросов», «Использование диска», «История запросов» и «Безопасность» (страница ACL); затем «Копировать имя», «Переименовать…» и «Показать только базы данных…», чтобы задать, какие базы вы видите, и «Обновить». |
| Папка ключей | Копировать команду SCAN, Сканировать дальше, Удалить ключи в папке…, Задать TTL папке…, Экспортировать папку в файл команд…. |
| Ключ | Открыть значение (представление ключа), Открыть во вкладке запроса; Переименовать…, а Истечение срока подменю с Установить TTL… и Удалить срок действия (PERSIST), и Копировать в с «Копировать в базу данных…» и «Копировать в подключение…»; Копировать с «Копировать имя» и «Копировать команду»; «Удалить ключ…». |
| Поисковый индекс | Открыть (FT.INFO), Запрос…, Объяснить…, Профиль…, Удалить индекс…. |
| Строка заметки | Загружайте больше, сканируйте больше. |
Как ведут себя подключения SQLly
- RESP3, если сервер его поддерживает. SQLly запрашивает протокол RESP3 и спокойно остаётся на RESP2, когда сервер его не предлагает. Результаты выглядят одинаково в любом случае.
SQLLY.SERVERINFOсообщает, какое соединение используется. - У каждого подключения есть имя. Вкладки запросов, Профайлер и просмотрщик Pub/Sub называют свои подключения
sqlly:<connection name>:<process id>, так чтоCLIENT LISTи вкладка «Сеансы» в Мониторе активности показывает, какие из них принадлежат SQLly — включая собственного ПрофайлераMONITORсоединение. Сервер или ACL, который отказываетCLIENT SETNAMEпросто оставляет их без имени. (На сервере без RESP3 подключение просмотрщика Pub/Sub назвать нельзя.) - Тайм-аут команды. Команда, которая не получает ответа, когда истёк заданный для соединения Тайм-аут запроса - 30 секунд, когда значение пустое, и без ограничения, когда оно 0 - завершается ошибкой с указанием команды и лимита. Блокирующие команды дополнительно получают запрошенное время ожидания, поэтому
BLPOP jobs 20не обрывается на середине. Команда всё ещё может доработать на сервере, поэтому SQLly никогда не запускает её повторно за вас. Профайлер и просмотрщик Pub/Sub ждут без ограничения по времени. - SSH-туннели остаются активными. Туннель отправляет SSH keepalive каждые 30 секунд бездействия (установите Keepalive (в секундах) в настройках туннеля; 0 отключает её), поэтому простаивающие туннели переживают брандмауэры и тайм-ауты NAT. Если SSH-сеанс всё же рвётся, следующий запуск открывает новый туннель, и в его «Сообщениях» написано Туннель восстановлен. Ничего не выполняется за вас повторно: прежде чем запускать команду снова, проверьте, применилась ли та, что работала, когда туннель оборвался.
Обозреватель ключей
У Redis нет каталога, поэтому его часть обозревателя строится из самих ключей. Раскройте сервер Redis, и вы увидите его логические базы данных - db0,
db1, и так далее, каждая с количеством ключей. Раскройте базу данных, и SQLly перечисляет её ключи с одной ограниченной SCAN обходом (никогда KEYS *), сгруппировывая их в папки по разделителям ключей соединения: user:42:profile попадает в пользователь › 42. Разделитель — : если вы не установите другие в редакторе соединений Разделители ключей поле. Введите несколько символов, чтобы разделять по каждому из них - :| объединяет оба user:42 и
cache|en|home - или используйте более длинные разделители, разделяя их пробелами (:: |); один символ или повторяющийся символ, как ::, сохраняет точное значение. Каждый ключ показывает свой тип и, если он есть, время жизни.
Список может оборваться по двум причинам, и одна строка-заметка внизу покрывает обе. Обход останавливается на 10 000 ключах, а дерево показывает первые 2 000 строк из просканированного. В заметке сказано, какая часть просканированного показана и остановился ли сам обход, например Показано 2 000 из 7 350 строк из 10 000 просканированных ключей; SCAN остановился на этом. Нажмите на заметку, чтобы Загрузить ещё строки (не сканировать заново, они уже были пройдены), или выбрать Сканировать ещё на заметке, базе данных или папке, чтобы продолжить то же самое SCAN с того места, где оно остановилось; новые клавиши присоединяются к уже показанным строкам, а количество папок обновляется. Используйте
Фильтровать ключи… сузить список до шаблона и
Очистить фильтр ключей чтобы вернуться. Фильтр запоминается для каждой базы данных соединения, поэтому он снова вступает в силу при следующем открытии приложения, а диалоговое окно «Фильтр ключей…» предлагает последние пять введённых на этом соединении шаблонов в
Недавние выпадающий список. Папки повторно сканируют свой префикс при их раскрытии, поэтому глубокие деревья загружаются по одному уровню за раз.
Фильтр ключей сопоставляет ключ имена с glob-шаблоном вроде user:*; он никогда не заглядывает внутрь значений. Если вы введёте что-то, похожее на запрос значения, — например JSON вида
{"name": "bob"} или поисковый запрос, такой как @name:bob - диалог сообщит об этом вместо того, чтобы молча показать пустой список, и предложит Ищите значения с помощью FT.SEARCH…. На сервере с модулем поиска и индексом это открывает вкладку запроса с FT.SEARCH по первому индексу (остальные указаны в комментарии), превращая поля JSON в @field:"value" для просмотра и запуска; без индекса или модуля диалог объяснит, что нужно. Хэш-теги кластера вида {user1}:* — обычные шаблоны, и подсказка по ним никогда не срабатывает.
Список ключей на вкладке запроса
Когда вы хотите сортировать или фильтровать ключи, а не просматривать их, выполните
SQLLY.KEYS <pattern> <limit> во вкладке запроса, например
SQLLY.KEYS session:* 5000. Оно обходит пространство ключей с тем же ограничением
SCAN как и обозреватель, и возвращает обычную сетку с key,
type и ttl_seconds колонками, так что вы можете кликнуть по заголовку
ttl_seconds заголовок, чтобы отсортировать по времени жизни, или используйте Фильтровать строки… чтобы оставить, скажем, ключи без срока действия или с остатком меньше часа.
Затем работайте с найденным: выделите строки (или всю key столбец), нажмите правой кнопкой мыши и откройте Инструменты › Ключи Redis для Удалить выбранные ключи…, Установить TTL для выбранных ключей… или
Снять срок действия с выбранных ключей…. Сначала диалог перечисляет выбранные ключи, для удаления нужно ввести количество ключей обратно, а на подключениях только для чтения и заблокированных продакшен-подключениях ничего не записывается — те же проверки, что и у
массовые действия. То же меню появляется и у отчёта по топ-ключам в Memory Analyzer (SQLLY.TOPKEYS) и на
SQLLY.KEYINFO; результаты, у которых key столбец не является именем ключа, например INFO, никогда этого не предлагают. Клавиши действуют в рамках подключения и базы данных, с которыми работает вкладка.
Каждая строка базы данных показывает количество ключей, а если у ключей есть срок действия — сколько — 120 ключей · истекает: 7 - прямо из статистики ключевого пространства сервера. Открытие списка, отсортированного множества или потока считывает первые 1 000 элементов, и вкладка называется так (orders — первые 1 000), чтобы длинное значение никогда не приняли за всё целиком.


Что предлагают контекстные меню
| На… | Вы можете |
|---|---|
| База данных | Новый запрос, Фильтр ключей…, Очистить фильтр ключей, Сканировать ещё; Массовое редактирование (Удалить ключи по шаблону…, Установить TTL по шаблону…); Импорт / Экспорт (Импорт файла команд…, Экспорт как файл команд…); и Инструменты с «Анализатор памяти…», «Профайлер…», Pub/Sub…, «Панель мониторинга сервера», «Монитор активности», «Анализ запросов», «Использование диска» и «История запросов». |
| Папка ключей | Копировать команду SCAN, Сканировать дальше, Удалить ключи в папке…, Задать TTL папке…. |
| Ключ | Открыть значение, Открыть во вкладке запроса; Переименовать…, Истечение срока (Установить TTL…, Удалить срок действия (PERSIST)), Копировать в; Копировать (Копировать имя, Копировать команду); Удалить ключ…. |
| Строка заметки | Загружайте больше, сканируйте больше. |
Пункты, изменяющие данные, — удаление, изменение TTL, переименование, копирование и импорт — неактивны при подключении, настроенном на Блокировать все, кроме SELECT, а заблокированное производственное подключение попросит сначала разблокировать запись.
На вкладке запроса подключение Redis выполняет одну команду на строку. IntelliSense для команд автодополняет команды, параметры, подкоманды и имена ключей; проверка SQL и форматирование не применяются.
Чтение и изменение ключей
Откройте ключ в просмотр ключа чтобы пролистывать его значение и редактировать его с помощью команды, показанной первой; ключ потока добавляет вкладки для его группы потребителей и ожидающих записей. На вкладке запроса IntelliSense для команд автодополняет команды, параметры и имена ключей, а ответы Redis Stack возвращаются в виде таблиц.
- Просмотр ключа
- Откройте ключ как представление: заголовочная панель, постраничное значение и редактирование по типам, которые показывают точную команду перед её выполнением.
- Потоки и группы потребителей
- Просматривайте поток постранично, смотрите группы, потребителей, ожидающие записи и задержку, и выполняйте проверенные команды потока из просмотра ключа.
- IntelliSense для команд
- Автозаполнение команд, опций, подкоманд и имён ключей, найденных при сканировании, с подсказками по синтаксису и безопасности при наведении.
- Модули Redis Stack
- JSON, Search, TimeSeries и вероятностные типы как полноценные таблицы, плюс обозреватель поисковых индексов в проводнике.
Подключение к кластерам и Sentinel
Соединение может направлять команды через Redis Cluster, включая режим кластера ElastiCache и MemoryDB, или находить текущего мастера через Sentinel и отслеживает переключения при отказе.
- Redis Cluster
- Redis Cluster, режим кластера ElastiCache и MemoryDB: маршрутизация по слотам, карта узлов для адресов недоступных узлов, SSH-переадресация для каждого узла и топология.
- Sentinel
- Подключение через Redis Sentinel по имени мастера, чтение с реплик и корректная обработка failover.
Посмотрите вживую
Обращайтесь к этим инструментам, когда нужно видеть трафик в реальном времени: Профайлер чтобы выяснить, какой клиент нагружает ключ, Просмотрщик Pub/Sub чтобы проверить, публикуются ли сообщения там, где вы ожидаете. Оба являются вкладками в Activity Monitor и работают только в настольном приложении.
- Профайлер
- Ограниченный по объёму и времени захват MONITOR на отдельном соединении, с паузой, фильтрами и жёсткой остановкой.
- Просмотрщик Pub/Sub
- Подписывайтесь на каналы, шаблоны или события всех ключей в базе данных и наблюдайте за сообщениями в реальном времени.
Позаботьтесь об этом
Начать с Инструменты › Использование диска для памяти на базу данных, затем анализатор памяти чтобы увидеть, какие типы и ключи за это отвечают. Массовые действия уберите то, что найдёте, форматы значений расшифровать, что на самом деле хранит ключ, и журнал медленных запросов страница охватывает порог, который определяет, какие команды будут записываться в журнал.
- Анализатор памяти
- Память по типу данных, крупнейшие ключи и гистограмма TTL по ограниченной выборке.
- Массовые действия
- Удаляйте ключи или задавайте им срок действия по шаблону с предварительным пробным подсчётом (dry-run), а также импортируйте файлы команд.
- Пользователи ACL
- Просматривайте каждого пользователя ACL и недавние отказы в доступе, а также скриптируйте проверенные изменения ACL SETUSER / ACL DELUSER.
- Форматы значений
- Просматривайте значение в формате UTF-8, JSON, hex, MessagePack, Base64, Protobuf или распакованным gzip, zstd и LZ4, при этом ваш выбор сохраняется для каждого ключа.
- Порог журнала медленных запросов
- Просматривайте порог журнала медленных запросов и изменяйте его через проверенную команду CONFIG SET.
Инструменты реального времени открывают собственное подключение, и у них всегда есть лимит и кнопка остановки, поэтому оставленный открытым инструмент не забьёт память и не займёт подключение, на котором работают ваши запросы. У выборки анализатора памяти и пробного подсчёта массовых действий есть свой Стоп тоже: остановленная выборка сохраняет предыдущие отчёты на экране, а остановленный подсчёт помечается как частичный.