当社のRedisインテグレーションは、ご利用の Redisサーバーから重要なパフォーマンスデータをNew Relic製品にレポートします。このメトリックデータとインベントリデータに関するプレビルドダッシュボードを閲覧し、アラートポリシーを作成して、カスタムクエリおよびチャートを作成することができます。また、ご利用のアプリケーションにとって重要なキーを指定して、その長さに関する詳細を入手することもできます。
インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。
互換性および要件
当社のインテグレーションは、Redisバージョン3.0以上と互換性があります。
インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。
New Relicアカウント。アカウントをお持ちでない場合無料サインアップクレジットカードは不要です。
RedisがKubernetesまたはAmazon ECSで実行されていない場合、Infrastructureエージェントが、Redisを実行しているLinux OSホストにインストールされている必要があります。その他の場合:
このインテグレーションは、Redisコマンドを実行することでデータを取得します。
INFO
コマンド:INFOコマンドによるデータが、メトリックデータと一部のインベントリデータを入力します。CONFIG GET
コマンド:大半のインベントリデータは、このコマンドによって取得できます。CONFIG
コマンドの実行許可を持たないマネージドRedisインストレーション(例:AWS ElastiCache)では、このコマンドの実行をconfig_inventory: false
設定オプションで無効にできます。
キーの長さの取得:キーの種類によっては、以下のコマンドを使用します
キーの長さに関するデータ収集において、エージェントは パイプライニングを使用してRedisのパフォーマンスへの影響を最小限に抑えます。ただし、多数のキーの長さを収集している場合は、Redisのパフォーマンスにも影響が出る場合があります。こうした理由から、エージェントにはデフォルトのキー制限が含まれています(ただし、この制限は上書き可能)。
重要
上記のRedisコマンド名を修正した場合、インテグレーションがRedisデータを回収できなくなります。
クイックスタート
Redisサーバーを迅速に計装し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールは、New Relic CLIおよびインフラストラクチャエージェントをダウンロードおよびインストールする環境用にカスタマイズされたCLIコマンドを作成します。
始める準備はできていますか?ボタンの1つをクリックし、試行してください。
インストールと有効化
Redisインテグレーションをインストールするには、お使いの環境の指示に従います:
追加の注:
- アドバンスト:インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。
- オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。
' '
このドキュメントはインストールで役立ちましたか。
お使いのRedisサーバーのNew Relicユーザーの作成
Redis 6+を使用しており、アクセスコントロールリスト(ACL)を使用してインスタンスへのアクセスを制御する場合は、インテグレーション用のnewrelic
ユーザーを作成することをお勧めします。このコマンドを使用して、必要な権限を作成してユーザーに付与します。
ACL SETUSER newrelic on >'YOUR_SELECTED_PASSWORD' ~* +INFO +CONFIG|GET +SELECT +TYPE +LLEN +SCARD +ZCOUNT +HLEN
インテグレーションの設定
インストールの方法により、インテグレーションの設定方法はいくつかあります。
- Kubernetesで有効化した場合:Kubernetes上で実行中のサービスの監視を参照してください。
- Amazon ECSで有効化した場合:ECS上で実行中のサービスの監視を参照してください。
- オンホストにインストールする場合:インテグレーションのYAML設定ファイル
redis-config.yml
で設定を編集します。
YAML設定を使用して、必要なログイン認証情報を配置し、セットアップと設定に応じてデータの収集方法を設定します。
設定ファイルには、interval
、timeout
、inventory_source
など、すべてのインテグレーションに適用される共通設定があります。これらの共通設定の詳細については、YAML設定形式を参照してください。
重要
レガシーの設定/定義ファイルを引き続き使用する場合は、旧バージョンの標準設定形式を使用してください。
設定ファイルのenv
セクションを使用して、Redisに関連する特定の設定を定義します。これらの設定は、Redisインスタンスへの接続、およびその他のセキュリティ設定と機能を制御します。
Redisインスタンス設定
Redisインテグレーションは、メトリクス(M)とインベントリ(I )の両方の情報を収集します。このテーブルでは、各収集に使用可能な設定にApplies To列を使用します。
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
設定 | 説明 | デフォルト | 適用先 |
---|---|---|---|
HOSTNAME | Redisサーバーのホスト名。 | localhost | M/I |
ポート | Redisサーバーがリッスンするポート。 | 6379 | M/I |
ユーザー名 | Redisサーバーに接続する際のユーザー名。ACLが有効な場合、Redis 6+でのみ使用します。 | 該当なし | M/I |
パスワード | Redisサーバーに接続する際のパスワード。 | 該当なし | M/I |
UNIX_SOCKET_PATH | RedisサーバーがリッスンしているUnixソケットファイルへのパス。ホスト名/ポートの代わりにこれを使用。 | 該当なし | M/I |
USE_UNIX_SOCKET |
| false | M/I |
USE_TLS | Redisサーバーとの通信時にTLSを使用します。 | false | M/I |
TLS_INSECURE_SKIP_VERIFY | TLS経由で接続する場合、サーバー名の検証を無効にします。 | false | M/I |
キー | 長さを読みだすキーの一覧。 | 該当なし | M |
KEYS_LIMIT | 長さを読みだすキーの最大数。 | 30 | M |
CONFIG_INVENTORY | Redis CONFIGコマンドが許可されていない環境では「false」に設定します(AWSやElastiCacheなど)。 | true | I |
RENAMED_COMMANDS | デフォルトのRedisコマンドを名前変更されたフォームにマッピングします。 | 該当なし | M/I |
マルチテナンシー監視を有効にします。 | true | M/I | |
メトリクス |
| false | |
インベントリ |
| false |
これらの設定値は、いくつかの方法で定義できます。
- 設定ファイルに直接値を追加します。これは最も一般的な方法です。
{{}}
表記を使用して、環境変数の値を置き換えます。これには、インフラストラクチャエージェント1.14.0以降が必要です。詳細については、インフラストラクチャエージェントのパススルー環境変数を参照してください。- 設定ファイルのプレーンテキストで公開されないように、シークレット管理を使用して、パスワードなどの賢明な情報を保護してください。詳細については、シークレット管理を参照してください。
ラベルとカスタム属性
また、メトリクスをラベルで装飾することもできます。ラベルを使用すると、キー/値のペア属性をメトリクスに追加して、メトリクスをクエリ、フィルター、グループ化できます。
デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、これらはオプションです。削除、変更、または新しいものを追加することができます。
labels: env: production role: load_balancer
設定の例
データの検索と使用
このサービスからのデータは、インテグレーションダッシュボードにレポートされます。
メトリクスが、RedisSample
およびRedisKeyspaceSample
イベントタイプに関連付けられます。トラブルシューティング目的で、またはカスタムのチャートとダッシュボードを作成するために、このデータのクエリを行えます。
データの検索・使用方法の詳細については、 インテグレーションデータを理解するを参照してください。
メトリックデータ
Redisインテグレーションは、以下のメトリックデータ属性を収集します。
Redisサンプルメトリックス
これらの属性は、RedisSample
イベントタイプに関連付けられます。
名前 | 説明 |
---|---|
| 接続したスレーブの数。 |
| 最後に行ったAOFの修正操作の時間(ミリ秒)。 |
| 最後に行ったAOFのバックグラウンド修正のステータスを示すブール表現。 |
| 最後に行ったAOF書込み操作のステータスを示すブール表現。 |
| 1秒あたりのmaxmemory制限によって却下されたキーの数。 |
| 1秒あたりのキーの無効化イベントの数。 |
| 1秒あたりにメインディクショナリでキー検索が成功した回数。 |
| 1秒あたりにメインディクショナリでキー検索が失敗した回数。 |
| 最後に行ったフォーク操作の時間(ミリ秒)。 |
| ブール値。RDBによる保存が進行中であることを示すフラグ。 |
| 最後のダンプが行われてからの変更数。 |
| 最後に行ったRDBの保存操作のステータスを示すブール表現。 |
| 最後に行ったRDBの保存操作の時間(ミリ秒)。 |
| 最後に成功したRDB保存のエポックに基づくタイムスタンプ(秒)。 |
| スレーブがこのマスターと完全に同期した回数。 |
| 部分同期の完了が失敗に終わった回数。 |
| 部分同期が完了した回数。 |
| ブロッキングコールで保留中のクライアントの数( |
| 現在のクライアント接続の中で最大の入力バッファ。 |
| 現在のクライアント接続の中で最大の出力リスト。 |
| 1秒あたりにサーバーが処理するコマンドの数。 |
| クライアント接続の数(スレーブ接続を除く)。 |
| 1秒あたりにサーバーによって受け入れられた接続の数。 |
| 1秒あたりの入力バイトの合計数。 |
| 1秒あたりの出力バイトの合計数。 |
| クライアントサブスクリプションを持つpub/subチャネルのグローバルな数。 |
| クライアントサブスクリプションを持つpub/subパターンのグローバルな数。 |
| maxclientsによる制限を理由に却下された1秒あたりの接続数。 |
| Redisサーバーを起動してから経過時間(ミリ秒)。 |
|
|
| Redisが稼働中のインスタンスで利用可能なメモリ量(バイト数)。 |
| Redisサーバーで使用されるシステムのCPU(ミリ秒)。 |
| バックグラウンド処理で使用されるシステムのCPU(ミリ秒)。 |
| Redisサーバーが使用するユーザーのCPU(ミリ秒)。 |
| バックグラウンド処理で使用されるユーザーのCPU(ミリ秒)。 |
| Redisがそのアロケーター(標準 |
| Luaエンジンが使用したバイト数。 |
| Redisによるピークメモリ使用量(バイト数)。 |
| オペレーティングシステムから分かる、Redisが割り当てたバイト数(別名RSS=resident set size)。これは、 |
キースペースのメトリックス
Redisインテグレーションは、以下のキースペースのメタデータおよびメトリクスを収集します。これらの属性は、RedisKeyspaceSample
イベントタイプに関連付けられます。
名前 | 説明 |
---|---|
| レポートされるデータベース内で有効期限を設定されたキーの平均有効期間(TTL)(ミリ秒)。 |
| レポートされるデータベース内のキーの数。 |
| Redisデータベースの整数のインデックスです(通常、 |
| レポートされるデータベース内の有効期間のあるキーの数。 |
インベントリデータ
インベントリデータには、Redisサーバーにパスワードを保管するrequirepass
を除いた、Redis CONFIG GET
コマンドによって報告されたデータのすべてが含まれます。インベントリデータの詳細に関しては、 インベントリデータを理解するを参照してください。
その他のシステムデータ
Redisインテグレーションは、Redisサービスに関する以下の追加 属性 を収集します。
名前 | 説明 |
---|---|
| Redisサーバーのバージョン。例: |
| 監視されているRedisノードのロールに応じて、 |
ソースコードのチェック
このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。