Apache Cassandra のメンテナンス タスク

このセクションでは、Cassandra の定期的なメンテナンス タスクについて説明します。

アンチエントロピー メンテナンス

Apache Cassandra リングノードでは、すべてのノードの整合性を保つために定期的なメンテナンスが必要です。このメンテナンスを行うには、次のコマンドを使用します。

apigee-service apigee-cassandra apigee_repair -pr

このコマンドを実行する際は、次のことをおすすめします。

  • （すべてのリージョンまたはデータセンターにある）すべての Cassandra ノードに対して実行します。

  • ノードの修復ジョブが正常に完了したかどうかを確認するには、ノードの system.log ファイルで、最新の修復セッションの UUID と「session completed successfully」というメッセージを含むエントリを探します。ログエントリの例を次に示します。

    INFO [AntiEntropySessions:1] 2015-03-01 10:02:56,245 RepairSession.java (line 282) [repair #2e7009b0-c03d-11e4-9012-99a64119c9d8] session completed successfully"
Ref: https://support.datastax.com/hc/en-us/articles/204226329-How-to-check-if-a-scheduled-nodetool-repair-ran-successfully
  • ワークロードが比較的少ない時間帯に実行します（このツールはシステムに大きな負荷をかけます）。
  • Cassandra の「削除忘れ」に関連する問題を排除するため、少なくとも 7 日ごとに実行します。
  • 異なる日に異なるノードで実行するか、各ノードで実行する間に数時間の間隔を空けるようにスケジュールします。
  • -pr オプション（パーティショナー範囲）を使用して、ノードのプライマリ パーティショナー範囲のみを指定します。

Cassandra の JMX 認証を有効にしている場合は、nodetool を呼び出すときにユーザー名とパスワードを指定する必要があります。次に例を示します。

apigee-service apigee-cassandra apigee_repair -u username -pw password -pr

次のコマンドを実行して、apigee_repair: でサポートされているオプションを確認することもできます。

apigee-service apigee-cassandra apigee_repair -h

注: apigee_repair は Cassandra の nodetool repair のラッパーであり、Cassandra の修復を実行する前に追加のチェックを行います。

詳しくは、次のリソースをご覧ください。

ログファイルのメンテナンス

Cassandra ログは、各ノードの /opt/apigee/var/log/cassandra ディレクトリに保存されます。デフォルトでは、最大 50 個のログファイルを作成できます。各ファイルの最大サイズは 20 MB です。この上限に達すると、新しいログが作成されるときに古いログが削除されます。

Cassandra のログファイルが過剰な容量を占有している場合は、log4j の設定を編集して、ログファイルに割り当てられる容量を変更できます。

  1. /opt/apigee/customer/application/cassandra.properties を編集して、次のプロパティを設定します。ファイルが存在しない場合は作成します。 
    conf_logback_maxfilesize=20MB
# max file size
conf_logback_maxbackupindex=50 # max open files
  2. 次のコマンドを使用して Cassandra を再起動します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

ディスク容量のメンテナンス

Cassandra のディスク使用率を定期的にモニタリングして、各ディスクの少なくとも 50% が空いていることを確認する必要があります。ディスク使用率が 50% を超える場合は、ディスク容量を追加して使用率を減らすことをおすすめします。

Cassandra は、独自のディスク使用率を削減するために、次のオペレーションを自動的に実行します。

  • トークンの有効期限が切れたときの認証トークンの削除。ただし、構成によっては、トークンが使用していたディスク容量が解放されるまでに数週間かかることがあります。自動削除では十分なディスク容量を維持できない場合は、サポートに連絡して、トークンを手動で削除して容量を回復する方法を確認してください。

  • データ圧縮に関する注: Edge for Private Cloud 4.51.00 以降、Apigee Cassandra の新規インストールでは、 Leveled Compaction Strategy を使用してキースペースが作成されます。

    Private Cloud 4.51.00 にアップグレードされた古いバージョンの Edge for Private Cloud のインストールでは、以前の圧縮戦略が引き続き保持されます。既存のコンパクション戦略が SizeTieredCompactionStrategy の場合は、ディスク使用率が向上する LeveledCompactionStrategy に変更することをおすすめします。

注: Cassandra がデータ圧縮を実行すると、かなりの CPU サイクルとメモリが消費される可能性があります。ただし、コンパクションが完了すると、リソース使用率は通常に戻ります。各ノードで 'Nodetool compactionstats' コマンドを実行して、圧縮が実行されているかどうかを確認できます。compactionstats の出力には、実行待ちのコンパクションがあるかどうかと、完了までの推定時間が表示されます。