Redis 도구
Redis 도구: 키 뷰와 스트림, IntelliSense, 클러스터와 센티넬, 프로파일러, Pub/Sub, 메모리 분석, 대량 작업, ACL 사용자, 값 형식.
Redis는 키 브라우저 옆에 자체 도구 세트를 갖추고 있습니다. 두 가지는 전용 연결에서 서버를 실시간으로 감시하고, 나머지는 Redis 사용자가 가장 많이 묻는 관리 질문에 답합니다: 메모리가 어디로 갔는지, 키를 수천 개 단위로 정리하는 방법, 바이너리 값이 실제로 무엇을 담고 있는지, 그리고 슬로우 로그가 어떤 항목을 포착하고 있는지 여부.
이 도구들은 Redis와 그 프로토콜을 말하는 서버(Valkey, KeyDB, DragonflyDB, Amazon ElastiCache, Amazon MemoryDB), 그리고 Redis 클러스터(ElastiCache 클러스터 모드와 MemoryDB 포함)에서 동작합니다. 클러스터에서는 명령이 각 키의 슬롯을 소유한 노드로 라우팅됩니다. 자세한 것은 Redis Cluster.
연결 진단
테스트 연결 Redis 연결에서는 연결 과정을 한 번에 한 단계씩 밟아 가며, 각 단계가 끝날 때마다 진단 로그에 기록하므로 어디까지 진행됐는지 정확히 알 수 있습니다. 로그를 열려면 ⌘⇧L (Ctrl+Shift+L); 설정하세요 환경 설정 › 고급 › 로그 레벨 Verbose로 설정하면 모든 단계를 볼 수 있고, 실패한 단계는 Errors 수준으로도 기록됩니다. 단계가 실패하면 연결 편집기의 오류 메시지가 그 단계로 시작합니다 - TLS 실패: …, AUTH 실패: … - “연결할 수 없습니다”라는 뭉뚱그린 메시지 대신.
| 단계 | 설명 |
|---|---|
| 데이터베이스 | 새 쿼리, 키 필터…, 키 필터 지우기, 계속 스캔; 일괄 편집 패턴별 키 삭제… 및 패턴별 TTL 설정…; 가져오기 / 내보내기 명령 파일 가져오기… 및 명령 파일로 내보내기…; 도구 메모리 분석기…, 클러스터 토폴로지…(클러스터인 경우), 프로파일러…, Pub/Sub…, 서버 대시보드, 활동 모니터, 쿼리 인사이트, 디스크 사용량, 쿼리 기록, 보안(ACL 페이지)이 있고, 이어서 이름 복사, 이름 바꾸기…, 데이터베이스만 표시…로 데이터베이스 이름을 정하고 골라 보며, 새로고침도 있습니다. |
| 키 폴더 | SCAN 명령 복사, 더 스캔, 폴더 내 키 삭제…, 폴더 TTL 설정…, 폴더를 명령 파일로 내보내기…. |
| 키 | 값 열기(키 뷰), 쿼리 탭에서 열기; 이름 바꾸기…, 그리고 만료 TTL 설정… 및 만료 제거(PERSIST)가 있는 하위 메뉴, 그리고 복사 대상 데이터베이스로 복사… 및 연결로 복사…가 있는 메뉴; 복사 이름 복사 및 명령 복사; 키 삭제…. |
| 검색 인덱스 | 열기(FT.INFO), 쿼리…, Explain…, Profile…, 인덱스 삭제…. |
| 메모 행 | 더 불러오기, 더 스캔하기. |
SQLly의 연결 동작 방식
- 서버가 RESP3를 지원할 때 RESP3. SQLly는 RESP3 프로토콜을 요청하며, 서버가 제공하지 않으면 조용히 RESP2를 유지합니다. 어느 쪽이든 결과는 동일하게 보입니다.
SQLLY.SERVERINFO연결이 어느 것을 쓰는지 알려 줍니다. - 모든 연결에는 이름이 있습니다. 쿼리 탭, 프로파일러, Pub/Sub 뷰어가 연결 이름을 표시합니다
sqlly:<connection name>:<process id>, 그래서CLIENT LIST그리고 활동 모니터의 세션 탭이 어느 세션이 SQLly 것인지 보여줍니다 - Profiler 자기 자신의 것까지 포함해MONITOR연결. 이를 거부하는 서버나 ACL은CLIENT SETNAME이름 없이 그냥 둡니다. (RESP3가 없는 서버에서는 Pub/Sub 뷰어의 연결에 이름을 붙일 수 없습니다.) - 명령 시간 초과. 응답이 없는 명령이며, 제한 시간은 연결의 쿼리 시간 초과 - 공백이면 30초, 0이면 무제한 - 명령 이름과 제한을 밝히는 메시지와 함께 실패합니다. 블로킹 명령은 요청한 대기 시간이 거기에 더해지므로
BLPOP jobs 20은(는) 도중에 끊기지 않습니다. 명령 자체는 서버에서 끝까지 실행될 수 있으므로, SQLly가 대신 다시 실행해 주는 일은 없습니다. Profiler와 Pub/Sub 뷰어는 시간 제한 없이 기다립니다. - SSH 터널은 계속 유지됩니다. 터널은 30초 동안 아무 활동이 없으면 SSH keepalive를 전송합니다(터널 설정에서 Keepalive (초) 터널 설정에서 지정합니다. 0이면 끕니다), 그래서 유휴 터널도 방화벽과 NAT 타임아웃을 견딥니다. 그래도 SSH 세션이 끊기면 다음 실행 때 새 터널을 열고 Messages에는 다음과 같이 표시됩니다 터널 재연결됨. 사용자를 대신해 다시 실행되는 것은 없으므로, 터널이 끊겼을 때 실행 중이던 명령이 적용되었는지 다시 실행하기 전에 확인하세요.
키 브라우저
Redis에는 카탈로그가 없으므로 탐색기의 해당 부분은 키 자체에서 구성됩니다. Redis 서버를 확장하면 논리적 데이터베이스가 표시됩니다 - db0,
db1, 등이고 각 항목마다 키 개수가 붙습니다. 데이터베이스를 펼치면 SQLly가 한도를 둔 다음을 한 번 실행해 키를 나열합니다 SCAN walk(결코 KEYS *), 연결의 키 구분자를 기준으로 폴더로 묶습니다: user:42:profile 다음에 자리를 잡습니다: user › 42. 구분자는 : 다르게 지정하지 않는 한 연결 편집기의 키 구분자 필드. 여러 글자를 입력하면 글자마다 구분됩니다 - :| 구분자라면 둘 다 user:42 그리고
cache|en|home - 또는 더 긴 구분 기호를 공백으로 구분 (:: |); 단일 문자이거나 다음처럼 반복된 것 ::, 정확히 그 의미 그대로입니다. 각 키는 자기 타입과, 있는 경우 time to live도 보여 줍니다.
목록은 두 가지 방식으로 잘릴 수 있고, 하단의 안내 행 하나가 둘 다를 설명합니다. 키 순회는 10,000개 키에서 멈추고, 트리는 스캔한 것 가운데 처음 2,000행을 보여 줍니다. 안내 행은 스캔분 중 무엇이 표시됐는지와 스캔 자체가 멈췄는지를 알려 줍니다. 예를 들어 스캔한 10,000개 키에서 나온 7,350행 중 2,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 설정… 또는
선택한 키에서 만료 제거…. 대화 상자에는 선택한 키가 먼저 나열되고, 삭제할 때는 키 개수를 다시 입력해야 하며, 읽기 전용이거나 쓰기가 잠긴 프로덕션 연결에서는 아무것도 쓰지 않습니다. 다음과 동일한 관문입니다
대량 작업. 저장된 파일에는 다음이 들어 있습니다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, 검색, 시계열 및 확률적 타입을 실제 그리드로 표시하며, 탐색기에서 검색 인덱스 브라우저도 제공합니다.
클러스터와 Sentinel에 연결
연결은 명령을 다음으로 라우팅할 수 있습니다 Redis Cluster, ElastiCache 클러스터 모드와 MemoryDB도 포함되며, 현재 마스터를 찾으려면 다음을 통해 Sentinel 그리고 장애 조치를 따라갑니다.
- Redis Cluster
- Redis 클러스터, ElastiCache 클러스터 모드, MemoryDB: 슬롯 라우팅, 접근할 수 없는 노드 주소용 노드 맵, 노드별 SSH 포워딩, 그리고 토폴로지.
- Sentinel
- 마스터 이름으로 Redis Sentinel에 연결하고, 복제본에서 읽으며, 장애 조치에서도 살아남으세요.
실시간으로 보기
트래픽이 실시간으로 어떻게 흐르는지 봐야 할 때는 다음을 쓰세요: 프로파일러 어떤 클라이언트가 키에 과도하게 접근하고 있는지 알아내기 위해, Pub/Sub 뷰어 메시지가 예상한 위치에 게시되고 있는지 확인하기 위해서입니다. 둘 다 Activity Monitor의 탭이며 데스크톱 앱에서만 실행됩니다.
- 프로파일러
- 자체 연결 위에서 시간을 정해 돌리는 MONITOR 캡처로, 일시정지와 필터, 하드 스톱이 있습니다.
- Pub/Sub 뷰어
- 채널, 패턴, 또는 데이터베이스의 모든 키 이벤트를 구독하고 메시지가 실시간으로 도착하는 모습을 지켜보세요.
관리하기
다음으로 시작합니다 도구 › 디스크 사용량 으로 시작해 데이터베이스별 메모리를 보고, 이어서 메모리 분석기 어떤 유형과 키가 메모리를 차지하는지 확인하세요. 일괄 작업 찾아낸 것을 정리하고, 값 형식 키가 실제로 무엇을 담고 있는지 디코딩하고, 슬로우 로그 페이지는 어떤 명령이 기록될지 결정하는 임계값을 다룹니다.
- 메모리 분석기
- 데이터 유형별 메모리, 가장 큰 키, 그리고 제한된 샘플에서의 TTL 히스토그램.
- 일괄 작업
- 드라이런 카운트를 먼저 거친 뒤 패턴으로 키를 삭제하거나 만료를 설정하고, 명령 파일을 가져옵니다.
- ACL 사용자
- 모든 ACL 사용자를 확인하고 최근 접근 거부 내역을 보며, 검토된 ACL SETUSER / ACL DELUSER 변경 사항을 스크립트화합니다.
- 값 형식
- 값을 UTF-8, JSON, 16진수, MessagePack, Base64, Protobuf 또는 압축 해제된 gzip, zstd, LZ4 형식으로 보고, 키별로 선택한 형식이 기억됩니다.
- 슬로우 로그 임계값
- 슬로우 로그 임계값을 확인하고 검토된 CONFIG SET을 통해 변경합니다.
실시간 도구는 자체 연결을 열며 항상 상한과 중단 장치가 있으므로, 열어 두어도 메모리를 채우거나 쿼리에 쓰이는 연결을 점유하지 않습니다. 메모리 분석기의 샘플과 대량 작업의 드라이런 개수에는 중지 또한: 중지된 샘플은 이전 보고서를 화면에 유지하며, 중지된 카운트에는 부분적이라고 표시됩니다.