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

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

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

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

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

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

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

• メンテナンス中に短時間パフォーマンスが低下する可能性: Disk 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はプロジェクトのクラスター リストに、メンテナンスがスケジュールされた日時を示すバナーを表示します。 MongoDB のバージョン更新、OS ポリシーの更新、またはその他のメンテナンス タイプなど、スケジュールされたメンテナンス操作を確認するには、Show Detailsをクリックします。

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

  注意

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

atlas maintenanceWindows update [options]

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

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
    }'

atlas maintenanceWindows defer [options]