当社のCassandra統合は、パフォーマンス メトリクス と インベントリデータ をCassandraデータベースからNew Relicプラットフォームに送信します。Cassandraのメトリクスデータの構築済みダッシュボードを表示したり、アラートポリシーを作成したり、独自のカスタムクエリやチャートを作成することができます。
インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。
互換性および要件
当社のインテグレーションは、Apache Cassandraのバージョン3.x以上に対応しています。
インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。
Java Runtime Environment 7以上。
CassandraがKubernetesまたはAmazon ECS上で 実行されていない場合は、 Cassandraを実行しているLinuxホストにインフラストラクチャエージェント をインストールする必要があります。それ以外の場合は
クイック・スタート:ガイド付きインストールを使用
ガイド付きインストールで、Cassandra データベースをすばやくインスツルメントし、テレメトリー データを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。

始める準備はできていますか?ボタンの1つをクリックし、試行してください。
ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してCassandraとの統合を設定します。それだけでなく、環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨してくれます。
ガイド付きインストールは、ほとんどのセットアップで動作します。しかし、ニーズに合わない場合は、以下の他の方法でCassandraデータベースのモニタリングを始めることができます。
インストールと有効化
Cassandraインテグレーションをインストールするには、お使いの環境の指示に従ってください。
追加の注:
- アドバンスト:インテグレーションはtarball書式で使用すると、パッケージマネージャ以外にもインストールできます。
- オンホストインテグレーションは、自動的にアップデートしません。最善の結果を得るため、インテグレーションパッケージの更新と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/ | 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 |
マルチテナンシー監視を有効にします。 | false | M/I | |
メトリクス |
| false | |
インベントリ |
| false |
これらの設定値は、いくつかの方法で定義できます。
- コンフィグファイルに直接値を追加する。これが最も一般的な方法です。
{{}}
表記を使用して環境変数から値を置き換えます。これには、インフラストラクチャ・エージェント v1.14.0+が必要です。詳しくはこちら または、以下の例をご覧ください .- シークレット管理の使用。これを使用して、設定ファイルのプレーンテキストで公開されないようにパスワードなどの重要な情報を保護してください。詳細については、シークレット管理を参照してください。
ラベル/カスタム属性
メトリクスは、ラベルを使ってさらに装飾することができます。
デフォルトのサンプル・コンフィグ・ファイルにはラベルの例が含まれていますが、これらは必須ではありませんので、お好きなものを削除、変更、または新たに追加することができます。
labels: env: production role: load_balancer
設定の例
データの検索と使用
このサービスからのデータは、インテグレーションダッシュボードにレポートされます。
Cassandraデータは、 CassandraSample
および CassandraColumnFamilySample
イベント・タイプ に添付されます。 このデータを照会して トラブルシューティングの目的で使用したり、チャートやダッシュボードを作成したりすることができます。
データの検索・使用方法の詳細については、 インテグレーションデータを理解するを参照してください。
メトリックデータ
Cassandraインテグレーションでは、以下のメトリクスを収集します。
ノードメトリクス
Cassandraノード・メトリクスは、 CassandraSample
イベント・タイプ に添付されます。Cassandra統合はこれらのノード・メトリクスを収集します。
名前 | 説明 |
---|---|
| オンヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイトの総量。 |
| オフヒープに存在するmemtables(2iおよび保留中のフラッシュmemtablesを含む)に格納されているバイトの合計量。 |
| 1秒間に書き込まれるコミットログメッセージの数。 |
| 書き込まれたものの、まだfsyncされていないコミットログメッセージの数。 |
| すべてのコミットログセグメントで使用されている現在のサイズ(バイト単位)。 |
| Dropped messages per second for this type of request. |
| キーキャッシュの容量(バイト)。 |
| 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ノードが属するクラスターの名前。 |
トラブルシューティング
jmxtermによるトラブルシューティング
JMXTerm は、統合パッケージにバンドルされているコマンドライン・インタラクティブ・ツールです。
JMXTerm の Docs は、GitHub の私たちの nrjmx ページ で見ることができます。
ソースコードのチェック
このインテグレーションは、オープンソース・ソフトウェアです。つまり、 そのソースコードを閲覧して 改良を送ったり、独自のフォークを作成して構築することができます。