Redis ツール

Redis ツール: キービューとストリーム、IntelliSense、Cluster と Sentinel、プロファイラー、Pub/Sub、メモリ分析、一括アクション、ACL ユーザー、値の形式。

Redis には、キーブラウザーの横に独自のツール群が用意されました。2 つは専用の接続でサーバーをライブ監視し、残りは Redis ユーザーが最もよく尋ねる管理上の疑問に答えます。メモリの行き先、キーを何千単位でクリーンアップする方法、バイナリ値の実際の中身、スローログに何か記録されているかどうかです。

Redis と、そのプロトコルを話すサーバー (Valkey、KeyDB、DragonflyDB、Amazon ElastiCache、Amazon MemoryDB) で動作します。Redis Cluster (ElastiCache クラスターモードと MemoryDB を含む) でも同様に動作し、コマンドは各キーのスロットを所有するノードにルーティングされます。詳細は Redis Cluster.

接続の診断

接続テスト Redis 接続では、接続処理を 1 ステップずつ進め、各ステップが終わるたびに診断ログへ書き込むため、どこまで進んだかを正確に確認できます。ログは次で開きます ⌘⇧L (Ctrl+Shift+L)。次を設定します 環境設定 › 詳細設定 › ログレベル Verbose に設定するとすべてのステップが表示されます。失敗したステップは Errors のみでもログに記録されます。ステップが失敗した場合、接続エディターのエラーはそのステップ名で始まります - TLS に失敗しました: …, AUTH に失敗しました: … - 汎用の「接続できませんでした」ではなく。

ステップここから分かること
データベース新しいクエリ、キーをフィルター…、キーフィルターをクリア、さらにスキャン; 一括編集 「パターンでキーを削除…」と「パターンで TTL を設定…」のサブメニュー; インポート/エクスポート 「コマンドファイルをインポート…」と「コマンドファイルとしてエクスポート…」。 ツール 「メモリアナライザー…」「クラスタートポロジー…」(クラスター接続時)、「プロファイラー…」「Pub/Sub…」「サーバーダッシュボード」「アクティビティモニター」「クエリインサイト」「ディスク使用量」「クエリ履歴」、「セキュリティ」(ACL ページ)。続いて表示するデータベースに名前を付けたり選んだりする「名前をコピー」「名前を変更…」「データベースのみ表示…」、そして「更新」。
キーフォルダーSCAN コマンドをコピー、スキャンを続行、フォルダー内のキーを削除…、フォルダー内の TTL を設定…、フォルダーをコマンドファイルとしてエクスポート…。
キー値を開く(キービュー)、クエリタブで開く、名前を変更…、 有効期限 「TTL を設定…」と「有効期限を削除 (PERSIST)」のサブメニュー、および コピー先 「データベースへコピー…」と「接続へコピー…」。 コピー 「名前をコピー」「コマンドをコピー」、「キーを削除…」です。
検索インデックス開く(FT.INFO)、クエリ…、実行プラン…、プロファイル…、インデックスの削除…。
メモ行「さらに読み込む」と「さらにスキャン」。

SQLly の接続はどう動くか

  • サーバーが対応している場合は RESP3。 SQLly は RESP3 プロトコルを要求し、サーバーが対応していない場合は何も表示せずに RESP2 のままにします。どちらでも結果は同じように表示されます。 SQLLY.SERVERINFO 接続がどれを使っているかを報告します。
  • すべての接続には名前があります。 クエリタブ、Profiler、Pub/Sub ビューアーが接続に名前を付けるようになりました sqlly:<connection name>:<process id>、そのため CLIENT LIST やアクティビティモニターのセッションタブは、どれがSQLlyのものかを示します - Profiler自身のものも含めて MONITOR 接続。拒否するサーバーまたはACL CLIENT SETNAME 単に名前なしのままになります。(RESP3 に対応しないサーバーでは、Pub/Sub ビューアーの接続に名前を付けられません。)
  • コマンドタイムアウト。 応答が返ってこないコマンドは、接続の クエリタイムアウト - 空白の場合は 30 秒、0 の場合は無制限 - コマンド名と制限値を示すメッセージとともに失敗します。ブロッキングコマンドには、指定した待ち時間がさらに上乗せされるため、 BLPOP jobs 20 は途中で打ち切られることはありません。コマンドはサーバー上で完了する可能性があるため、SQLly が自動的に再実行することはありません。プロファイラーと Pub/Sub ビューアーは制限なしで待機します。
  • SSH トンネルは切れません。 トンネルは、30 秒間通信がないごとに SSH の keepalive を送信します(設定 キープアライブ (秒) トンネル設定で指定します。0 でオフ) ので、アイドル状態のトンネルもファイアウォールや NAT のタイムアウトを乗り切れます。それでも SSH セッションが切れた場合は、次回の実行で新しいトンネルが開かれ、その旨がメッセージに表示されます。 トンネルを再確立しました。何も自動で再実行されません。トンネルが切れたときに実行中だったコマンドが反映されたかどうかを、再実行する前に確認してください。

キーブラウザー

Redis にはカタログがないため、エクスプローラーの Redis 部分はキー自体から構築されます。Redis サーバーを展開すると、論理データベースが表示されます - db0, db1、などが、それぞれキー数とともに表示されます。データベースを展開すると、SQLly はそのキーを、上限付きの 1 回の SCAN 走査(決して KEYS *)、接続のキー区切り文字でフォルダーにまとめます: user:42:profile は次に入ります ユーザ › 42。区切り文字は : 接続エディターで別の値を設定しない限り キーの区切り文字 フィールド。複数の文字を入力すると、そのそれぞれで分割されます - :| 両方を折りたたみます user:42 そして cache|en|home - または、長い区切り文字はスペースで区切ります(:: |)、1 文字、または次のように繰り返したもの ::、まさにその意味のままです。各キーには、その型と、設定されている場合は有効期限(TTL)が表示されます。

一覧が途中で打ち切られる場合は 2 通りあり、末尾の 1 行のメモが両方を示します。走査は 10,000 キーで止まり、ツリーには走査した結果の先頭 2,000 行が表示されます。メモには、走査した件数のうち何件を表示しているか、走査自体が止まったかどうかが示されます。たとえば スキャンした 10,000 個のキーから得た 7,350 行のうち 2,000 行を表示しています。SCAN はそこで停止しました。注記をクリックして さらに読み込む 行(再スキャンなし、すでに走査済み)、または次を選択 さらにスキャン またはノート、データベース、フォルダーに対して選ぶと、同じ SCAN 停止した位置から続けます。新しいキーは既に表示されている行に追加され、フォルダー数も更新されます。 キーをフィルター… リストをパターンで絞り込み、 キーフィルターをクリア 戻ります。フィルターは接続上のデータベースごとに記憶されるため、次回アプリを開いたときにも有効なままで、「キーをフィルター…」ダイアログには、その接続で最後に入力した 5 つのパターンが次の 最近 ドロップダウン。フォルダーは展開するときに自身のプレフィックスを再スキャンするため、深いツリーでも1階層ずつ読み込まれます。

「キーをフィルター」で一致するのはキー 名前 次のような 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 ヘッダーをクリックすると有効期限順に並べ替えられます。または、 行をフィルター… たとえば、有効期限のないキー、または残り 1 時間未満のキーだけを残すには。

次に、見つけたものに手を加えます:行(または key 列)を右クリックし、次を開きます ツール › Redis キー 向け 選択したキーを削除…, 選択したキーに TTL を設定… または 選択したキーの有効期限を削除…。ダイアログでは選択したキーが先頭に表示され、削除ではキー数の再入力が求められ、読み取り専用の接続やロックされた本番接続には何も書き込みません。これは、次と同じゲートです 一括アクション。同じメニューは、メモリアナライザーの上位キーレポートの形式(SQLLY.TOPKEYS) および SQLLY.KEYINFO; 次のものを持つ結果 key 列がキー名でない場合、たとえば INFO、決して提示しません。キーは、そのタブが実行されている接続とデータベースに対して動作します。

各データベースの行にはキー数が表示され、有効期限つきのキーがあればその数も表示されます - 120 キー・有効期限: 7 - サーバーのキースペース統計から直接取得します。リスト、ソート済みセット、ストリームを開くと最初の 1,000 要素を読み込み、タブ名にもそれが反映されます(orders — 先頭 1,000)。そのため、長い値がすべてと取り違えられることはありません。

SQLly
Session Cache の Redis データベース 0~15 をキー数とともに一覧表示している SQLLY のキーブラウザーSession Cache の Redis データベース 0~15 をキー数とともに一覧表示している SQLLY のキーブラウザー
セッションキャッシュのキーブラウザー: 各 Redis データベースのキー数と有効期限の概要。

右クリックメニューで使える操作

…ではできること
データベース新しいクエリ、キーをフィルター…、キーフィルターをクリア、さらにスキャン; 一括編集 (パターンでキーを削除…、パターンで TTL を設定…); インポート/エクスポート (コマンドファイルのインポート…、コマンドファイルとしてエクスポート…)、および ツール 「メモリアナライザー…」「プロファイラー…」「Pub/Sub…」「サーバーダッシュボード」「アクティビティモニター」「クエリインサイト」「ディスク使用量」、「クエリ履歴」を備えます。
キーフォルダーSCAN コマンドをコピー、スキャンを続行、フォルダー内のキーを削除…、フォルダー内の TTL を設定…。
キー値を開く、クエリタブで開く、名前を変更…、 有効期限 (TTL を設定…、有効期限を削除 (PERSIST))、 コピー先; コピー (名前をコピー、コマンドをコピー)。「キーを削除…」。
メモ行「さらに読み込む」と「さらにスキャン」。

書き込み系の項目(削除、TTL の変更、名前の変更、コピー、インポート)は、次の設定になっている接続ではグレーアウトされます SELECT 以外をすべてブロックする、ロックされた本番接続では、先に書き込みのロックを解除するよう求められます。

クエリタブでは、Redis 接続は 1 行ごとに 1 コマンドを実行します。 コマンド 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 経由で接続し、レプリカから読み取り、フェイルオーバーにも耐えます。

ライブで見る

リアルタイムでトラフィックを確認したいときは、次のものを使います: プロファイラー どのクライアントがキーに激しくアクセスしているかを調べるには、 Pub/Sub ビューアー メッセージが期待どおりの場所に配信されているか確認できます。どちらもアクティビティモニターのタブで、デスクトップアプリでのみ動作します。

プロファイラー
独自の接続で行う、範囲と時間を区切った MONITOR キャプチャ。一時停止、フィルター、強制停止に対応。
Pub/Sub ビューアー
データベース上のチャンネル、パターン、またはすべてのキーイベントをサブスクライブして、メッセージがリアルタイムで届くのを確認できます。

面倒を見る

次で開始: ツール › ディスク使用量 データベースごとのメモリ用、次に メモリアナライザ どの型とキーがその原因かを確認できます。 一括操作 見つけたものをクリーンアップし、 値のフォーマット キーが実際に保持している内容をデコードし、 スローログ このページでは、どのコマンドを記録するかを決めるしきい値を扱います。

メモリアナライザー
データ型別のメモリ使用量、最大のキー、制限付きサンプルから算出した TTL ヒストグラム。
一括操作
ドライランの件数を確認してからパターンでキーを削除・有効期限設定でき、コマンドファイルをインポートできます。
ACL ユーザー
すべての ACL ユーザーと最近のアクセス拒否を確認し、確認済みの ACL SETUSER / ACL DELUSER の変更をスクリプト化できます。
値の書式
値を UTF-8、JSON、16 進数、MessagePack、Base64、Protobuf、または展開した gzip、zstd、LZ4 として表示でき、選択した形式はキーごとに記憶されます。
スローログのしきい値
スローログのしきい値を確認し、レビュー済みの CONFIG SET で変更できます。

ライブツールは独自の接続を開き、常に上限と停止手段があるため、開いたままにしても、メモリが埋まったり、クエリが使う接続を占有したりすることはありません。メモリアナライザーのサンプルと、一括操作のドライランの件数には 停止 も同様です。サンプルを停止しても前回のレポートは画面に残り、停止中のカウントには「部分的」というラベルが付きます。