• /
  • ログイン
  • 無料アカウント

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

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

問題を作成する

Cassandraモニタリングの統合

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

インテグレーションのインストールと、当社がどのようなデータを収集するかについてお読みください。

互換性および要件

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

インテグレーションをインストールする前に、以下の要件を満たしていることを確認してください。

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

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

ガイド付きインストールCLIのスクリーンショット。

始める準備はできていますか?ボタンの1つをクリックし、試行してください。

ガイド付きインストール

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

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

インストールと有効化

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

追加の注:

' '

設定

インテグレーションの設定

インストールの方法により、インテグレーションの設定方法はいくつかあります。

インテグレーションのYAML形式設定では、必要なログインクレデンシャルやデータの収集方法を設定できます。どのオプションを変更するかは、設定とプリファレンスにより異なります。

設定ファイルには、 intervaltimeoutinventory_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/
cassandra.yaml

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

REMOTE_MONITORING

マルチテナンシー監視を有効にします。

false

M/I

メトリクス

trueに設定すると、メトリクスのみの収集が有効になります。

false

インベントリ

trueに設定すると、インベントリのみの収集が有効になります。

false

これらの設定値は、いくつかの方法で定義できます。

  • コンフィグファイルに直接値を追加する。これが最も一般的な方法です。
  • {{}} 表記を使用して環境変数から値を置き換えます。これには、インフラストラクチャ・エージェント v1.14.0+が必要です。詳しくはこちら または、以下の例をご覧ください .
  • シークレット管理を使用する。設定ファイル上で平文で公開されてしまうようなパスワードなどの機密情報を保護するために使用します。詳細については、 Secrets management を参照してください。

ラベル/カスタム属性

メトリクスは、ラベルを使ってさらに装飾することができます。
デフォルトのサンプル・コンフィグ・ファイルにはラベルの例が含まれていますが、これらは必須ではありませんので、お好きなものを削除、変更、または新たに追加することができます。

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

Dropped messages per second for this type of request. 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

このプールでアクティブに作業されているタスクの数 プール は以下のいずれかになります。

  • internalAntiEntropyStage
  • internalCacheCleanupExecutor
  • internalCompactionExecutor
  • 内部ゴシップステージ
  • internalHintsDispatcher
  • internalInternalResponseStage(インターナル・レスポンス・ステージ
  • internalMemtableFlushWriter
  • internalMemtablePostFlush
  • internalMemtableReclaimMemory
  • internalMigrationStage
  • internalMiscStage
  • internalPendingRangeCalculator
  • インターナルサンプラ
  • internalSecondaryIndexManagement
  • インターナルバリデーションエグゼキューター
  • requestCounterMutationStage
  • requestMutationStage
  • requestReadRepairStage
  • requestReadStage
  • リクエスト・レスポンス
  • requestViewMutationStage

db.threadpool.pool.PendingTasks

このプールでアクティブに作業されているタスクの数 プール は、 の説明で提供されているリストのいずれかの項目になります。 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_tracesOpsCenter )はスキップされます。パフォーマンスへの影響を抑えるため、この統合では最大20のカラム・ファミリーのメトリクスのみをキャプチャします。

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

名前

説明

db.columnFamily

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

db.keyspace

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

db.keyspaceAndColumnFamily

keyspace.columnFamily.という形式で、キースペースとカラムファミリーを1つのメタデータ属性にしています。

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

名前

説明

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