Cassandraモニタリングの統合

当社のCassandra統合は、パフォーマンスメトリクスとインベントリデータをCassandraデータベースからNew Relicプラットフォームに送信します。Cassandraのメトリクスデータの構築済みダッシュボードを表示したり、アラートポリシーを作成したり、独自のカスタムクエリやチャートを作成することができます。

インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。

互換性および要件

当社のインテグレーションは、Apache Cassandraのバージョン3.x以上に対応しています。

インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。

Java Runtime Environment 7以上。
CassandraがKubernetesまたはAmazon ECS上で 実行されていない場合は、 Cassandraを実行しているLinuxホストにインフラストラクチャエージェントをインストールする必要があります。それ以外の場合は
- Kubernetesで実行されている場合は、これらの要件をご覧ください。
- ECSで実行されている場合は、これらの要件をご覧ください。

クイック・スタート：ガイド付きインストールを使用

ガイド付きインストールで、Cassandra データベースをすばやくインスツルメントし、テレメトリーデータを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。

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

ガイド付きインストール

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

ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してCassandraとの統合を設定します。それだけでなく、環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨してくれます。

ガイド付きインストールは、ほとんどのセットアップで動作します。しかし、ニーズに合わない場合は、以下の他の方法でCassandraデータベースのモニタリングを始めることができます。

インストールと有効化

Cassandraインテグレーションをインストールするには、お使いの環境の指示に従ってください。

追加の注：

アドバンスト：インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。
オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

' '

LinuxにCassandraインテグレーションをインストールするには

インテグレーションのインストール、ファイル名 nri-cassandra の指示に従ってください。
ディレクトリを integration フォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```
サンプルの設定ファイルのコピー：
```
sudo cp cassandra-config.yml.sample cassandra-config.yml
```
cassandra-config.yml ファイルを構成設定で説明されているように編集します。
Infrastructureエージェントを再起動します。

設定

インテグレーションの設定

インストールの方法により、インテグレーションの設定方法はいくつかあります。

Kubernetesで有効化した場合：Kubernetes上で実行中のサービスの監視を参照してください。
Amazon ECSで有効化した場合：ECS上で実行中のサービスの監視を参照してください。
オンホストでインストールされている場合：インテグレーションのYAML設定ファイルのコンフィグを編集します。 cassandra-config.yml.

インテグレーションのYAML形式設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。

設定ファイルには、 interval 、 timeout 、 inventory_source など、すべての統合に適用される共通の設定があります。これらの共通設定については、 Configuration Format のドキュメントを参照してください。

重要

従来の設定/定義ファイルをまだお使いの場合は、こちらのドキュメントを参考にしてください。

Cassandraに関連する特定の設定は、構成ファイルの env セクションを使用して定義されます。これらの設定は、Cassandraインスタンスへの接続のほか、その他のセキュリティ設定や機能を制御します。有効な設定のリストは、このドキュメントの次のセクションで説明します。

カサンドラ・インスタンスの設定

Cassandraの統合では、メトリクス(M)とインベントリ(I)の両方の情報を収集します。表の中で、 Applies To 列を使用して、各コレクションで利用可能な設定を確認します。

' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '

設定	説明	デフォルト	適用対象
HOSTNAME	Cassandraが稼働しているホスト名またはIP。	localhost	M/I
ポート	Cassandraがリッスンしているポート。	7199	M
ユーザー名	JMXにアクセスするためのユーザー名です。	該当なし	M
パスワード	指定ユーザーのパスワード。	該当なし	M
CONFIG_PATH	Cassandra構成ファイルへのパス。	/etc/cassandra/ cassandra.yaml	I
コラム_ファミリア_リミット	Cassandraカラム・ファミリーの数の制限。	20	M
タイムアウト	リクエストのタイムアウト（単位：ミリ秒）。	2000	M
KEY_STORE	JMXクライアントのSSL証明書を含むキーストアのファイルパスです。	該当なし	M
キー・ストア・パスワード	JMXのSSLキーストアのパスワードです。	該当なし	M
TRUST_STORE	JMXクライアントのSSL証明書を含むトラストストアのファイルパスです。	該当なし	M
trust_store_password	JMX SSLトラストストアのパスワードです。	該当なし	M
REMOTE_MONITORING	マルチテナンシー監視を有効にします。	false	M/I
メトリクス	`true`に設定すると、メトリクスのみの収集が有効になります。	false
インベントリ	`true`に設定すると、インベントリのみの収集が有効になります。	false

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

コンフィグファイルに直接値を追加する。これが最も一般的な方法です。
{{}} 表記を使用して環境変数から値を置き換えます。これには、インフラストラクチャ・エージェント v1.14.0+が必要です。詳しくはこちらまたは、以下の例をご覧ください .
シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。

ラベル/カスタム属性

メトリクスは、ラベルを使ってさらに装飾することができます。
デフォルトのサンプル・コンフィグ・ファイルにはラベルの例が含まれていますが、これらは必須ではありませんので、お好きなものを削除、変更、または新たに追加することができます。

labels:
   env: production
   role: load_balancer

設定の例

これは、ローカルホストからメトリクスとインベントリの収集に使用する基本設定です。

integrations:
  - name: nri-cassandra
    env:
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 30s
    labels:
      environment: production
    inventory_source: config/cassandra

この設定では、30秒ごとにメトリクスを収集し、60秒ごとにインベントリを作成します。

integrations:
  - name: nri-cassandra
    env:
      METRICS: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      REMOTE_MONITORING: true
    interval: 30s
    labels:
      environment: production

  - name: nri-cassandra
    env:
      INVENTORY: true
      HOSTNAME: localhost
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
      CONFIG_PATH: /etc/cassandra/cassandra.yml
    interval: 60s
    labels:
      environment: production
    inventory_source: config/cassandra

この設定では、環境変数 CASSANDRA_HOST を使用して、統合の HOSTNAME 設定を入力しています。

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: {{CASSANDRA_HOST}}
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 15s
    labels:
      env: production
      role: load_balancer

この構成では、同じ統合から複数のCassandraサーバーを監視しています。最初のインスタンス（HOSTNAME:1st_cassandra_host ）ではメトリクスとインベントリを収集していますが、2つ目のインスタンス（HOSTNAME: 2nd_cassandra_host ）ではメトリクスのみを収集します。

integrations:
  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer
  - name: nri-cassandra
    env:
      INVENTORY: "true"
      HOSTNAME: 1st_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 60s
    labels:
      env: production
      role: load_balancer
    inventory_source: config/cassandra

  - name: nri-cassandra
    env:
      METRICS: "true"
      HOSTNAME: 2nd_cassandra_host
      PORT: 7199
      USERNAME: cassandra_user
      PASSWORD: cassandra_password
    interval: 30s
    labels:
      env: production
      role: load_balancer

データの検索と使用

このサービスからのデータは、インテグレーションダッシュボードにレポートされます。

Cassandraデータは、 CassandraSample および CassandraColumnFamilySample イベント・タイプに添付されます。このデータを照会してトラブルシューティングの目的で使用したり、チャートやダッシュボードを作成したりすることができます。

データの検索・使用方法の詳細については、インテグレーションデータを理解するを参照してください。

メトリックデータ

Cassandraインテグレーションでは、以下のメトリクスを収集します。

ノードメトリクス

Cassandraノード・メトリクスは、 CassandraSample イベント・タイプに添付されます。Cassandra統合はこれらのノード・メトリクスを収集します。

名前	説明
`db.allMemtablesOffHeapSizeBytes`	オンヒープに存在するmemtables（2iおよび保留中のフラッシュmemtablesを含む）に格納されているバイトの総量。
`db.allMemtablesOnHeapSizeBytes`	オフヒープに存在するmemtables（2iおよび保留中のフラッシュmemtablesを含む）に格納されているバイトの合計量。
`db.commitLogCompletedTasksPerSecond`	1秒間に書き込まれるコミットログメッセージの数。
`db.commitLogPendindTasks`	書き込まれたものの、まだfsyncされていないコミットログメッセージの数。
`db.commitLogTotalSizeBytes`	すべてのコミットログセグメントで使用されている現在のサイズ（バイト単位）。
`db.droppedRequestTypeMessagesPerSecond`	Dropped messages per second for this type of request. `RequestType` は以下のいずれかになります。BatchRemove、BatchStore、CounterMutation、Hint、Mutation、PagedRange、RangeSlice、Read、ReadRepair、RequestResponse、Traceのいずれかです。
`db.keyCacheCapacityBytes`	キーキャッシュの容量（バイト）。
`db.keyCacheHitRate`	1分間のキーキャッシュヒット率。
`db.keyCacheHitsPerSecond`	1秒あたりのキーキャッシュヒット数。
`db.keyCacheRequestsPerSecond`	1秒あたりのキーキャッシュへのリクエスト数。
`db.keyCacheSizeBytes`	占有されるキャッシュのサイズ（単位：バイト）。
`db.liveSSTableCount`	このカラム・ファミリーのディスク上のSSTableの数。
`db.loadBytes`	このノードが管理するディスク上のデータサイズをバイト単位で表したもの。
`db.rowCacheCapacityBytes`	行キャッシュの容量（バイト）。
`db.rowCacheHitRate`	1分間のロウキャッシュヒット率。
`db.rowCacheHitsPerSecond`	1秒あたりの行キャッシュヒット数。
`db.rowCacheRequestsPerSecond`	1秒あたりのローキャッシュへのリクエスト数。
`db.rowCacheSizeBytes`	占有している行キャッシュの合計サイズ（バイト）。
`db.threadpool.poolActiveTasks`	このプールでアクティブに作業されているタスクの数 `プール` は以下のいずれかになります。 internalAntiEntropyStage internalCacheCleanupExecutor internalCompactionExecutor 内部ゴシップステージ internalHintsDispatcher internalInternalResponseStage（インターナル・レスポンス・ステージ internalMemtableFlushWriter internalMemtablePostFlush internalMemtableReclaimMemory internalMigrationStage internalMiscStage internalPendingRangeCalculator インターナルサンプラ internalSecondaryIndexManagement インターナルバリデーションエグゼキューター requestCounterMutationStage requestMutationStage requestReadRepairStage requestReadStage リクエスト・レスポンス requestViewMutationStage
`db.threadpool.pool.PendingTasks`	このプールでアクティブに作業されているタスクの数 `プール` は、 `の説明で提供されているリストのいずれかの項目になります。 db.threadpool.poolActiveTasks`.
`db.totalHintsInProgress`	現在、送信しようとしているヒントの数。
`db.totalHintsPerSecond`	このノードに書き込まれた1秒あたりのヒントメッセージの数。1つのヒントにつき、ヒントされるホストごとに1つのエントリを含みます。
`query.CASReadRequestsPerSecond`	トランザクションのリードレイテンシー（1秒あたりのリクエスト数）。
`query.CASWriteRequestsPerSecond`	トランザクションの書き込み待ち時間（1秒あたりのリクエスト数）。
`query.rangeSliceRequestsPerSecond`	1秒あたりのレンジ・スライス・リクエストの数。
`query.rangeSliceTimeoutsPerSecond`	トークンレンジの読み取り要求を処理する際に、1秒あたりに発生したタイムアウトの数。
`query.rangeSliceUnavailablesPerSecond`	トークンレンジの読み取り要求を処理する際に、1秒あたりに発生した利用できない例外の数。
`query.readLatency50thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、50パーセンタイル。
`query.readLatency75thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、75パーセンタイル。
`query.readLatency95thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、95パーセンタイル。
`query.readLatency98thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、98パーセンタイル。
`query.readLatency999thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、999パーセンタイル。
`query.readLatency99thPercentileMilliseconds`	リードレイテンシー（ミリ秒）、99パーセンタイル。
`query.readRequestsPerSecond`	1秒あたりの読み取り要求数。
`query.readTimeoutsPerSecond`	標準的な読み取り要求を処理する際に、1秒間に発生したタイムアウトの数。
`query.readUnavailablesPerSecond`	標準的な読み取り要求を処理する際に、1秒あたりに発生した利用できない例外の数。
`query.viewWriteRequestsPerSecond`	1秒あたりのビュー書き込み要求の数。
`query.writeLatency50thPercentileMilliseconds`	書き込み待ち時間（ミリ秒）、50パーセンタイル。
`query.writeLatency75thPercentileMilliseconds`	書き込み遅延（ミリ秒）、75パーセンタイル。
`query.writeLatency95thPercentileMilliseconds`	書き込み遅延（ミリ秒）、95パーセンタイル。
`query.writeLatency98thPercentileMilliseconds`	書き込みレイテンシー（ミリ秒）、98パーセンタイル。
`query.writeLatency999thPercentileMilliseconds`	書き込み遅延（ミリ秒）、999パーセンタイル。
`query.writeLatency99thPercentileMilliseconds`	書き込み遅延（ミリ秒）、99パーセンタイル。
`query.writeRequestsPerSecond`	1秒あたりの書き込み要求の数。
`query.writeTimeoutsPerSecond`	通常の書き込み要求を処理する際に、1秒間に発生したタイムアウトの数。
`query.writeUnavailablesPerSecond`	通常の書き込み要求を処理する際に、1秒間に発生した利用できない例外の数。

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

Cassandraの統合では、カラム・ファミリー・メトリクスを取得します。Cassandra カラム・ファミリー・データは、 CassandraColumnFamilySample イベント・タイプに添付されます。システム・キースペース（system 、 system_auth 、 system_distributed 、 system_schema 、 system_traces 、 OpsCenter ）はスキップされます。パフォーマンスへの影響を抑えるため、この統合では最大20のカラム・ファミリーのメトリクスのみをキャプチャします。

以下のメタデータは、サンプルメトリクスに関連するキースペースとカラムファミリーを示しています。

名前	説明
`db.columnFamily`	これらのメトリクスが参照するCassandraのカラム・ファミリー。
`db.keyspace`	このカラム・ファミリーを含むCassandraのキースペース。
`db.keyspaceAndColumnFamily`	`keyspace`.`columnFamily`.という形式で、キースペースとカラムファミリーを1つのメタデータ属性にしています。

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

名前	説明
`db.allMemtablesOffHeapSizeBytes`	オフヒープに存在するmemtables（2iおよび保留中のフラッシュmemtablesを含む）に格納されているバイトの合計数。
`db.allMemtablesOnHeapSizeBytes`	オンヒープに存在するmemtables（2iおよび保留中のフラッシュmemtablesを含む）に格納されているバイト数の合計。
`db.liveDiskSpaceUsedBytes`	このカラム・ファミリーに属するSSTableが使用するディスク容量（単位：バイト）。
`db.liveSSTableCount`	このカラム・ファミリーのディスク上のSSTableの数。
`db.pendingCompactions`	このカラムファミリーの保留中の圧縮数の推定値。
`db.SSTablesPerRead50thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、50パーセンタイル。
`db.SSTablesPerRead75thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、75パーセンタイル。
`db.SSTablesPerRead95thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、95パーセンタイル。
`db.SSTablesPerRead98thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、98パーセンタイル。
`db.SSTablesPerRead999thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、999パーセンタイル。
`db.SSTablesPerRead99thPercentileMilliseconds`	読み取りごとにアクセスされるsstableデータファイルの数、99パーセンタイル。
`query.readLatency50thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、50パーセンタイル。
`query.readLatency75thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、75パーセンタイル。
`query.readLatency95thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、95パーセンタイル。
`query.readLatency98thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、98パーセンタイル。
`query.readLatency999thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、999パーセンタイル。
`query.readLatency99thPercentileMilliseconds`	このカラムファミリーのローカルリードレイテンシー（ミリ秒）、99パーセンタイル。
`query.readRequestsPerSecond`	このカラム・ファミリーの1秒あたりのリード・リクエストの数。
`query.writeLatency50thPercentileMilliseconds`	このカラムファミリのローカル書き込みレイテンシー（ミリ秒）、50パーセンタイル。
`query.writeLatency75thPercentileMilliseconds`	このカラムファミリのローカル書き込みレイテンシ（ミリ秒）、75パーセンタイル。
`query.writeLatency95thPercentileMilliseconds`	このカラムファミリのローカル書き込みレイテンシ（ミリ秒）、95パーセンタイル。
`query.writeLatency98thPercentileMilliseconds`	このカラムファミリーのローカル書き込みレイテンシー（ミリ秒）、98パーセンタイル。
`query.writeLatency999thPercentileMilliseconds`	このカラムファミリのローカル書き込みレイテンシー（ミリ秒）、999パーセンタイル。
`query.writeLatency99thPercentileMilliseconds`	このカラムファミリのローカル書き込みレイテンシ（ミリ秒）、99パーセンタイル。
`query.writeRequestsPerSecond`	このカラムファミリーの1秒あたりの書き込み要求数。

インベントリ

この統合では、Cassandraの構成で定義された構成オプションを取得し、New Relic UI のインベントリデータとして報告します。

システムメタデータ

また、Cassandraの統合では、サービスとその構成に関するこれらの属性を収集します。

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

トラブルシューティング

jmxtermによるトラブルシューティング

JMXTerm は、統合パッケージにバンドルされているコマンドライン・インタラクティブ・ツールです。

JMXTerm の Docs は、GitHub の私たちの nrjmx ページで見ることができます。

ソースコードのチェック

このインテグレーションは、オープンソース・ソフトウェアです。つまり、そのソースコードを閲覧して改良を送ったり、独自のフォークを作成して構築することができます。

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。