すべてのプロダクト
Search
ドキュメントセンター

Tair (Redis® OSS-Compatible):Top キー統計

最終更新日:Nov 09, 2025

Tair または Redis インスタンスのメモリ使用量または CPU 使用率が高い場合、[Top キー統計] 機能を使用して、large キーとホットキーをすばやく見つけることができます。この機能は、インスタンス内の large キーとホットキーに関するリアルタイムおよび履歴情報を表示します。たとえば、多くの要素を持つキー、大量のメモリを使用するキー、頻繁にアクセスされるホットキーなどです。この情報は、インスタンスのパフォーマンス問題を解決するのに役立ちます。

large キーとホットキーの統計およびランキングメカニズム

追加のデータベースリソースの消費を避けるため、この機能はクライアントが読み取りまたは書き込み操作を通じてアクセスしたキーに関する統計のみを収集します。各キータイプの Top キーのみを保持および表示し、データベース内のすべてのキーをリアルタイムでスキャンしません。インスタンスが再起動されるか、高可用性 (HA) スイッチオーバーが発生すると、収集された Top キー情報はクリアされ、統計プロセスが再開されます。したがって、長期間アクセスされていないキーは統計に含まれない場合があります。データベース内のすべてのキーのメモリ使用量と分布に関する情報を取得するには、オフラインキー分析 機能を使用できます。

キータイプ

適用バージョン

統計メカニズム

表示説明

Large キー (要素数別)

  • Redis Community Edition 5.0 以降。

  • Tair (Enterprise Edition)

キーは、Hash のフィールド数や Set のメンバー数などの要素数がしきい値に達するか超えると、large キーとしてカウントされます。デフォルトのしきい値は 2000 です。設定することでbigkey-threshold パラメーターをカスタマイズできます。

説明

このパラメーターがパラメーター設定に表示されない場合は、マイナーバージョンアップデートを実行して再試行できます。

各データ型について、最大で上位 3 つの large キーが表示されます。キーの要素数が同じ場合、最初に書き込まれたキーが優先されます。

説明

インスタンスに合計 3 つの large キーしか表示されない場合は、マイナーバージョンを更新して再試行できます。

Large キー (メモリ使用量別)

マイナーバージョン 25.6.0.0 以降の Tair (Enterprise Edition) のクラウドネイティブメモリ最適化インスタンス。

  • キーは、その合計メモリ使用量がしきい値を超えると large キーとしてカウントされます。デフォルトのしきい値は 500 MB です。設定することでbigkey-mem-threshold パラメーターをカスタマイズできます。

  • また、単一の要素が 50 MB を超えるメモリを使用する場合も、そのキーは large キーとしてカウントされます。

最大で上位 3 つのキーが表示されます。キーのサイズが同じ場合、辞書式順序でソートされます。

ホットキー (QPS 別)

  • Redis Community Edition 5.0 以降。

  • Tair (Enterprise Edition)

キーは、そのクエリ/秒 (QPS) が 5000 を超えるとホットキーとして記録されます。設定することでhotkey-threshold パラメーターをカスタマイズできます。

いつでも、システムは最大で上位 50 個のホットキーを表示し、その正確なリアルタイム QPS を示します。

ホットキー統計は、以前のマイナーバージョンではサポートが制限されています。最新のマイナーバージョンにアップグレードできます。

これは、Redis Community Edition 7.0.18、6.0.2.9、5.5.2.9、またはメモリ最適化 Tair 5.0.50 および 25.2.0.0 より前のバージョンでは、ホットキーの QPS しきい値が 3000 に固定されており、調整できなかったためです。おおよその QPS 範囲しか表示できず、Redis Community Edition は 20 個のホットキーの統計しかサポートしていませんでした。

ホットキー (トラフィック別)

マイナーバージョン 25.2.0.0 以降の Tair (Enterprise Edition) のクラウドネイティブメモリ最適化インスタンス。

キーは、そのアクセス トラフィックが 1 MB/s を超えるとホットキーとして記録されます。

  • この機能はデフォルトで無効になっています。有効にするには、設定することで#no_loose_high-cost-key-enabled パラメーターを yes に設定します。

  • 設定することで#no_loose_high-cost-key-traffic-bytes-threshold パラメーターを使用して統計しきい値 (B/s) を調整できます。

  • #no_loose_high-cost-key-parse-hashtag および #no_loose_high-cost-key-parse-hashtag パラメーターを使用して、ハッシュタグとプレフィックスの統計を有効にできます。これにより、システムは個々のキーのトラフィックは低いが、同じハッシュタグまたはプレフィックスを持つキーの集計トラフィックがしきい値を超える状況を特定できます。この機能には、バージョン 25.9.1.0 以降へのアップグレードが必要です。

いつでも、システムは最大で上位 50 個のホットキーを表示し、その正確なインバウンドおよびアウトバウンドトラフィックとアクセス頻度を示します。

説明

存在しないキーについても統計を収集できます。データ型が not-exist-key と表示される場合、それはキーが存在しないが頻繁にアクセスされていることを意味します。

この機能は、次のデータ構造の統計をサポートしています:

  • ネイティブ Redis データ構造: String、List、Hash、Set、Zset、Stream

  • Tair 開発のデータ構造: TairString、TairHash、TairGIS、TairBloom、TairDoc、TairCpc、TairZset、TairRoaring、TairTS、TairSearch

    説明

    Tair (Enterprise Edition) の永続メモリインスタンスは、TairHash と TairString の統計のみをサポートします。

手順

  1. コンソールにログインし、[インスタンス] ページに移動します。上部のナビゲーションバーで、管理するインスタンスが存在するリージョンを選択します。次に、インスタンスを見つけてインスタンス ID をクリックします。

  2. 左側のナビゲーションウィンドウで、[CloudDBA] > [Top キー統計] をクリックします。

  3. リアルタイムデータまたは履歴データをクエリすることを選択します。

    図 1. キー分析image

    説明
    • インスタンスがクラスタアーキテクチャまたは読み書き分離アーキテクチャを使用している場合は、[現在のノード] ドロップダウンリストからノードを選択してそのデータを表示します。

    • 履歴データをクエリする場合、過去 4 日間の large キーとホットキーに関する情報をクエリできます。1 回のクエリの最大時間範囲は 3 時間を超えることはできません。

関連 API 操作

DAS API 操作

説明

DescribeHotBigKeys

メモリに現在あるホットキーと large キーに関するリアルタイム情報を取得します。

DescribeTopHotKeys

一定期間の上位 20 個のホットキーに関する情報を取得します。

DescribeTopBigKeys

一定期間の上位 20 個の large キーに関する情報を取得します。

DescribeHotKeys

Redis インスタンスのホットキーに関する情報を取得します。

よくある質問

  • Q: なぜ String 型のキーが Large キー (要素数別) の下に表示されるのですか?

    A: Redis Community Edition および Tair の一部の旧バージョンでは、String 型のキーは、その長さがしきい値を超えると表示されます。デフォルトのしきい値は 2000 です。