• ログイン今すぐ開始

本書は、お客様のご参考のために原文の英語版を機械翻訳したものです。

英語版と齟齬がある場合、英語版の定めが優先するものとします。より詳しい情報については、本リンクをご参照ください。

問題を作成する

Cassandraモニタリングの統合

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

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

互換性と要件

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

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

クイック・スタート:ガイド付きインストールを使用

ガイド付きインストールで、Cassandra データベースをすばやくインスツルメントし、テレメトリー データを送信します。ガイド付きインストールでは、お客様の環境に合わせてカスタマイズされたCLIコマンドを作成し、New Relic CLIとインフラストラクチャ・エージェントをダウンロードしてインストールします。

始める準備はできましたか?これらのボタンのいずれかをクリックして試してください。

ガイド付きインストール

ガイド付きインストールでは、インフラストラクチャ・エージェントを使用してCassandraとの統合を設定します。それだけでなく、環境で稼働している他のアプリケーションやログ・ソースを検出し、どのアプリケーションを導入すべきかを推奨してくれます。

ガイド付きインストールは、ほとんどのセットアップで動作します。しかし、ニーズに合わない場合は、以下の他の方法でCassandraデータベースのモニタリングを始めることができます。

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

Cassandraインテグレーションをインストールするには、お使いの環境の指示に従ってください。

その他の注意事項:

''

構成

統合を構成する

インストール方法に応じて、統合を構成する方法はいくつかあります。

統合のYAML形式の構成では、必要なログイン資格情報を配置し、データの収集方法を構成できます。どのオプションを変更するかは、セットアップと設定によって異なります。

構成ファイルには、 intervaltimeoutinventory_sourceなどのすべての統合に適用できる共通の設定があります。これらの一般的な設定についてすべて読むには、 構成フォーマットのドキュメントを参照してください。

重要

従来の設定/定義ファイルをまだお使いの場合は、こちらの ドキュメント を参考にしてください。

Cassandraに関連する特定の設定は、構成ファイルのenvセクションを使用して定義されます。これらの設定は、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

構成例

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

このサービスからのデータは、 統合ダッシュボードに報告されます。

CassandraデータはCassandraSampleおよびCassandraColumnFamilySampleイベントタイプに添付されます。トラブルシューティングの目的で、またはチャートやダッシュボードを作成するために、このデータをクエリできます。

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

メトリックデータ

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.poolActiveTasks

このプールによってアクティブに処理されているタスクの数。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.poolActiveTasksの説明で提供されるリスト内の任意のアイテムにすることができます。

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イベントタイプに付加されます。システムのキースペース( systemsystem_authsystem_distributedsystem_schemasystem_traces 、およびOpsCenter )をスキップします。パフォーマンスへの影響を制限するために、統合では最大20の列ファミリーのメトリックのみがキャプチャされます。

以下のメタデータは、サンプルメトリクスに関連するキースペースとカラムファミリーを示しています。

名前

説明

db.columnFamily

これらのメトリクスが参照するCassandraのカラム・ファミリー。

db.keyspace

このカラム・ファミリーを含むCassandraのキースペース。

db.keyspaceAndColumnFamily

次の形式の単一のメタデータ属性のキースペースと列ファミリー: keyspacecolumnFamily

以下のメトリクスのリストは、上記のメタデータで指定された特定のキースペースとカラムファミリーを参照しています。

名前

説明

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

トラブルシューティング

jmxtermによるトラブルシューティング

JMXTerm は、統合パッケージにバンドルされているコマンドライン・インタラクティブ・ツールです。

JMXTerm の Docs は、GitHub の私たちの nrjmx ページ で見ることができます。

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

このインテグレーションは、オープンソース・ソフトウェアです。つまり、 そのソースコードを閲覧して 改良を送ったり、独自のフォークを作成して構築することができます。

Copyright © 2022 New Relic株式会社。

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.