メンテナンスウィンドウの設定

メンテナンスウィンドウに関する考慮事項

• 至急の整備アクティビティ: Atlas は、設定されたメンテナンスウィンドウや保護された時間帯に関係なく、必要に応じて至急の整備アクティビティ（ゼロデイ脆弱性に対するセキュリティパッチなど）を実行することがあります。

• 継続的なメンテナンス操作: クラスターのメンテナンスウィンドウを予定すると、進行中のメンテナンス操作が完了するまで変更できません。

• MongoDB データベースのアップグレード: メンテナンスに MongoDB パッチバージョンのアップグレードが含まれる場合、Atlas は現在のバージョンと対象バージョンをコンソールに表示します。Atlas が次回のメンテナンスウィンドウ中にいずれかのクラスターの MongoDB メンテナンスバージョンをアップグレードする場合、クラスターのカードには対象の MongoDB メンテナンスバージョンが表示されます。

• メンテナンスにはレプリカセットの選挙が必要です: Atlas は MongoDBマニュアル で説明されているメンテナンス手順と同じ方法でメンテナンスを行います。この手順では、レプリカセットごとに、メンテナンスウィンドウ中に少なくとも 1 回のレプリカセット選挙が必要です。テストフェイルオーバー機能を使用して、アプリケーションがレプリカセットの選挙に対して回復力があることを確認します。

• メンテナンスは可能な限りウィンドウの開始時間に近い時間で開始します: メンテナンスは常に可能な限り予定時刻に近い時間に開始されますが、進行中のクラスター更新や予期しないシステム問題により、開始時間が遅れる可能性があります。

• メンテナンス中の一時的なパフォーマンス低下の可能性: ディスク IOPS が低い場合、MongoDB が WiredTiger ストレージエンジンを再構築する間、クラスターのパフォーマンスがメンテナンス中一時的に低下する可能性があります。詳しくは、「ジャーナリングと WiredTiger ストレージエンジン」をご覧ください

• 保護された時間帯: メンテナンスウィンドウの構成に加えて、毎日保護された時間帯を設定することもできます。これは、Atlas が実行する標準の更新を回避するための時間帯です。Atlas はメンテナンスウィンドウ中にメンテナンスを自動的に実行します。

  ただし、Atlas はメンテナンスウィンドウ外で、クラスターの再起動やワークロードパフォーマンスに影響を及ぼさない標準的な更新を実行する場合があります。保護された時間を有効にすると、Atlas は保護された時間枠外で標準更新を実行します。保護された時間帯は18時間を超えることはできません。

必要なアクセス権

メンテナンスWindowsを管理するには、プロジェクトに対するOrganization OwnerまたはProject Ownerアクセス権が必要です。

手順

atlas maintenanceWindows describe [options]

atlas maintenanceWindows update [options]

atlas maintenanceWindows clear [options]

必要なメンテナンスに応答する

メンテナンスが必要な場合:

• 予定されているメンテナンスの48～72時間前（2～3日前）に、Atlasはプロジェクトのクラスターリストに、メンテナンスが予定されている日時を示すバナーを表示します。Show Detailsをクリックすると、MongoDBのバージョン更新、OSポリシーの更新、その他のメンテナンスの種類など、予定されているメンテナンス操作が表示されます。

• Atlas は Project Owner ロールを持つユーザーにメールを送信し、Atlas UI を更新して、メンテナンスを即時開始するか1週間繰延するかのオプションを表示します。

  注意

  スケジュールされたメンテナンスウィンドウ通知の受信方法を構成するには、「メンテナンスウィンドウ アラートの構成 」を参照してください。

atlas maintenanceWindows update [options]

# Trigger immediate maintenance for the project with the ID
# 5e2211c17a3e5a48f5497de3:
atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json

curl --header "Authorization: Bearer {ACCESS-TOKEN}" \
  --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
    }'

atlas maintenanceWindows defer [options]