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とインフラストラクチャ・エージェントをダウンロードしてインストールします。

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

ガイド付きインストール

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

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

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

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

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

その他の注意事項：

高度：統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。

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

ファイル名nri-cassandraを使用して、統合をインストールするための指示に従います。
ディレクトリをintegrationフォルダに変更します。
```
cd /etc/newrelic-infra/integrations.d
```
サンプル構成ファイルをコピーします。
```
sudo cp cassandra-config.yml.sample cassandra-config.yml
```
構成設定の説明に従って、 cassandra-config.ymlファイルを編集します。
インフラストラクチャエージェントを再起動します。
Cassandraエラーログの自動解析と転送を有効にするには、 cassandra-log.yml.exampleファイルをcassandra-log.ymlにコピー（または名前変更）します。エージェントを再起動する必要はありません。
例：
```
sudo cp /etc/newrelic-infra/logging.d/casssandra-log.yml.example /etc/newrelic-infra/logging.d/cassandra-log.yml
```

構成

統合を構成する

インストール方法に応じて、統合を構成する方法はいくつかあります。

Kubernetes経由で有効になっている場合： Kubernetesで実行されているサービスの監視をご覧ください。
Amazon ECSを介して有効になっている場合： ECSで実行されている監視サービスを参照してください。
ホストにインストールされている場合：統合のYAML構成ファイルcassandra-config.ymlの構成を編集します。

統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。

構成ファイルには、 interval 、 timeout 、 inventory_sourceなどのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、構成フォーマットのドキュメントを参照してください。

重要

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

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

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

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

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

設定	説明	デフォルト	に適用されます
ホスト名	Cassandraが稼働しているホスト名またはIP。	ローカルホスト	M / I
ポート	Cassandraがリッスンしているポート。	7199	M
ユーザー名	JMXにアクセスするためのユーザー名です。	該当なし	M
パスワード	指定されたユーザーのパスワード。	該当なし	M
CONFIG_PATH	Cassandra構成ファイルへのパス。	/etc/cassandra/ cassandra.yaml	私
コラム_ファミリア_リミット	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
METRICS	メトリックのみの収集を有効にするには、 `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`	このタイプのリクエストで1秒あたりにドロップされたメッセージ。`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`	このプールによってアクティブに処理されているタスクの数。`pool`は次のいずれかになります。 internalAntiEntropyStage internalCacheCleanupExecutor internalCompactionExecutor 内部ゴシップステージ internalHintsDispatcher internalInternalResponseStage（インターナル・レスポンス・ステージ internalMemtableFlushWriter internalMemtablePostFlush internalMemtableReclaimMemory internalMigrationStage internalMiscStage internalPendingRangeCalculator インターナルサンプラ internalSecondaryIndexManagement インターナルバリデーションエグゼキューター requestCounterMutationStage requestMutationStage requestReadRepairStage requestReadStage リクエスト・レスポンス requestViewMutationStage
`db.threadpool.pool.PendingTasks`	このプールによってアクティブに処理されているタスクの数。`pool`は、 `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` 。

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

名前	説明
`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 ページで見ることができます。

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

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

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