local-client-listによるクライアント情報の取得
ダウンロード
フォーカスモード
フォントサイズ
操作シナリオ
業務の停止、接続調査などのシナリオでは、
CLIENT LISTコマンドを使用してクライアント接続情報を確認し、残留接続がないことを確認できます。Distributed Cacheは、Proxyパラメータlocal-client-listを設定することで、ProxyノードでCLIENT LISTコマンドを実行した際に返されるクライアント情報の範囲を制御することをサポートしています。パラメータ値 | コマンド動作 | 適用シナリオ | デフォルト適用インスタンス |
true | 現在接続中のProxyノードのクライアントリストのみを返し、パフォーマンスオーバーヘッドが低くなります。 | 日常的なクライアント接続の確認 | Proxy v5.8.25バージョン以降の新規購入インスタンスのデフォルト設定 |
false | Redis Pubsubメカニズムを通じて、インスタンス配下の全Proxyノードのクライアントリストを集約して返します（全量情報）。 | 全インスタンスの残留接続を調査するなどのシーン | 既存インスタンス（v5.8.24以前）のデフォルト設定 |
注意事項
local-client-listをfalseに設定すると、CLIENT LISTコマンドはRedis Pubsubメカニズムを通じてインスタンス配下の全Proxyノードのクライアントリストを集約します。クライアント接続数が多いシナリオでは、この操作によりRedisのスロット0に対応するmasterノードの負荷が高くなり、トラフィック制限が発生しやすく、安定性にリスクがあります。業務の低ピーク時に慎重に使用し、確認完了後にパラメータをtrueに戻すことを推奨します。説明：
インスタンスの全接続およびコマンドアクセス記録を確認する必要がある場合は、Database Audit機能の使用を推奨します。Database Audit機能は、クライアントIP、ユーザーアカウント、実行コマンドなどの多次元で履歴操作ログを検索できます。
CLIENT LISTの全量集約を実行する必要がなく、インスタンスに追加の負荷をかけません。有効化方法については、Database Auditの有効化を参照してください。前提条件
Distributed Cacheインスタンスを作成しました。
インスタンスの接続アドレス、ポート、パスワードを取得済みであり（インスタンス詳細ページのネットワーク情報で確認できます）、かつクライアントとインスタンスのネットワークが相互接続されていること（同一VPC内に存在するか、または外部ネットワークアクセスが有効になっていること）。
操作手順
ステップ1：local-client-listパラメータの設定
1. Distributed Cacheコンソールにログインします。
2. 右側のインスタンスリストページの上部で、リージョンを選択します。
3. インスタンスリストで、対象インスタンスIDをクリックし、インスタンス詳細ページに移動します。
4. インスタンス詳細ページで、パラメータ設定タブを選択します。
5. 変更可能パラメータタブで、パラメータリストから
local-client-listパラメータ行を見つけ、現在の実行パラメータ値列で、パラメータ値にマウスを合わせ、trueまたはfalseに変更します。具体的な変更方法については、インスタンスパラメータの管理を参照してください。説明：
local-client-listパラメータは変更後、インスタンスを再起動することなく有効になります。
ステップ2：CLIENT LISTを実行してクライアント情報を取得する
1. クライアントを使用してインスタンスの Proxy ノードに接続します。例として
redis-cliを使用します：redis-cli -h <インスタンス接続アドレス> -p <ポート> -a <パスワード>
2.
client listコマンドを実行すると、LocalClientListの設定に従って、対応する範囲のクライアント接続情報が返されます：<インスタンス接続アドレス>:<ポート>> client listid=7 addr=10.0.0.12:52140 fd=8 name= age=132 idle=5 flags=N db=0 cmd=client|listid=9 addr=10.0.0.15:51022 fd=9 name= age=60 idle=0 flags=N db=0 cmd=get
パラメータ設定が
trueの場合：現在接続しているこのProxyノード上のクライアント接続のみが返されます。パラメータ設定が
falseの場合：インスタンス配下のすべてのProxyノードのクライアント接続が返され、通常、返される件数はより多くなります。CLIENT LISTの各行は1つのクライアント接続に対応し、local-client-listは返却範囲にのみ影響し、各フィールドの意味は変更しません。接続を調査する際によく使用されるフィールドは以下の通りです。フィールド | 説明 |
id | クライアント接続の一意なID |
addr | クライアントのIPアドレスとポートです。接続元の特定に使用されます。 |
fd | クライアントに対応するファイル記述子 |
name | クライアント名（ CLIENT SETNAMEで設定します。未設定の場合は空です） |
age | この接続が確立されてからの経過時間（単位：秒） |
idle | この接続のアイドル時間（単位：秒）です。長時間アイドル状態で無活動の接続の調査に使用できます。 |
cmd | この接続で最後に実行されたコマンド |
フィードバック