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

Tair (Redis® OSS-Compatible):リアルタイムログトレース

最終更新日:Mar 01, 2026

リアルタイムログトレースは、多次元フィルタリングと自動終了をサポートする軽量なリクエストトレース機能です。この機能を使用すると、異常なアクセス動作を迅速に特定できます。

機能概要

この機能はリアルタイム診断に使用できます。この機能を有効にすると、リクエストルールとフィルター条件を設定できます。システムは特定のリクエストを照合し、詳細なアクセスログを出力します。この機能には、次の特徴があります:

  • リアルタイム性:ログをリアルタイムで出力します。この機能は有効にすると即座に反映されます。

  • 多次元フィルタリングルール:コマンドタイプ、クライアント IP アドレス、リクエストデータサイズ、指定されたキーなど、条件の柔軟な組み合わせをサポートします。

  • ランタイム制御:秒単位の最大期間またはログエントリの最大数を設定して、タスクを自動的に停止できます。

  • 低パフォーマンスオーバーヘッド:ルールに一致するリクエストログのみを記録します。パフォーマンスオーバーヘッドは、監査ログよりも大幅に低くなります。

利用シーン

  • ホットキーと large キーのアクセスソースを特定し、キャッシュポリシーを最適化します。

  • 異常なコマンドをトレースして、悪意のあるスキャンやリソースの不正使用などの動作を迅速に特定します。

説明

この機能は、一時的なリアルタイム診断専用です。長期的な監査には、監査ログ機能をご利用ください。

バージョン制限

ご利用のインスタンスは、マイナーバージョン 25.10.1.0 以降を実行するメモリ最適化された Tair (Enterprise Edition) インスタンスである必要があります。

操作手順

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

  2. 左側のナビゲーションウィンドウで、CloudDBA > インスタンスセッション をクリックします。

  3. [インスタンストレース] タブをクリックし、[トレースルールの作成] をクリックします。

    説明

    同時に最大 5 つのトレースルールを作成できます。

  4. 表示されるパネルで、トレースルールとフィルタリングルールを設定します。

    この例では、どのクライアントが large キー「bighash」にアクセスするかを特定する方法を示します。次のパラメーターを設定し、その他はデフォルト設定のままにします。

    • [ルール名]:bighash Key。

    • [コマンド設定 - 入力]+@hash と入力します。

      説明

      ルールが具体的であるほど、パフォーマンスは向上します。たとえば、+hset+@hash よりもパフォーマンスが優れています。

    • [キー照合][キーパターン] を選択し、bighash と入力します。

    (任意) パラメーターの詳細を展開

    [ルール名] は唯一の必須パラメーターです。他のすべてのパラメーターは、論理 AND (&&) 演算子を使用して結合されます。これらはデフォルト設定のままにすることができます。

    カテゴリ

    設定項目

    説明

    名前

    ルール名 (必須)

    トレースルールの名前。

    一致条件

    コマンド設定 - 選択

    トレース対象のコマンドグループまたは特定のコマンドを追加または除外します。カスタムの組み合わせを作成できます。

    コマンド設定 - 入力

    このテキストボックスにトレースコマンドルールを入力することもできます。構文は Redis アクセス制御リスト (ACL) スタイルに似ています。たとえば、+@write +@hash +@string -hsetnx は、Hash と String の書き込みコマンドをトレースしますが、HSETNX コマンドは除外することを意味します。

    キー照合

    [すべてのキー] を選択するか、[キーパターン] を指定します。ワイルドカード文字がサポートされています。

    チャンネル照合

    Pub/Sub コマンドのチャンネルをトレースする場合にのみ使用します。[すべてのチャンネル] を選択するか、[チャンネルパターン] を指定します。ワイルドカード文字がサポートされています。

    クライアント IP 照合

    [すべての IP] を選択するか、[IP パターン] を指定します。[IP パターン] は CIDR 形式をサポートしています。たとえば、192.168.1.0/24 は、192.168.1.0 から 192.168.1.255 までの IP アドレス範囲を表します。

    応答サイズ制限

    単位:バイト。デフォルトは 0 で、制限がないことを意味します。

    リクエストサイズ制限

    単位:バイト。デフォルトは 0 で、制限がないことを意味します。

    終了条件

    ログ数による終了

    いずれかの条件が満たされると、トレースタスクは終了します。

    監視期間

  5. [作成して実行] をクリックします。

    トレースタスクが開始されます。

  6. [リアルタイムトレースログ] リストを更新します。リストには、次の図に示すように、ルールに一致するリクエストログが表示されます。image

    いずれかの終了条件が満たされると、トレースタスクは自動的に停止します。手動で停止する必要はありません。トレースルールは、変更、削除、または再実行できます。

    警告
    • トレースルールを再実行すると、元のログは上書きされます。元のログを保持するには、必ず先にエクスポートして保存してください。

    • ルールを削除すると、そのルールに関連付けられているログも削除されます。

トラブルシューティング

クライアントの IP アドレスとコマンドの動作を利用して、サービスロジックのトラブルシューティングやアクセス制御の設定を行うことができます。