Redisモニターインテグレーション

当社のRedisインテグレーションは、ご利用の Redisサーバーから重要なパフォーマンスデータをNew Relic製品にレポートします。このメトリックデータとインベントリデータに関するプレビルドダッシュボードを閲覧し、アラートポリシーを作成して、カスタムクエリおよびチャートを作成することができます。また、ご利用のアプリケーションにとって重要なキーを指定して、その長さに関する詳細を入手することもできます。

統合をインストールし、収集するデータを確認するために読んでください。

互換性と要件

当社のインテグレーションは、Redisバージョン3.0から7.0まで互換性があります。

統合をインストールする前に、次の要件を満たしていることを確認してください。

NewRelicアカウント。持っていませんか？無料でお申し込み頂けます！クレジットカードは必要ありません。
RedisがKubernetesまたはAmazon ECSで実行されていない場合、Infrastructureエージェントが、Redisを実行しているLinux OSホストにインストールされている必要があります。その他の場合：
- Kubernetesで実行している場合は、これらの要件を参照してください。
- ECSで実行している場合は、これらの要件を参照してください。

このインテグレーションは、Redisコマンドを実行することでデータを取得します。

INFOコマンド：INFOコマンドによるデータが、メトリックデータと一部のインベントリデータを入力します。
CONFIG GETコマンド：大半のインベントリデータは、このコマンドによって取得できます。
- CONFIGコマンドの実行許可を持たないマネージドRedisインストレーション（例：AWS ElastiCache）では、このコマンドの実行をconfig_inventory: false設定オプションで無効にできます。
キーの長さの取得：キーの種類によっては、以下のコマンドを使用します
- にはLLEN list
- にはSCARD set
- にはZCOUNT zset
- hashタイプにはHLEN。

キーの長さに関するデータ収集において、エージェントはパイプライニングを使用してRedisのパフォーマンスへの影響を最小限に抑えます。ただし、多数のキーの長さを収集している場合は、Redisのパフォーマンスにも影響が出る場合があります。こうした理由から、エージェントにはデフォルトのキー制限が含まれています（ただし、この制限は上書き可能）。

重要

上記のRedisコマンド名を修正した場合、インテグレーションがRedisデータを回収できなくなります。

クイックスタート

Redisサーバーを迅速に計装し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールは、New Relic CLIおよびインフラストラクチャエージェントをダウンロードおよびインストールする環境用にカスタマイズされたCLIコマンドを作成します。

始める準備はできましたか？これらのボタンの1つをクリックして、試してみてください。

ガイド付きインストール

EUガイド付きインストール

インストールしてアクティブ化する

Redisインテグレーションをインストールするには、お使いの環境の指示に従います：

その他の注意事項：

Advanced:
インテグレーションは、パッケージマネージャ外でのインストレーションを可能にするために、 tarball 形式でも利用できます。
On-host integrations do not automatically update.
最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数をnri-redisに置き換えます。
ディレクトリを統合構成フォルダに変更します。
bash
```
$cd /etc/newrelic-infra/integrations.d
```
サンプル構成ファイルをコピーします。
bash
```
$sudo cp redis-config.yml.sample redis-config.yml
```
Redisサーバーの接続方法に基づいて、redis-config.yml設定ファイルを編集します。
Unixソケットを使って接続している場合は、設定ファイルでunix_socket_pathを指定します。Unixソケットを使用しているRedisインスタンスが複数ある場合、設定ファイルでuse_unix_socketをtrueに設定してください。
必ず、Redisインテグレーションを実行するユーザーが、そのUnix socketへの適切なアクセス権限を持っていることを確認してください。Unixソケットへのアクセス権限は、Redis設定（unixsocketpermの値）で設定されています。
必要に応じて、設定に書かれている通り、ご利用のRedisのセットアップに基づき、その他の設定ファイルを設定してください。
自動Redisエラーログ解析および転送を有効にするには、redis-log.yml.exampleファイルをredis-log.ymlにコピー（または名前変更）します。エージェントを再起動する必要はありません。
Example:
bash
```
$sudo cp /etc/newrelic-infra/logging.d/redis-log.yml.example /etc/newrelic-infra/logging.d/redis-log.yml
```

nri-redis .MSIインストーラーイメージを以下からダウンロードします。
https://download.newrelic.com/infrastructure_agent/windows/integrations/nri-redis/nri-redis-amd64.msi
Windowsコマンドプロンプトからインストールするには、次のコマンドを実行します。
bash
```
$msiexec.exe /qn /i PATH\TO\nri-redis-amd64.msi
```
またはエクスプローラーでファイルをダブルクリックします。
IntegrationsディレクトリC:\Program Files\New Relic\newrelic-infra\integrations.d\で、次のコマンドを実行してサンプル構成ファイルのコピーを作成します。
bash
```
$copy redis-win-config.yml.sample redis-win-config.yml
```
構成設定の説明に従って、 redis-win-config.ymlファイルを編集します。

このドキュメントはインストールの役に立ちましたか？

お使いのRedisサーバーのNew Relicユーザーの作成

Redis 6+を使用しており、アクセスコントロールリスト（ACL）を使用してインスタンスへのアクセスを制御する場合は、インテグレーション用のnewrelicユーザーを作成することをお勧めします。このコマンドを使用して、必要な権限を作成してユーザーに付与します。

bash

$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
`PORT`	Redisサーバーがリッスンするポート。	`6379`	M / I
`USERNAME`	Redisサーバーに接続する際のユーザー名。ACLが有効な場合、Redis 6+でのみ使用します。	該当なし	M / I
`PASSWORD`	Redisサーバーに接続する際のパスワード。`REQUIREPASS`またはACLが有効な場合、Redisサーバーでのみ使用します。	該当なし	M / I
`UNIX_SOCKET_PATH`	RedisサーバーがリッスンしているUnixソケットファイルへのパス。ホスト名/ポートの代わりにこれを使用。	該当なし	M / I
`USE_UNIX_SOCKET`	`true`に設定すると、Unixソケットを使用するときに監視されるエンティティが一意に識別されます。	`false`	M / I
`USE_TLS`	Redisサーバーとの通信時にTLSを使用します。	`false`	M / I
`TLS_INSECURE_SKIP_VERIFY`	TLS経由で接続する場合、サーバー名の検証を無効にします。	`false`	M / I
`KEYS`	長さを読みだすキーの一覧。	該当なし	M
`KEYS_LIMIT`	長さを読みだすキーの最大数。	`30`	M
`CONFIG_INVENTORY`	Redis CONFIGコマンドが許可されていない環境では「false」に設定します（AWSやElastiCacheなど）。	`true`	私
`RENAMED_COMMANDS`	デフォルトのRedisコマンドを名前変更されたフォームにマッピングします。	該当なし	M / I
`REMOTE_MONITORING`	マルチテナンシー監視を有効にします。	`true`	M / I
`METRICS`	メトリックのみの収集を有効にするには、 `true`に設定します。	`false`
`INVENTORY`	インベントリのみの収集を有効にするには、 `true`に設定します。	`false`

これらの設定の値は、いくつかの方法で定義できます。

値を構成ファイルに直接追加します。これが最も一般的な方法です。
{{}}表記を使用して、環境変数の値を置き換えます。これには、インフラストラクチャエージェント1.14.0以降が必要です。詳細については、インフラストラクチャエージェントのパススルー環境変数の詳細を参照してください。
シークレット管理を使用して、パスワードなどの機密情報を保護し、構成ファイルにプレーンテキストで公開されないようにします。詳細については、シークレット管理を参照してください。

ラベルとカスタム属性

メトリックをラベルで装飾することもできます。ラベルを使用すると、キーと値のペアの属性をメトリックに追加して、メトリックをクエリ、フィルタリング、またはグループ化できます。

デフォルトのサンプル構成ファイルにはラベルの例が含まれていますが、それらはオプションです。新しいものを削除、変更、または追加できます。

labels:
  env: production
  role: load_balancer

構成例

これは、ローカルホストからメトリックとインベントリを収集するために使用される基本構成です。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

この設定は、基本認証を使用してRedisに接続します。my_passwordをREQUIREPASSパスワードに置き換えます。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

Redis 6+では、アクセスコントロールリスト（ACL）でインスタンスを保護できます。ACLの場合、USERNAMEとPASSWORDの値を認証情報に置き換えます。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      USERNAME: my_user
      PASSWORD: "my_password"
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

これを使用して、TLSでRedisに接続します。TLS_INSECURE_SKIP_VERIFY : trueを追加すると、サーバー名の検証を無効にできます。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      USE_TLS: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

ソケットファイルを使用して、Redisに接続する場合に使用します。これは、TCPホスト名/ポート接続の代替手段です。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      UNIX_SOCKET_PATH: /var/run/redis/redis.sock
      USE_UNIX_SOCKET: true
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

rename-commandを使ってインスタンスを保護する場合、これを使用してメトリクス/インベントリを収集します。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52","LLEN":"c940fc2d15f59e41cb7be6c21"}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 6379
      RENAMED_COMMANDS: '{"CONFIG":"b840fc9f15f59e41cb7be6c52"}'
      REMOTE_MONITORING: true
    interval: 60s
    labels:
      environment: production
    inventory_source: config/redis

同じインテグレーションを使用して2つの異なるRedisサーバーからメトリクスを収集する必要がある場合に使用します。

最初のインスタンスの例は、Redisデータベース0からKEY_1とKEY_2のみを収集することです。2番目のインスタンスの例は、異なるデータベースから{"DB":"KEYS"}を使用して収集する方法を示しています。

integrations:
  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_1
      PORT: 6379
      KEYS: '["KEY_1","KEY_2"]'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

  - name: nri-redis
    env:
      METRICS: true
      HOSTNAME: redis_host_2
      PORT: 6379
      KEYS: '{"0":["KEY_1","KEY_2"],"1":["KEY_3"]}'
      REMOTE_MONITORING: true
    interval: 15s
    labels:
      environment: production

データを見つけて使用する

このサービスからのデータは、統合ダッシュボードに報告されます。

メトリクスが、RedisSampleおよびRedisKeyspaceSample イベントタイプに関連付けられます。トラブルシューティング目的で、またはカスタムのチャートとダッシュボードを作成するために、このデータのクエリを行えます。

データを検索して使用する方法の詳細については、統合データについてを参照してください。

メトリックデータ

Redisインテグレーションは、以下のメトリックデータ属性を収集します。

Redisサンプルメトリックス

これらの属性は、 RedisSampleイベントタイプに関連付けられています。

名前	説明
`cluster.connectedSlaves`	接続したスレーブの数。
`db.aofLastRewriteTimeInMilliseconds`	最後に行ったAOFの修正操作の時間（ミリ秒）。
`db.aofLastBgrewriteStatus`	最後に行ったAOFのバックグラウンド修正のステータスを示すブール表現。
`db.aofLastWriteStatus`	最後に行ったAOF書込み操作のステータスを示すブール表現。
`db.evictedKeysPerSecond`	1秒あたりのmaxmemory制限によって却下されたキーの数。
`db.expiredKeysPerSecond`	1秒あたりのキーの無効化イベントの数。
`db.keyspaceHitsPerSecond`	1秒あたりにメインディクショナリでキー検索が成功した回数。
`db.keyspaceMissesPerSecond`	1秒あたりにメインディクショナリでキー検索が失敗した回数。
`db.latestForkUsecMilliseconds`	最後に行ったフォーク操作の時間（ミリ秒）。
`db.rdbBgsaveInProgress`	ブール値。RDBによる保存が進行中であることを示すフラグ。
`db.rdbChangesSinceLastSave`	最後のダンプが行われてからの変更数。
`db.rdbLastBgsaveStatus`	最後に行ったRDBの保存操作のステータスを示すブール表現。
`db.rdbLastBgsaveTimeMilliseconds`	最後に行ったRDBの保存操作の時間（ミリ秒）。
`db.rdbLastSaveTime`	最後に成功したRDB保存のエポックに基づくタイムスタンプ（秒）。
`db.syncFull`	スレーブがこのマスターと完全に同期した回数。
`db.syncPartialErr`	部分同期の完了が失敗に終わった回数。
`db.syncPartialOk`	部分同期が完了した回数。
`net.blockedClients`	ブロッキングコールで保留中のクライアントの数（`BLPOP`、`BRPOP`、`BRPOPLPUSH`）。
`net.clientBiggestInputBufBytes`	現在のクライアント接続の中で最大の入力バッファ。
`net.clientLongestOutputList`	現在のクライアント接続の中で最大の出力リスト。
`net.commandsProcessedPerSecond`	1秒あたりにサーバーが処理するコマンドの数。
`net.connectedClients`	クライアント接続の数（スレーブ接続を除く）。
`net.connectionsReceivedPerSecond`	1秒あたりにサーバーによって受け入れられた接続の数。
`net.inputBytesPerSecond`	1秒あたりの入力バイトの合計数。
`net.outputBytesPerSecond`	1秒あたりの出力バイトの合計数。
`net.pubsubChannels`	クライアントサブスクリプションを持つpub/subチャネルのグローバルな数。
`net.pubsubPatterns`	クライアントサブスクリプションを持つpub/subパターンのグローバルな数。
`net.rejectedConnectionsPerSecond`	maxclientsによる制限を理由に却下された1秒あたりの接続数。
`software.uptimeMilliseconds`	Redisサーバーを起動してから経過時間（ミリ秒）。
`system.memFragmentationRatio`	`used_memory_rss`と`used_memory`との比率。
`system.totalSystemMemoryBytes`	Redisが稼働中のインスタンスで利用可能なメモリ量（バイト数）。
`system.usedCpuSysMilliseconds`	Redisサーバーで使用されるシステムのCPU（ミリ秒）。
`system.usedCpuSysChildrenMilliseconds`	バックグラウンド処理で使用されるシステムのCPU（ミリ秒）。
`system.usedCpuUserMilliseconds`	Redisサーバーが使用するユーザーのCPU（ミリ秒）。
`system.usedCpuUserChildrenMilliseconds`	バックグラウンド処理で使用されるユーザーのCPU（ミリ秒）。
`system.usedMemoryBytes`	Redisがそのアロケーター（標準`libc`、`jemalloc`、または`tcmalloc`などの代替アロケーター）を使用して割り当てた合計バイト数。
`system.usedMemoryLuaBytes`	Luaエンジンが使用したバイト数。
`system.usedMemoryPeakBytes`	Redisによるピークメモリ使用量（バイト数）。
`system.usedMemoryRssBytes`	オペレーティングシステムから分かる、Redisが割り当てたバイト数（別名RSS=resident set size）。これは、`top(1)`や`ps(1)`などのツールによってレポートされる数値です。

キースペースのメトリックス

Redisインテグレーションは、以下のキースペースのメタデータおよびメトリクスを収集します。これらの属性は、RedisKeyspaceSampleイベントタイプに関連付けられます。

名前	説明
`db.avgTtl`	レポートされるデータベース内で有効期限を設定されたキーの平均有効期間（TTL）（ミリ秒）。
`db.keys`	レポートされるデータベース内のキーの数。
`db.keyspace`	Redisデータベースの整数のインデックスです（通常、`0`と`15`の間の数値）。フォーマット：`db`の後にデータベースのインデックスが続きます。たとえば、`db0`、`db1`、`db2`など。
`db.expires`	レポートされるデータベース内の有効期間のあるキーの数。

在庫データ

インベントリデータには、Redisサーバーにパスワードを保管するrequirepassを除いた、Redis CONFIG GETコマンドによって報告されたデータのすべてが含まれます。インベントリデータの詳細に関しては、インベントリデータを理解するを参照してください。

その他のシステムデータ

Redisインテグレーションは、Redisサービスに関する以下の追加属性を収集します。

名前	説明
`software.version`	Redisサーバーのバージョン。例：`3.2.3`。
`cluster.role`	監視されているRedisノードのロールに応じて、`master`または`slave,`。

ソースコードを確認してください

このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。

この機械翻訳は、参考として提供されています。

Redisモニターインテグレーション

互換性と要件

重要

クイックスタート

インストールしてアクティブ化する

ECS

Kubernetes

Linux

Unix socketで接続する

TCPで接続する

ウィンドウズ

このドキュメントはインストールの役に立ちましたか？

お使いのRedisサーバーのNew Relicユーザーの作成

統合を構成する

重要

Redisインスタンス設定

ラベルとカスタム属性

構成例

基本構成

基本認証

REDIS 6+ ACL認証

TLS接続によるメトリクスのみ

ソケット上のメトリクスのみの接続

名前を変更したコマンドの使用

キーフィルタリングによるマルチインスタンス監視

データを見つけて使用する

メトリックデータ

Redisサンプルメトリックス

キースペースのメトリックス

在庫データ

その他のシステムデータ

ソースコードを確認してください

この機械翻訳は、参考として提供されています。

Redisモニターインテグレーション

互換性と要件 .css-21sua1{background:none;border:none;width:0;padding:0;}

重要

クイックスタート

インストールしてアクティブ化する

Kubernetes

Linux

ウィンドウズ

このドキュメントはインストールの役に立ちましたか？

お使いのRedisサーバーのNew Relicユーザーの作成

統合を構成する

重要

Redisインスタンス設定

ラベルとカスタム属性

構成例

基本構成

基本認証

REDIS 6+ ACL認証

TLS接続によるメトリクスのみ

ソケット上のメトリクスのみの接続

名前を変更したコマンドの使用

キーフィルタリングによるマルチインスタンス監視

データを見つけて使用する

メトリックデータ

Redisサンプルメトリックス

キースペースのメトリックス

在庫データ

その他のシステムデータ

ソースコードを確認してください

互換性と要件