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

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

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

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

apigee-service apigee-cassandra apigee_repair -pr

このコマンドを実行するときの推奨事項を以下に示します。

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

  • リング内のすべてのノードの整合性を保つため、一度に 1 つのノードに対して実行します。複数のノードで同時に修復ジョブを実行すると、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 日ごとに実行します。
  • 日によって違うノードに対して実行することも、数時間ごとに 1 ノードずつ実行するようスケジュールすることもできます。
  • -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 修復ユーティリティのラッパーであり、Cassandra の修復を実行する前に追加のチェックを行います。

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

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

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

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 の出力から、実行待ちの圧縮があるかどうかと、完了までの予想時間がわかります。