Atlas がクラスターの週次メンテナンスを開始する時刻を設定できます。この設定は任意であり、ほとんどのクラスターには必要ありません。 プロジェクト設定からメンテナンス ウィンドウを構成します。
通常、メンテナンス ウィンドウを手動で構成する必要はありません。Atlas は、回復力のあるアプリケーションの継続的な可用性を維持するために、ローリング方式で自動的にメンテナンスを実行します。テスト フェイルオーバー機能を使用して、アプリケーションがレプリカ セットの選挙に対して回復力があることを確認できます。
メンテナンスウィンドウを設定すると、レプリカセットの選挙が必要なメンテナンスを希望する時間帯に実施し、その他の標準的な更新をビジネスクリティカルな時間外に行うことで、メンテナンスのタイミングをより細かく制御できます。
メンテナンスウィンドウに関する考慮事項
至急の整備アクティビティ
Atlas は、設定されたメンテナンス ウィンドウや保護された時間に関係なく、必要性が生じた直後に至急のメンテナンス アクティビティ（ゼロデイ脆弱性に対するセキュリティパッチなど）を実施することがあります。
継続的なメンテナンス操作
クラスターのメンテナンスウィンドウは、一度スケジュールすると、進行中のメンテナンス操作が完了するまで変更できません。
MongoDB database のアップグレード
メンテナンスに MongoDB のパッチ バージョン アップグレードが含まれる場合、Atlas は現在のバージョンとターゲット バージョンをコンソールに表示します。
メンテナンスにはレプリカセットの選択が必要
Atlas は、 MongoDB マニュアルに記載されているメンテナンス手順と同じ方法でメンテナンスを行います。この手順では、レプリカ セットごとに、メンテナンスウィンドウ中に少なくとも 1 回のレプリカセット選挙が必要です。
フェイルオーバーのテスト機能を使用して、アプリケーションがレプリカセットの選挙に対して回復力があることを確認します。
メンテナンスは可能な限りウィンドウの開始に近い時間に開始される
メンテナンスは常に可能な限り予定時刻に近い時間に開始されますが、進行中のクラスター アップデートや予期しないシステム問題により、開始時間が遅れる可能性があります。
メンテナンス中に短時間のパフォーマンス低下が発生する可能性
ディスク IOPSが低い場合、MongoDB が WiredTiger ストレージ エンジンに再入力している間、クラスターのメンテナンス中に短時間のパフォーマンスが低下する可能性があります。 詳しくは、「 ジャーナリングと WiredTiger ストレージ エンジン」を参照してください。
メンテナンスの完了を追跡する
メンテナンス操作が完了すると、プロジェクト アクティビティフィードに Maintenance window completedイベントが表示されます。
保護時間に関する考慮事項
メンテナンス ウィンドウの構成に加えて、日次の保護された時間を設定することもできます。この時間では、Atlas が標準更新を回避します。
メンテナンスと標準更新
Atlas はメンテナンス ウィンドウ中にメンテナンスを自動的に実行します。ただし、Atlas はメンテナンス ウィンドウ外で、クラスターの再起動やワークロードのパフォーマンスへの影響を伴わない標準的な更新を実行する場合があります。保護された時間を有効にすると、Atlas は保護された時間のウィンドウ外で標準更新を実行します。
保護時間の範囲
保護時間枠の長さは 18 時間を超えることはできません。
必要なアクセス権
メンテナンスWindowsを管理するには、プロジェクトに対するOrganization OwnerまたはProject Ownerアクセス権が必要です。
手順
プロジェクト設定を開きます
Atlas で、 Project Settings ページに移動します。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
サイドバーで、Project Settings をクリックします。
[ Project Settings ]ページが表示されます。
メンテナンスウィンドウの表示と設定
Atlas UI を使用してメンテナンスウィンドウを表示および設定するには、次の手順に従います。
メンテナンスウィンドウの設定を表示するには、[Set Maintenance Window] ボタンをクリックします。
Atlas がプロジェクトのメンテナンスを開始する日時を設定します。
Atlasがスケジュールされたメンテナンスを 1 週間自動的に延期する場合は、Automatically defer maintenance for one week をクリックします。
Atlas が標準更新を回避する保護時間の範囲を設定するには、Turn on protected hours 設定を On に切り替えます。1 日に最大 18 時間の時間範囲を設定できます。
変更を保持するにはSaveをクリックし、変更を破棄するにはCancelをクリックします。
Atlas CLI を使用してメンテナンスウィンドウの詳細を返すには、次のコマンドを実行します。
atlas maintenanceWindows describe [options]
Atlas CLI を使用してメンテナンスウィンドウを更新するには、次のコマンドを実行します。
atlas maintenanceWindows update [options]
前のコマンドの構文とパラメーターの詳細については、Atlas CLIドキュメントの「AtlasメンテナンスWindows の説明」および「メンテナンスAtlasWindows Update」を参照してください。
メンテナンスウィンドウの構成設定のクリア
希望するメンテナンスウィンドウの開始時間を構成した場合は、Atlas CLI または Atlas UI を使用して 設定をクリアできます。 メンテナンスウィンドウの構成をクリアすると、デフォルトのメンテナンスウィンドウ設定が復元されます。
Atlas UI を使用して構成されたメンテナンスウィンドウをクリアするには、 Set Maintenance Windowの設定をOffに切り替えます。
Atlas CLI を使用して構成されたメンテナンスウィンドウをクリアするには、次のコマンドを実行します。
atlas maintenanceWindows clear [options]
コマンド構文とパラメーターの詳細については、Atlas CLI AtlasmaintenanceWindows clear の ドキュメントを参照してください。
必要なメンテナンスに応答する
メンテナンスが必要な場合:
Atlas は、プロジェクトのクラスター リストに、メンテナンスがスケジュールされている日時を示すバナーを表示します。
スケジュールされたメンテナンスの 48 時間から 72 時間前まで、Atlas は
Project Ownerロールを持つユーザーにメールを送信し、Atlas UI を更新して、メンテナンスをすぐに開始するか、メンテナンスを 1 週間延期するオプションを表示します。注意
スケジュールされたメンテナンスウィンドウ通知の受信方法を構成するには、「メンテナンスウィンドウ アラートの構成 」を参照してください。
今すぐメンテナンスを開始
メンテナンスをすぐに開始するには:
バナーをクリックします。Scheduled Maintenance Operations というタイトルのモーダルウィンドウが表示されます。このウィンドウでは、現在スケジュールされている メンテナンス操作の内容について説明します。
[0]Begin Now ボタンをクリックします。Start Cluster Maintenance Now モーダルで、Yes, start my maintenance now. をクリックして確認します
Atlas CLI を使用してメンテナンスウィンドウを更新するには、次のコマンドを実行します。
atlas maintenanceWindows update [options]
コマンド構文とパラメーターの詳細については、Atlas CLI ドキュメントの atlasメンテナンスウィンドウの更新 を参照してください。
重要: メンテナンスをすぐにトリガーするには、--startASAP オプションを渡します。
# Trigger immediate maintenance for the project with the ID # 5e2211c17a3e5a48f5497de3: atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
Atlas は、1 つのプロジェクトのエンドポイントとなる接続されたデバイスの 1 つのメンテナンスウィンドウの更新を提供します。startASAP フィールドに true の値を持つを渡すことで、任意でメンテナンスをすぐにトリガーできます。
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \ --digest --include \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --header "Content-Type: application/json" \ -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \ --data ' { "startASAP": true }'
メンテナンスを延期
定期メンテナンスを延期するには、以下を行います。
バナーをクリックします。Scheduled Maintenance Operations というタイトルのモーダルウィンドウが表示されます。このウィンドウでは、現在スケジュールされている メンテナンス操作の内容について説明します。
[0]Defer 1 Week ボタンをクリックします。Defer Maintenance to Next Week モーダルで、Yes, defer maintenance until next week. をクリックして確認します
Atlas CLI を使用してメンテナンスウィンドウを延期するには、次のコマンドを実行します。
atlas maintenanceWindows defer [options]
コマンド構文とパラメーターの詳細については、 Atlas CLIドキュメントのAtlasメンテナンスウィンドウのデフォルトを参照してください。
Atlas は、1 つのプロジェクトの 1 つのメンテナンスウィンドウを延期するエンドポイントとなる接続されたデバイスを提供します。
注意
1 つのプロジェクトのメンテナンス イベントは最大 2 回まで延期できます。
メンテナンスWindows中のメンテナンス バージョンのアップグレード
Atlas が次回のメンテナンスウィンドウ中にいずれかのクラスターの MongoDB メンテナンス バージョンをアップグレードする場合、クラスターの カードには対象の MongoDB メンテナンス バージョンが表示されます。