当社のCassandra統合は、パフォーマンス メトリクス と インベントリデータ をCassandraデータベースからNew Relicプラットフォームに送信します。Cassandraのメトリクスデータの構築済みダッシュボードを表示したり、アラートポリシーを作成したり、独自のカスタムクエリやチャートを作成することができます。
統合をインストールし、収集するデータを確認するために読んでください。
互換性と要件
当社のインテグレーションは、Apache Cassandraのバージョン3.x以上に対応しています。
統合をインストールする前に、次の要件を満たしていることを確認してください。
Java Runtime Environment 7以上。
CassandraがKubernetesまたはAmazon ECS上で 実行されていない場合は、 Cassandraを実行しているLinuxホストにインフラストラクチャエージェント をインストールする必要があります。それ以外の場合は
クイック・スタート:ガイド付きインストールを使用
ガイド付きインストールで、Cassandra データベースをすばやくインスツルメントし、テレメトリー データを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。
始める準備はできましたか?これらのボタンのいずれかをクリックして試してください。
ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してCassandraとの統合を設定します。それだけでなく、環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨してくれます。
ガイド付きインストールは、ほとんどのセットアップで動作します。しかし、ニーズに合わない場合は、以下の他の方法でCassandraデータベースのモニタリングを始めることができます。
インストールしてアクティブ化する
Cassandraインテグレーションをインストールするには、お使いの環境の指示に従ってください。
その他の注意事項:
- 高度:統合はtarball形式でも利用可能であり、パッケージマネージャーの外部にインストールできます。
- オンホスト統合は自動的に更新されません。最良の結果を得るには、統合パッケージとインフラストラクチャエージェントを定期的に更新してください。
''
このドキュメントはインストールで役立ちましたか。
構成
統合を構成する
インストール方法に応じて、統合を構成する方法はいくつかあります。
- 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カラム・ファミリーの数の制限。 | 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
構成例
データを見つけて使用する
このサービスからのデータは、 統合ダッシュボードに報告されます。
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統合は、次のノードメトリックを収集します。
名前 | 説明 |
---|---|
| オンヒープに存在する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ノードが属するクラスターの名前。 |
ソースコードを確認してください
この統合はオープン ソース ソフトウェアです。つまり、ソース コードを参照して改善を送信したり、独自のフォークを作成してビルドしたりできます。