すべてのプロダクト
Search
ドキュメントセンター

ApsaraMQ for Kafka:メッセージ構成の変更

最終更新日:Aug 27, 2026

ビジネス要件に応じて、メッセージ保持期間、最大メッセージサイズ、コンシューマーオフセットの保持期間、SSL 証明書のキーサイズ (ビット) を調整できます。

ApsaraMQ for Kafka では、ビジネス要件に合わせてコンソールからメッセージ構成を調整できます。この変更によりインスタンスのローリング再起動がトリガーされるため、開始する前に、変更による影響を確認し、前提条件を満たしてください。

変更による影響

メッセージ構成の変更は、実行中のインスタンスに影響します。開始する前に、以下の影響を確認してください。

  • サービス中断 — この変更により、クラスターのローリング再起動がトリガーされ、短時間のサービス中断が発生する可能性があります。

  • クライアントの再接続 — クライアントが自動再接続を実装していない場合、切断後に接続を回復できません。

説明

メッセージ構成の変更に必要な時間は、インスタンス仕様によって異なります。alikafka.hr.30xlarge または alikafka.hw.30xlarge 以下の仕様のインスタンスの場合、変更には約 30 分かかります。alikafka.hr.60xlarge または alikafka.hw.60xlarge 以上の仕様のインスタンスの場合、変更には 1 時間以上かかります。一般的に、インスタンス仕様が大きいほど、変更にかかる時間は長くなります。

パラメーター

以下の表では、変更可能なメッセージ構成について説明します。

パラメーター説明
[メッセージ保持期間]ディスク領域が十分な場合にメッセージが保持される最大期間です。ディスク領域が不足している場合、つまりディスク使用率が 85% に達した場合、サービスの可用性を確保するために、古いメッセージが予定より早く削除されます。デフォルト値:72 時間。有効値:24 ~ 480 時間。
[最大メッセージのサイズ]ApsaraMQ for Kafka が送受信できるメッセージの最大サイズです。最大メッセージサイズは 10 MB に制限されています。この制限は、スタンダードインスタンスとプロフェッショナルインスタンスの両方に適用されます。
[コンシューマーオフセットの保存期間]

コンシューマーオフセットの最大保持期間です。この期間は、コンシューマーオフセットがコミットされた時点からカウントされます。期間を超えたコンシューマーオフセットは、システムが削除します。コンシューマーオフセットがトピックパーティションにコミットされるたびに、コンシューマーオフセットの保持期間はリセットされ、0から再度カウントが始まります。デフォルトの保持期間は 7 日間 (10,080 分) です。有効値:1,440 ~ 43,200 分。

説明

コンシューマーグループにアクティブなコンシューマースレッドが少なくとも 1 つ含まれている限り、コンシューマーグループのコンシューマーオフセットは、[コンシューマーオフセットの保存期間] の値を超えても削除されません。詳細については、「期限切れのコンシューマーオフセットが保持される理由」をご参照ください。

[SSL 証明書アルゴリズムのビット数]インスタンスのインターネットアクセスが有効になっている場合に使用される SSL 証明書のキーサイズです。キーサイズを 1,024 ビットから 4,096 ビットにアップグレードできます。キーサイズを 4,096 ビットから 1,024 ビットにダウングレードすることは推奨されません。

前提条件

変更を予定している各パラメーターについて、以下の前提条件を満たしてください。

  • 最大メッセージサイズ — 最大メッセージサイズを増やす前に、新しい値がプロデューサーおよびコンシューマークライアントの対応する構成と一致していることを確認してください。

  • SSL 証明書のキーサイズ — インスタンスのキーサイズをアップグレードする前に、まずクライアント証明書のキーサイズをアップグレードしてから、クライアントを再起動してください。詳細については、「SSL 証明書アルゴリズムの更新」をご参照ください。

手順

  1. ApsaraMQ for Kafka コンソール にログオンします。リソースの分布 セクションの 概要 ページで、管理する ApsaraMQ for Kafka インスタンスが存在するリージョンを選択します。

  2. インスタンスリスト ページで、管理するインスタンスの名前をクリックします。

  3. インスタンスの詳細 ページの 設定情報 セクションで、変更するパラメーターの右側にある 編集 をクリックします。

  4. 設定変更リスクの説明 ダイアログボックスでリスクを読み、確認してから OK をクリックします。

結果の確認

変更の進捗を追跡するには、「タスク実行記録の表示」をご参照ください。変更が完了したら、アプリケーションが期待どおりに実行されるか確認してください。