New Relic Infrastructure 用の Cassandra インテグレーション

New Relic Infrastructure の Cassandra インテグレーションは、Cassandra データベースから New Relic 製品にデータをレポートします。ここでは、Cassandra インテグレーションをインストールする方法、アクティブにする方法、取り込むことができるデータについて説明します。インテグレーションに関する共通情報については、インテグレーションの導入をご覧ください。

この機能を利用できるかは契約しているサブスクリプションレベルによります。

互換性と要件

要件:

インストール

インテグレーションのインストール手順は以下の通りです。

  1. Infrastructure インテグレーションパッケージを入手します。
  2. ターミナルウィンドウで、インテグレーションの設定フォルダに移動します。

    cd /etc/newrelic-infra/integrations.d
  3. 次のコマンドを実行して、サンプルの構成ファイルのコピーを作成します。

    sudo cp cassandra-config.yml.sample cassandra-config.yml
  4. 次のセクションで説明するように、設定ファイル cassandra-config.yml を編集します。
  5. Infrastructure エージェントを再起動します。

設定

インテグレーションでは以下の2つのコマンドを提供しています。

  • metrics [メトリクス]: 特定の Cassandra ノードのメトリクスを取得します。引数は次のとおりです。
    • hostname: Cassandra ノードのホスト名
    • port: Cassandra がリスニングし、JMX を介してメトリクスと変数を取得できるポート。
    • username: JMX 経由で Cassandra に接続するためのユーザ名。
    • password: JMX 経由で Cassandra に接続するためのパスワード。
  • inventory [インベントリ]: Cassandra の設定ファイルで設定された設定パラメータを取得します。引数は以下の通り。
    • config_path: Cassandra 設定ファイル。例: config_path: /etc/cassandra.yml。詳しくは、インベントリデータをご覧ください。

システムのメタデータ

インテグレーションは、Cassandra のインスタンスに関する以下のメタデータを収集します。この属性は、Insights のCassandraSample イベントと CassandraColumnFamilySample イベントの Cassandra
イベントタイプに関連付けられています。

名前 説明
software.version Cassandra のバージョン
cluster.name このCassandra ノードが属するクラスタ名。

Metrics: Cassandra ノード

Cassandra ノードのメトリック属性は、Insight の CassandraSample イベントタイプに関連付けられています。Cassandra カラムのファミリデータは、CassandraColumnFamilySample イベントタイプに関連付けられています。
インテグレーションのデータを検索して使用する方法については、インテグレーションデータの検索と使用をご覧ください。

以下は、Infrastructure Cassandra インテグレーションから受信できるノードのメトリクスです。

名前 単位 説明
db.allMemtablesOffHeapSizeBytes bytes off-heap に存在する memtables (2i および保留中のフラッシュ memtables を含む)に格納されているデータの総量。
db.allMemtablesOnHeapSizeBytes bytes on-heap に存在する memtables (2i および保留中のフラッシュ memtablesを含む)に格納されているデータの総量。
db.commitLogCompletedTasksPerSecond tasks / second 1秒あたりに書き込まれたコミットログのメッセージ数。
db.commitLogPendindTasks tasks 書き込まれたが、まだ fsync されていないコミットログのメッセージ数。
db.commitLogTotalSizeBytes bytes すべてのコミットログのセグメントが使用する現在のサイズ(バイト単位)。
db.droppedRequestTypeMessagesPerSecond messages / second このタイプのリクエストに対して、1秒あたりに落としたメッセージ数。RequestType には、BatchRemove、BatchStore、CounterMutation、Hint、Mutation、PagedRange、RangeSlice、Read、ReadRepair、RequestResponse、Trace のいずれかを指定できます。
db.keyCacheCapacityBytes bytes キーキャッシュ容量(バイト単位)。
db.keyCacheHitRate percent 1分のキーキャッシュヒット率。
db.keyCacheHitsPerSecond hits / second キーキャッシュヒットの数。
db.keyCacheRequestsPerSecond requests / second キーキャッシュへのリクエスト数。
db.keyCacheSizeBytes bytes 占有キャッシュのサイズ(バイト単位)。
db.liveSSTableCount tables このカラムファミリのディスク上の SSTables の数。
db.loadBytes bytes このノードが管理するディスク上のデータサイズ(バイト単位)。
db.rowCacheCapacityBytes bytes 行キャッシュ容量(バイト単位)。
db.rowCacheHitRate percent 1分の行キャッシュヒット率。
db.rowCacheHitsPerSecond hits / second 行キャッシュヒットの数。
db.rowCacheRequestsPerSecond requests / second 行キャッシュへのリクエスト数。
db.rowCacheSizeBytes bytes 占有された行キャッシュの合計サイズ(バイト単位)。
db.threadpoo.pool.ActiveTasks tasks このプールがアクティブに処理しているタスク数。pool は次のいずれかになります。

  • internalAntiEntropyStage
  • internalCacheCleanupExecutor
  • internalCompactionExecutor
  • internalGossipStage
  • internalHintsDispatcher
  • internalInternalResponseStage
  • internalMemtableFlushWriter
  • internalMemtablePostFlush
  • internalMemtableReclaimMemory
  • internalMigrationStage
  • internalMiscStage
  • internalPendingRangeCalculator
  • internalSampler
  • internalSecondaryIndexManagement
  • internalValidationExecutor
  • requestCounterMutationStage
  • requestMutationStage
  • requestReadRepairStage
  • requestReadStage
  • requestRequestResponse
  • requestViewMutationStage
db.threadpool.pool.PendingTasks tasks このプールがアクティブに処理しているタスク数。pool には、db.threadpool.poolActiveTasks の説明で提供されるリスト内の項目を指定できます。
db.totalHintsInProgress hints 現在送信しようとしているヒント数。
db.totalHintsPerSecond hints / second このノードに書き込まれた1秒当たりのヒント・メッセージ数。各ホストがヒントごとにヒントされるエントリが1つ含まれています
query.CASReadRequestsPerSecond requests / second トランザクション読み取り待ち時間。
query.CASWriteRequestsPerSecond requests / second トランザクション書込み待ち時間。
query.rangeSliceRequestsPerSecond requests / second 1秒あたりの範囲スライス要求の数。
query.rangeSliceTimeoutsPerSecond timeouts / second トークン範囲の読み取りリクエストを処理する際に発生したタイムアウト数。
query.rangeSliceUnavailablesPerSecond exceptions / second トークン範囲の読み取りリクエストを処理するときに使用できなかった例外数。
query.readLatency50thPercentileMilliseconds milliseconds (50パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readLatency75thPercentileMilliseconds milliseconds (75パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readLatency95thPercentileMilliseconds milliseconds (95パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readLatency98thPercentileMilliseconds milliseconds (98パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readLatency999thPercentileMilliseconds milliseconds (999パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readLatency99thPercentileMilliseconds milliseconds (99パーセンタイル)の読み取り待ち時間(ミリ秒単位)。
query.readRequestsPerSecond requests / second 1秒当たりの読み取りリクエスト数。
query.readTimeoutsPerSecond timeouts / second 標準の読み取りリクエストを処理する際に発生したタイムアウト数。
query.readUnavailablesPerSecond exceptions / second 標準の読み取りリクエストを処理するときに発生した、利用できない例外数。
query.viewWriteRequestsPerSecond requests / second 1秒あたりのビュー書き込みリクエスト数。
query.writeLatency50thPercentileMilliseconds milliseconds 書き込み待ち時間。50パーセンタイル
query.writeLatency75thPercentileMilliseconds milliseconds 書き込み待ち時間。75パーセンタイル
query.writeLatency95thPercentileMilliseconds milliseconds 書き込み待ち時間。95パーセンタイル
query.writeLatency98thPercentileMilliseconds milliseconds 書き込み待ち時間。98パーセンタイル
query.writeLatency999thPercentileMilliseconds milliseconds 書き込み待ち時間。999パーセンタイル
query.writeLatency99thPercentileMilliseconds milliseconds 書き込み待ち時間。99パーセンタイル
query.writeRequestsPerSecond requests / second 1秒当たりの書き込みリクエスト数。
query.writeTimeoutsPerSecond timeouts / second 通常の書き込みリクエストを処理するときに発生したタイムアウト数。
query.writeUnavailablesPerSecond exceptions / second 通常の書き込みリクエストを処理する際に発生した、利用できない例外数。

Cassandra カラムファミリーメトリクスとメタデータ

Cassandra インテグレーションはカラムファミリのメトリックを取得します。システムのキースペース(system, system_auth, system_distributed, system_schema, system_tracesOpsCenter)はスキップします。パフォーマンスへの影響を制限するため、インテグレーションでは最大20カラムのファミリのメトリックしか取得されません。

以下のメタデータは、サンプルメトリクスに関連付けられたキースペースおよびカラムファミリを示します。

名前 説明
db.columnFamily これらのメトリクスが参照する Cassandra カラムファミリ。
db.keyspace このカラムファミリを含む Cassandra キースペース。
db.keyspaceAndColumnFamily 単一のメタデータ属性のキースペースとカラムファミリ。フォーマットは、keyspace.columnFamily です。

以下のメトリクスのリストは、上記のメタデータで指定された特定のキースペースおよびカラムファミリを参照します。

名前 単位 説明
db.allMemtablesOffHeapSizeBytes bytes on-heap に存在する memtables (2i および保留中のフラッシュ memtables を含む)に格納されているデータの総量。
db.allMemtablesOnHeapSizeBytes bytes off-heap に存在する memtables (2i および保留中のフラッシュ memtables を含む)に格納されているデータの総量。
db.liveDiskSpaceUsedBytes bytes このカラムファミリに属する ​​SSTables が使用しているディスク領域(バイト単位)。
db.liveSSTableCount tables このカラムファミリのディスク上の SSTables の数。
db.pendingCompactions compactions このカラムファミリの保留中の圧縮の数の見積もり。
db.SSTablesPerRead50thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、50パーセンタイル。
db.SSTablesPerRead75thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、75パーセンタイル。
db.SSTablesPerRead95thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、95パーセンタイル。
db.SSTablesPerRead98thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、98パーセンタイル。
db.SSTablesPerRead999thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、999パーセンタイル。
db.SSTablesPerRead99thPercentileMilliseconds milliseconds 読み取りごとにアクセスされる sstable データファイルの数、99パーセンタイル。
query.readLatency50thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、50パーセンタイル。
query.readLatency75thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、75パーセンタイル。
query.readLatency95thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、95パーセンタイル。
query.readLatency98thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、98パーセンタイル。
query.readLatency999thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、999パーセンタイル。
query.readLatency99thPercentileMilliseconds milliseconds このカラムファミリのローカルの読取り待ち時間、99パーセンタイル。
query.readRequestsPerSecond requests / second このカラムファミリの1秒あたりの読み取りリクエスト数。
query.writeLatency50thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、50パーセンタイル。
query.writeLatency75thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、75パーセンタイル。
query.writeLatency95thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、95パーセンタイル。
query.writeLatency98thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、98パーセンタイル。
query.writeLatency999thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、999パーセンタイル。
query.writeLatency99thPercentileMilliseconds milliseconds このカラムファミリのローカル書込み待ち時間、99パーセンタイル。
query.writeRequestsPerSecond requests / second この列ファミリの1秒あたりの書き込みリクエスト数。

インベントリ

インテグレーションは、Cassandra の設定ファイルで定義された設定オプションを取得します。New Relic UI のどこでインベントリデータを見ることができるかは、インテグレーションデータの検索と利用をご覧ください。