Cassandraモニタリングの統合

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

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

互換性と要件

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

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

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

クイックスタート

Cassandra データベースを迅速に計測し、ガイド付きインストールでテレメトリデータを送信します。ガイド付きインストールでは、インフラストラクチャエージェントと CLI を使用して Cassandra 統合をセットアップし、環境内で実行されている他のアプリケーションとログソースを検出して、どのアプリケーションを計測する必要があるかを推奨します。

ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。

始める準備はできていますか？使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。

ガイド付きインストール（米国オプション）

ガイド付きインストール（EUオプション）

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

ガイド付きインストールを使用しない場合は、ご使用の環境に応じた手順に従ってください。

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
```

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

統合を更新する

このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新とInfrastructureエージェントの更新を定期的に実施してください。

インストール後のタスク

インストールが完了したら、設定オプションを設定できます。インテグレーションを機能させるには、設定がいくつか必要ですが、オプションの設定もあります。

統合を構成する

ECSまたはKubernetesインテグレーションからこのインテグレーションを有効にした場合は、以下のドキュメントを参照してください。

標準オンホストインストールの場合、このインテグレーションにはYAML設定ファイル、apache-config.ymlが付属しています。この設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。コピーおよび編集できるサンプル設定ファイルapache-config.yml.sampleが付属しています。

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

構成例

以下に、YAML設定の例をいくつか示します。

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

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

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

この統合からのデータは、 one.newrelic.com > Infrastructure > Third-party services > Cassandraに移動して見つけることができます。

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ノードメトリックは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ノードが属するクラスターの名前。

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

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

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