オフピーク時のサービスソフトウェアの更新オフピーク時の Auto-Tune の最適化オフピークウィンドウの有効化カスタムのオフピークウィンドウの設定スケジュール済みのアクションを表示するアクションのスケジュール変更 Auto-Tune のメンテナンスウィンドウからの移行

Amazon OpenSearch Service のオフピークウィンドウの定義

Amazon OpenSearch Service ドメインを作成するときは、オフピーク時間と見なされる毎日の 10 時間ウィンドウを定義します。 OpenSearch このウィンドウを使用して、可能な限りトラフィック時間を比較的短くしながら、サービスソフトウェアの更新とブルー/グリーンデプロイを必要とする Auto-Tune 最適化をスケジュールします。ブルー/グリーンとは、ドメインの更新用に新しい環境を作成し、この更新の完了後にユーザーを新しい環境にルーティングするプロセスを指します。

ブルー/グリーンデプロイは無停止ですが、リソースがブルー/グリーンデプロイに使用されている間の、パフォーマンスへの潜在的影響を最小限に抑えるため、このようなデプロイは、ドメインに設定されているオフピークウィンドウ中にスケジュールすることが推奨されます。ノードの交換や、ドメインにただちにデプロイすべき更新などでは、オフピークウィンドウは使用しません。

オフピークウィンドウの開始時刻は変更が可能ですが、ウィンドウの所要時間は変更できません。

注記

オフピークウィンドウは 2023 年 2 月 16 日に導入されました。この日付以前に作成されたすべてのドメインでは、オフピークウィンドウはデフォルトで無効になっています。これらのドメインでは、オフピークウィンドウを手動で有効にし、設定する必要があります。この日付以後に作成されたすべてのドメインで、オフピークウィンドウはデフォルトで有効になっています。ドメインのオフピークウィンドウは、いったん有効にした後は、無効にできません。

オフピーク時のサービスソフトウェアの更新

OpenSearch サービスには、オプションと必須のという 2 つのカテゴリのサービスソフトウェア更新があります。どちらのカテゴリにもブルー/グリーンデプロイが必要です。オプションの更新はお使いのドメインに強制されることはありませんが、必須の更新は、指定された期限 (通常は提供開始の 2 週間後) までにアクションを実行しないと自動的にインストールされます。詳細については、「オプションの更新と必須の更新」を参照してください。

オプションの更新を実行するときは、更新をすぐに適用するか、次回のオフピークウィンドウ時にスケジュールする、またはカスタムの日時を指定して適用するかの、いずれかを選択できます。

必要な更新については、 OpenSearch サービスは自動的にオフピークの時間帯に更新を実行する日付と時刻をスケジュールします。ユーザーには、スケジュールされた更新の 3 日前に通知が届きます。必須のデプロイの期間内であれば、更新の日時を後の日時に変更することも可能です。手順については、「アクションのスケジュール変更」を参照してください。

オフピーク時の Auto-Tune の最適化

これまで、Auto-Tune では、ブルー/グリーンデプロイが必要なスケジュールを変更する場合、メンテナンスウィンドウが使用されていました。オフピークウィンドウが導入される前に、Auto-Tune とメンテナンスウィンドウが有効になっていたドメインでは、オフピークウィンドウを使用するようにドメインを移行しない限り、更新には引き続きメンテナンスウィンドウが使用されます。

当社では、オフピークウィンドウを使用するようにドメインを移行することを推奨しています。サービスソフトウェアの更新など、ドメインの他のアクティビティのスケジュールに使用するためです。手順については、「Auto-Tune のメンテナンスウィンドウからの移行」を参照してください。ドメインをオフピークウィンドウに移行した後は、メンテナンスウィンドウの使用に戻ることはできません。

2023 年 2 月 16 日以降に作成されたすべてのドメインでは、ブルー/グリーンデプロイのスケジュールでは、従来のメンテナンスウィンドウではなくオフピークウィンドウを使用します。ドメインのオフピークウィンドウは無効にできません。ブルー/グリーンデプロイを必要とする Auto-Tune 最適化のリストについては、「変更のタイプ」を参照してください。

オフピークウィンドウの有効化

2023 年 2 月 16 日 (オフピークウィンドウの導入日) 以前に作成されたドメインでは、この機能はデフォルトで無効になっています。これらのドメインでは、オフピークウィンドウを手動で有効にする必要があります。ドメインのオフピークウィンドウは、有効にした後は無効にできません。

ドメインのオフピークウィンドウを有効にするには

https://console.aws.amazon.com/aos/home で Amazon OpenSearch Service コンソールを開きます。
ドメイン名を選択し、設定を開きます。
[オフピークウィンドウ] タブに移動し、[編集] を選択します。
協定世界時 (UTC) でカスタムの開始時刻を指定します。例えば、開始時刻を米国西部 (オレゴン) リージョンの午後 11 時 30 分に設定するときは、[07:30] と指定します。
[変更の保存] をクリックします。

を使用してオフピークウィンドウを変更するにはAWS CLI、 UpdateDomainConfigリクエストを送信します。


aws opensearch update-domain-config \
  --domain-name my-domain \
  --off-peak-window-options 'Enabled=true, OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'

カスタムのウィンドウ開始時刻を指定しない場合、00:00 UTC がデフォルトの時刻となります。

カスタムのオフピークウィンドウの設定

ドメインのカスタムオフピークウィンドウを協定世界時 (UTC) で指定します。例えば、オフピークウィンドウを米国東部 (バージニア北部) リージョンのドメインで午後 11 時に開始するときは、[04:00 UTC] と指定します。

ドメインのオフピークウィンドウを変更するには

https://console.aws.amazon.com/aos/home で Amazon OpenSearch Service コンソールを開きます。
ドメイン名を選択し、設定を開きます。
[オフピークウィンドウ] タブに移動します。設定済みのオフピークウィンドウと、今後予定されているドメインのアクション一覧が表示されます。
[編集] を選択し、新しい開始時刻を UTC で指定します。例えば、開始時刻を米国東部 (バージニア北部) リージョンの午後 9 時に設定するときは、[02:00 UCT] と指定します。
[変更の保存] をクリックします。

を使用してカスタムのオフピークウィンドウを設定するにはAWS CLI、 UpdateDomainConfigリクエストを送信し、24 時間形式の時と分を指定します。

例えば、次のリクエストを送信すると、ウィンドウの開始時刻が UTC の午前 2 時に変更されます。


aws opensearch update-domain-config \
  --domain-name my-domain \
  --off-peak-window-options 'OffPeakWindow={WindowStartTime={Hours=02,Minutes=00}}'

ウィンドウの開始時刻を指定しなかった場合、ドメインが作成された AWS リージョンの現地時間午後 10 時がデフォルトで開始時刻となります。

スケジュール済みのアクションを表示する

各ドメインの現在スケジュール済みのアクション、進行中のアクション、保留中のアクションは、すべて表示できます。アクションには、HIGH、MEDIUM、LOW の重要度のレベルがあります。

アクションのステータスは次の通りです。

Pending update — アクションはキューに入って処理待ちです。
In progress — アクションは進行中です。
Failed - アクションの実行に失敗しました。
Completed – アクションは正常に完了しました。
Not eligible — サービスソフトウェアの更新のみです。クラスターが異常な状態であるため、更新を続行できません。
Eligible — サービスソフトウェアの更新のみです。このドメインは更新の対象になっています。

OpenSearch サービスコンソールには、ドメイン設定内のすべてのスケジュールされたアクションが、各アクションの重要度と現在のステータスとともに表示されます。

ドメインでスケジュールされているアクションを表示するには

https://console.aws.amazon.com/aos/home で Amazon OpenSearch Service コンソールを開きます。
ドメイン名を選択し、設定を開きます。
[オフピークウィンドウ] タブに移動します。
[スケジュールされたアクション] の下に、ドメインで現在スケジュールされているアクション、進行中のアクション、保留中のアクションがすべて表示されます。

を使用してスケジュールされたアクションを表示するにはAWS CLI、 ListScheduledActionsリクエストを送信します。


aws opensearch list-scheduled-actions \
  --domain-name my-domain

レスポンス：


{
    "ScheduledActions": [
        {
            "Cancellable": true,
            "Description": "The Deployment type is : BLUE_GREEN.",
            "ID": "R20220721-P13",
            "Mandatory": false,
            "Severity": "HIGH",
            "ScheduledBy": "CUSTOMER",
            "ScheduledTime": 1.673871601E9,
            "Status": "PENDING_UPDATE",
            "Type": "SERVICE_SOFTWARE_UPDATE",
        },
        {
            "Cancellable": true,
            "Description": "Amazon Opensearch will adjust the young generation JVM arguments on your domain to improve performance",
            "ID": "Auto-Tune",
            "Mandatory": true,
            "Severity": "MEDIUM",
            "ScheduledBy": "SYSTEM",
            "ScheduledTime": 1.673871601E9,
            "Status": "PENDING_UPDATE",
            "Type": "JVM_HEAP_SIZE_TUNING",
        }
    ]
}

アクションのスケジュール変更

OpenSearch サービスは、スケジュールされたサービスソフトウェアの更新と Auto-Tune 最適化を通知します。スケジュールの変更は、すぐに適用することもできれば、別の日時に変えることもできます。

注記

OpenSearch サービスは、選択した時刻から 1 時間以内にアクションをスケジュールできます。例えば、更新を午後 5 時に適用する場合、午後 5 時から 6 時の間に適用できます。

アクションのスケジュールを変更するには

https://console.aws.amazon.com/aos/home で Amazon OpenSearch Service コンソールを開きます。
ドメイン名を選択し、設定を開きます。
[オフピークウィンドウ] タブに移動します。
[スケジュールされたアクション] の下で、アクションを選択し、[スケジュール変更] を選択します。
以下のオプションのいずれかを選択します。
- [今すぐ更新を適用] - 容量に空きがあれば、アクションを現在の時間で行うよう、すぐにスケジュールします。容量に空きがなければ、別の他の時間帯を選択できます。
- [オフピークウィンドウでのスケジュール設定] - 次回のオフピークウィンドウ中にピックアップするようにアクションにマークします。変更が、次回のウィンドウ中に適用されるという保証はありません。容量によっては翌日になる場合もあります。
- [この更新のスケジュールを変更する] - 変更を適用する日付と時刻をカスタムで指定できます。指定した日時が容量上の理由で利用できない場合は、別の時間帯を選択できます。
- [スケジュールされた更新のキャンセル] - 更新をキャンセルします。このオプションを利用できるのは、オプションのサービスソフトウェア更新のみです。Auto-Tune アクション、または必須のソフトウェア更新には利用できません。
[変更の保存] をクリックします。

を使用してアクションのスケジュールを変更するにはAWS CLI、 UpdateScheduledActionリクエストを送信します。アクション ID を取得するには、ListScheduledActions リクエストを送信します。

次のリクエストを送信すると、サービスソフトウェアの更新が特定の日時にスケジュール変更されます。


aws opensearch update-scheduled-action \
  --domain-name my-domain \
  --action-id R20220721-P13 \
  --action-type "SERVICE_SOFTWARE_UPDATE" \
  --desired-start-time 1677348395000 \
  --schedule-at TIMESTAMP

レスポンス：


{
   "ScheduledAction": { 
      "Cancellable": true,
      "Description": "Cluster status is updated.",
      "Id": "R20220721-P13",
      "Mandatory": false,
      "ScheduledBy": "CUSTOMER",
      "ScheduledTime": 1677348395000,
      "Severity": "HIGH",
      "Status": "PENDING_UPDATE",
      "Type": "SERVICE_SOFTWARE_UPDATE"
   }
}

リクエストが SlotNotAvailableException により失敗した場合は、指定した日時が容量上の理由で利用できないことを意味し、別の日時を指定する必要があります。 OpenSearch サービスは、レスポンスで利用可能な代替スロット候補を提供します。

Auto-Tune のメンテナンスウィンドウからの移行

ドメインが 2023 年 2 月 16 日以前に作成された場合、ブルー/グリーンデプロイを必要とする Auto-Tune 最適化のスケジュールに、メンテナンスウィンドウを使用できます。既存の Auto-Tune ドメインを移行して、代わりにオフピークウィンドウを使用します。

注記

オフピークウィンドウを使用するようにドメインを移行した後は、メンテナンスウィンドウの使用に戻ることはできません。

オフピークウィンドウを使用するようにドメインを移行するには

Amazon OpenSearch Service コンソールで、ドメインの名前を選択して設定を開きます。
[Auto-Tune] タブに進み、[編集] を選択します。
[オフピークウィンドウへ移行] を選択します。
[開始時刻 (UTC)] に、オフピークウィンドウの開始時刻を協定世界時 (UTC) で入力します。
[変更の保存] をクリックします。

を使用して Auto-Tune メンテナンスウィンドウからオフピークウィンドウに移行するにはAWS CLI、 UpdateDomainConfigリクエストを送信します。


aws opensearch update-domain-config \
  --domain-name my-domain \
  --auto-tune-options DesiredState=ENABLED,UseOffPeakWindow=true,MaintenanceSchedules=[]

ドメインを Auto-Tune メンテナンスウィンドウからオフピークウィンドウへ移行するには、オフピークウィンドウをオンにします。オフピークウィンドウは、個別のリクエストで、または同じリクエストで有効にすることができます。手順については、「オフピークウィンドウの有効化」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

サービスソフトウェア更新

通知