当社のCassandra統合は、パフォーマンス メトリクス と インベントリデータ をCassandraデータベースからNew Relicプラットフォームに送信します。Cassandraのメトリクスデータの構築済みダッシュボードを表示したり、アラートポリシーを作成したり、独自のカスタムクエリやチャートを作成することができます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社のインテグレーションは、Apache Cassandraのバージョン3.x以上に対応しています。
統合をインストールする前に、次の 3 つの要件を満たしていることを確認してください。
Java Runtime Environment 7以上。
CassandraがKubernetesまたはAmazon ECS上で 実行されていない場合は、 Cassandraを実行しているLinuxホストにインフラストラクチャエージェント をインストールする必要があります。それ以外の場合は
クイックスタート
Cassandra データベースを迅速に計測し、ガイド付きインストールでテレメトリ データを送信します。ガイド付きインストールでは、インフラストラクチャ エージェントと CLI を使用して Cassandra 統合をセットアップし、環境内で実行されている他のアプリケーションとログ ソースを検出して、どのアプリケーションを計測する必要があるかを推奨します。
ガイド付きインストールは、ほとんどの設定と連動します。ただし、ご希望に添えない場合は、以下の他のインストールオプションがあります。
始める準備はできていますか?使用するデータセンターの地域に応じて、該当するボタンをクリックします。インストールが完了したら、本ドキュメントに戻って設定オプションを確認してください。
インストールしてアクティブ化する
ガイド付きインストールを使用しない場合は、ご使用の環境に応じた手順に従ってください。
''
このドキュメントはインストールで役立ちましたか。
統合を更新する
このインテグレーションは、自動更新しません。最善の結果を得るため、インテグレーションパッケージの更新と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カラム・ファミリーの数の制限。 | 20 | M |
タイムアウト | リクエストのタイムアウト(単位:ミリ秒)。 | 2000 | M |
KEY_STORE | JMXクライアントのSSL証明書を含むキーストアのファイルパスです。 | 該当なし | M |
キー・ストア・パスワード | JMXのSSLキーストアのパスワードです。 | 該当なし | M |
TRUST_STORE | JMXクライアントのSSL証明書を含むトラストストアのファイルパスです。 | 該当なし | M |
trust_store_password | JMX SSLトラストストアのパスワードです。 | 該当なし | M |
マルチテナンシー監視を有効にします。 | false | M / I | |
METRICS | メトリックのみの収集を有効にするには、 | false | |
在庫 | インベントリのみの収集を有効にするには、 | false |
これらの設定の値は、いくつかの方法で定義できます。
- 設定ファイルに直接値を追加します。これが最も一般的な方法です。
{{}}
表記を使用して環境変数の値を置き換えます。これには、インフラストラクチャエージェントv1.14.0以降が必要です。詳細については、 こちらをご覧になるか、以下の例をご覧ください。- シークレット管理を使用します。これを使用して、構成ファイルにプレーンテキストで公開されるパスワードなどの機密情報を保護します。詳細については、シークレット管理を参照してください。
ラベル
さらに、メトリクスにラベルを付けることもできます。ラベルを使用すると、属性(キーや値のペア)をメトリクスに追加して、メトリクスのクエリを挙げ、フィルターをかけ、グループ化を行うことができます。
デフォルトのサンプル設定ファイルにはラベルの例が含まれていますが、必須ではないため、選択したラベルを削除、変更、お好きな設定を新規追加することができます。
labels: env: production role: load_balancer
構成例
以下に、YAML設定の例をいくつか示します。
データを見つけて使用する
この統合からのデータは、 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統合は、次のノードメトリックを収集します。
名前 | 説明 |
---|---|
| オンヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイトの総量。 |
| オフヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイトの合計量。 |
| 1秒間に書き込まれるコミットログメッセージの数。 |
| 書き込まれたものの、まだfsyncされていないコミットログメッセージの数。 |
| すべてのコミットログセグメントで使用されている現在のサイズ(バイト単位)。 |
| このタイプのリクエストで1秒あたりにドロップされたメッセージ。 |
| キーキャッシュの容量(バイト)。 |
| 1分間のキーキャッシュヒット率。 |
| 1秒あたりのキーキャッシュヒット数。 |
| 1秒あたりのキーキャッシュへのリクエスト数。 |
| 占有されるキャッシュのサイズ(単位:バイト)。 |
| このカラム・ファミリーのディスク上のSSTableの数。 |
| このノードが管理するディスク上のデータサイズをバイト単位で表したもの。 |
| 行キャッシュの容量(バイト)。 |
| 1分間のロウキャッシュヒット率。 |
| 1秒あたりの行キャッシュヒット数。 |
| 1秒あたりのローキャッシュへのリクエスト数。 |
| 占有している行キャッシュの合計サイズ(バイト)。 |
| このプールによってアクティブに処理されているタスクの数。
|
| このプールでキューに入れられているタスクの数。 |
| 完了したタスクの数。 |
| キューの飽和によりブロックされたタスクの数。 |
| キューの飽和により現在ブロックされているが、再試行するとブロックが解除されるタスクの数。 |
| 現在、送信しようとしているヒントの数。 |
| このノードに書き込まれた1秒あたりのヒントメッセージの数。1つのヒントにつき、ヒントされるホストごとに1つのエントリを含みます。 |
| トランザクションのリードレイテンシー(1秒あたりのリクエスト数)。 |
| トランザクションの書き込み待ち時間(1秒あたりのリクエスト数)。 |
| 1秒あたりのレンジ・スライス・リクエストの数。 |
| トークンレンジの読み取り要求を処理する際に、1秒あたりに発生したタイムアウトの数。 |
| トークンレンジの読み取り要求を処理する際に、1秒あたりに発生した利用できない例外の数。 |
| リードレイテンシー(ミリ秒)、50パーセンタイル。 |
| リードレイテンシー(ミリ秒)、75パーセンタイル。 |
| リードレイテンシー(ミリ秒)、95パーセンタイル。 |
| リードレイテンシー(ミリ秒)、98パーセンタイル。 |
| リードレイテンシー(ミリ秒)、999パーセンタイル。 |
| リードレイテンシー(ミリ秒)、99パーセンタイル。 |
| 1秒あたりの読み取り要求数。 |
| 標準的な読み取り要求を処理する際に、1秒間に発生したタイムアウトの数。 |
| 標準的な読み取り要求を処理する際に、1秒あたりに発生した利用できない例外の数。 |
| 1秒あたりのビュー書き込み要求の数。 |
| 書き込み待ち時間(ミリ秒)、50パーセンタイル。 |
| 書き込み遅延(ミリ秒)、75パーセンタイル。 |
| 書き込み遅延(ミリ秒)、95パーセンタイル。 |
| 書き込みレイテンシー(ミリ秒)、98パーセンタイル。 |
| 書き込み遅延(ミリ秒)、999パーセンタイル。 |
| 書き込み遅延(ミリ秒)、99パーセンタイル。 |
| 1秒あたりの書き込み要求の数。 |
| 通常の書き込み要求を処理する際に、1秒間に発生したタイムアウトの数。 |
| 通常の書き込み要求を処理する際に、1秒間に発生した利用できない例外の数。 |
Cassandraのカラム・ファミリーのメトリクスとメタデータ
Cassandra統合は、列ファミリーのメトリックを取得します。Cassandra列ファミリーデータはCassandraColumnFamilySample
イベントタイプに付加されます。システムのキースペース( system
、 system_auth
、 system_distributed
、 system_schema
、 system_traces
、およびOpsCenter
)をスキップします。パフォーマンスへの影響を制限するために、統合では最大20の列ファミリーのメトリックのみがキャプチャされます。
以下のメタデータは、サンプルメトリクスに関連するキースペースとカラムファミリーを示しています。
名前 | 説明 |
---|---|
| これらのメトリクスが参照するCassandraのカラム・ファミリー。 |
| このカラム・ファミリーを含むCassandraのキースペース。 |
| 次の形式の単一のメタデータ属性のキースペースと列ファミリー: |
以下のメトリクスのリストは、上記のメタデータで指定された特定のキースペースとカラムファミリーを参照しています。
名前 | 説明 |
---|---|
| オフヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイトの合計数。 |
| オンヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイト数の合計。 |
| このカラム・ファミリーに属するSSTableが使用するディスク容量(単位:バイト)。 |
| このカラム・ファミリーのディスク上のSSTableの数。 |
| このカラムファミリーの保留中の圧縮数の推定値。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、50パーセンタイル。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、75パーセンタイル。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、95パーセンタイル。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、98パーセンタイル。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、999パーセンタイル。 |
| 読み取りごとにアクセスされるsstableデータファイルの数、99パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、50パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、75パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、95パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、98パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、999パーセンタイル。 |
| このカラムファミリーのローカルリードレイテンシー(ミリ秒)、99パーセンタイル。 |
| このカラム・ファミリーの1秒あたりのリード・リクエストの数。 |
| このカラムファミリのローカル書き込みレイテンシー(ミリ秒)、50パーセンタイル。 |
| このカラムファミリのローカル書き込みレイテンシ(ミリ秒)、75パーセンタイル。 |
| このカラムファミリのローカル書き込みレイテンシ(ミリ秒)、95パーセンタイル。 |
| このカラムファミリーのローカル書き込みレイテンシー(ミリ秒)、98パーセンタイル。 |
| このカラムファミリのローカル書き込みレイテンシー(ミリ秒)、999パーセンタイル。 |
| このカラムファミリのローカル書き込みレイテンシ(ミリ秒)、99パーセンタイル。 |
| このカラムファミリーの1秒あたりの書き込み要求数。 |
インベントリ
この統合では、Cassandraの構成で定義された構成オプションを取得し、New Relic UI のインベントリデータとして報告します。
システムメタデータ
また、Cassandraの統合では、サービスとその構成に関するこれらの 属性 を収集します。
名前 | 説明 |
---|---|
| カサンドラのバージョンです。 |
| このCassandraノードが属するクラスターの名前。 |
ソースコードを確認してください
このインテグレーションはオープンソースソフトウェアです。つまり、ソースコードを参照して改善を送信したり、独自のフォークを作成して構築したりできます。