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インテグレーションをインストールするには

インフラストラクチャエージェントをインストールし、 INTEGRATION_FILE_NAME変数を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 インスタンスの設定

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イベントタイプに添付されます。トラブルシューティングの目的で、またはチャートやダッシュボードを作成するために、このデータをクエリできます。

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

NRQL で nodetool ステータスを再作成するには、次のクエリを実行します。

SELECT cluster.datacenter, fullHostname, cluster.name, cluster.rack, entityName, hostStatus, (db.loadBytes /10e3) AS 'kb db.loadBytes' FROM CassandraSample

メトリックデータ

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.<pool>ActiveTasks`	このプールによってアクティブに処理されているタスクの数。`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.<pool>ActiveTasks`の説明で提供されるリスト内の項目のいずれかを指定できます。
`db.threadpool.<pool>CompletedTasks`	完了したタスクの数。`pool` は、 `db.threadpool.<pool>ActiveTasks`の説明で提供されるリスト内の項目のいずれかを指定できます。
`db.threadpool.<pool>TotalBlockedTasks`	キューの飽和によりブロックされたタスクの数。`pool` は、 `db.threadpool.<pool>ActiveTasks`の説明で提供されるリスト内の項目のいずれかを指定できます。
`db.threadpool.<pool>CurrentlyBlockedTask`	キューの飽和により現在ブロックされているが、再試行するとブロックが解除されるタスクの数。`pool` は、 `db.threadpool.<pool>ActiveTasks`の説明で提供されるリスト内の項目のいずれかを指定できます。
`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ノードが属するクラスターの名前。

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

この統合はオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。

この機械翻訳は参考用に提供されます。