翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon OpenSearch Service のオフピークウィンドウの定義
Amazon OpenSearch Service ドメインを作成するときは、オフピークの時間として、毎日 10 時間の時間帯を定義します。OpenSearch Service は、サービスソフトウェアの更新や、[ブルー/グリーンデプロイ](managedomains-configuration-changes.md)を必要とする Auto-Tune の最適化を、トラフィックが比較的少ないこの時間帯に可能な限りスケジュールします。ブルー/グリーンとは、ドメインの更新用に新しい環境を作成し、この更新の完了後にユーザーを新しい環境にルーティングするプロセスを指します。
ブルー/グリーンデプロイは無停止ですが、リソースがブルー/グリーンデプロイに使用されている間の、[パフォーマンスへの潜在的影響](managedomains-configuration-changes.md#initiating-tracking-configuration-changes)を最小限に抑えるため、このようなデプロイは、ドメインに設定されているオフピークウィンドウ中にスケジュールすることが推奨されます。ノードの交換や、ドメインにただちにデプロイすべき更新などでは、オフピークウィンドウは使用しません。
オフピークウィンドウの開始時刻は変更が可能ですが、ウィンドウの所要時間は変更できません。
**注記**
オフピークウィンドウは 2023 年 2 月 16 日に導入されました。この日付以前に作成されたすべてのドメインでは、オフピークウィンドウはデフォルトで無効になっています。これらのドメインでは、オフピークウィンドウを手動で有効にし、設定する必要があります。この日付以後に作成されたすべてのドメインで、オフピークウィンドウはデフォルトで有効になっています。ドメインのオフピークウィンドウは、いったん有効にした後は、無効にできません。
## オフピーク時のサービスソフトウェアの更新
OpenSearch Service のサービスソフトウェア更新には、オプションと必須という 2 つのカテゴリがあります。どちらのカテゴリにもブルー/グリーンデプロイが必要です。オプションの更新はお使いのドメインに強制されることはありませんが、必須の更新は、指定された期限 (通常は提供開始の 2 週間後) までにアクションを実行しないと自動的にインストールされます。詳細については、「[オプションの更新と必須の更新](service-software.md#service-software-optional-required)」を参照してください。
オプションの更新を実行するときは、更新をすぐに適用するか、次回のオフピークウィンドウ時にスケジュールする、またはカスタムの日時を指定して適用するかの、いずれかを選択できます。
![\[Software update dialog with options to apply now, schedule off-peak, or set specific time.\]](http://docs.aws.amazon.com/ja_jp/opensearch-service/latest/developerguide/images/off-peak-sso.png)
必須の更新の場合、OpenSearch Service がオフピークウィンドウ中の日時で更新を自動的にスケジュールします。ユーザーには、スケジュールされた更新の 3 日前に通知が届きます。必須のデプロイの期間内であれば、更新の日時を後の日時に変更することも可能です。手順については、「[アクションのスケジュール変更](#off-peak-reschedule)」を参照してください。
## オフピーク時の Auto-Tune の最適化
これまで、Auto-Tune では、ブルー/グリーンデプロイが必要なスケジュールを変更する場合、[メンテナンスウィンドウ](auto-tune-schedule.md)が使用されていました。オフピークウィンドウが導入される前に、Auto-Tune とメンテナンスウィンドウが有効になっていたドメインでは、オフピークウィンドウを使用するようにドメインを移行しない限り、更新には引き続きメンテナンスウィンドウが使用されます。
当社では、オフピークウィンドウを使用するようにドメインを移行することを推奨しています。サービスソフトウェアの更新など、ドメインの他のアクティビティのスケジュールに使用するためです。手順については、「[Auto-Tune のメンテナンスウィンドウからの移行](#off-peak-migrate)」を参照してください。ドメインをオフピークウィンドウに移行した後は、メンテナンスウィンドウの使用に戻ることはできません。
2023 年 2 月 16 日以降に作成されたすべてのドメインでは、ブルー/グリーンデプロイのスケジュールでは、従来のメンテナンスウィンドウではなくオフピークウィンドウを使用します。ドメインのオフピークウィンドウは無効にできません。ブルー/グリーンデプロイを必要とする Auto-Tune 最適化のリストについては、「[変更のタイプ](auto-tune.md#auto-tune-types)」を参照してください。
## オフピークウィンドウの有効化
2023 年 2 月 16 日 (オフピークウィンドウの導入日) 以前に作成されたドメインでは、この機能はデフォルトで無効になっています。これらのドメインでは、オフピークウィンドウを手動で有効にする必要があります。ドメインのオフピークウィンドウは、有効にした後は無効にできません。
### コンソール
**ドメインのオフピークウィンドウを有効にするには**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) で Amazon OpenSearch Service コンソールを開きます。
1. ドメイン名を選択し、設定を開きます。
1. **[オフピークウィンドウ]** タブに移動し、**[編集]** を選択します。
1. 協定世界時 (UTC) でカスタムの開始時刻を指定します。例えば、開始時刻を米国西部 (オレゴン) リージョンの午後 11 時 30 分に設定するときは、**[07:30]** と指定します。
1. **[Save changes]** (変更の保存) をクリックします。
### CLI
を使用してオフピークウィンドウを変更するには AWS CLI、[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html) リクエストを送信します。
```
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] と指定します。
### コンソール
**ドメインのオフピークウィンドウを変更するには**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) で Amazon OpenSearch Service コンソールを開きます。
1. ドメイン名を選択し、設定を開きます。
1. **[オフピークウィンドウ]** タブに移動します。設定済みのオフピークウィンドウと、今後予定されているドメインのアクション一覧が表示されます。
1. **[編集]** を選択し、新しい開始時刻を UTC で指定します。例えば、開始時刻を米国東部 (バージニア北部) リージョンの午後 9 時に設定するときは、**[02:00 UCT]** と指定します。
1. **[Save changes]** (変更の保存) をクリックします。
### CLI
を使用してカスタムオフピークウィンドウを設定するには AWS CLI、[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html) リクエストを送信し、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 Service コンソールには、ドメイン設定内でスケジュールされているすべてのアクションが、各アクションの重要度や現在のステータスと併せて表示されます。
**ドメインでスケジュールされているアクションを表示するには**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) で Amazon OpenSearch Service コンソールを開きます。
1. ドメイン名を選択し、設定を開きます。
1. **[オフピークウィンドウ]** タブに移動します。
1. **[スケジュールされたアクション]** の下に、ドメインで現在スケジュールされているアクション、進行中のアクション、保留中のアクションがすべて表示されます。
### CLI
を使用してスケジュールされたアクションを表示するには AWS CLI、[ListScheduledActions](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_ListScheduledActions.html) リクエストを送信します。
```
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 Service からユーザーに、サービスソフトウェアの更新と Auto-Tune の最適化がスケジュールされている旨の通知が届きます。スケジュールの変更は、すぐに適用することもできれば、別の日時に変えることもできます。
**注記**
OpenSearch Service では、選択した時刻から 1 時間以内にアクションをスケジュールできます。例えば、更新を午後 5 時に適用する場合、午後 5 時から 6 時の間に適用できます。
### コンソール
**アクションのスケジュールを変更するには**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) で Amazon OpenSearch Service コンソールを開きます。
1. ドメイン名を選択し、設定を開きます。
1. **[オフピークウィンドウ]** タブに移動します。
1. **[スケジュールされたアクション]** の下で、アクションを選択し、**[スケジュール変更]** を選択します。
1. 以下のオプションのいずれかを選択してください。
+ **[今すぐ更新を適用]** - 容量に空きがあれば、アクションを現在の時間で行うよう、すぐにスケジュールします。容量に空きがなければ、別の他の時間帯を選択できます。
+ **[オフピークウィンドウでのスケジュール設定]** - 次回のオフピークウィンドウ中にピックアップするようにアクションにマークします。変更が、次回のウィンドウ中に適用されるという保証はありません。容量によっては翌日になる場合もあります。
+ **[この更新のスケジュールを変更する]** - 変更を適用する日付と時刻をカスタムで指定できます。指定した日時が容量上の理由で利用できない場合は、別の時間帯を選択できます。
+ **[スケジュールされた更新のキャンセル]** - 更新をキャンセルします。このオプションを利用できるのは、オプションのサービスソフトウェア更新のみです。Auto-Tune アクション、または必須のソフトウェア更新には利用できません。
1. **[Save changes]** (変更の保存) をクリックします。
### CLI
を使用してアクションを再スケジュールするには AWS CLI、[UpdateScheduledAction](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateScheduledAction.html) リクエストを送信します。アクション 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 Service が、応答で、利用可能な別の時間帯を提案します。
## Auto-Tune のメンテナンスウィンドウからの移行
ドメインが 2023 年 2 月 16 日以前に作成された場合、ブルー/グリーンデプロイを必要とする Auto-Tune 最適化のスケジュールに、[メンテナンスウィンドウ](auto-tune-schedule.md)を使用できます。既存の Auto-Tune ドメインを移行して、代わりにオフピークウィンドウを使用します。
**注記**
オフピークウィンドウを使用するようにドメインを移行した後は、メンテナンスウィンドウの使用に戻ることはできません。
### コンソール
**オフピークウィンドウを使用するようにドメインを移行するには**
1. Amazon OpenSearch Service コンソールで、ドメインの名前を選択し、設定を開きます。
1. **[Auto-Tune]** タブに進み、**[編集]** を選択します。
1. **[オフピークウィンドウへ移行]** を選択します。
1. **[開始時刻 (UTC)]** に、オフピークウィンドウの開始時刻を協定世界時 (UTC) で入力します。
1. **[Save changes]** (変更の保存) をクリックします。
### CLI
を使用して Auto-Tune メンテナンスウィンドウからオフピークウィンドウに移行するには AWS CLI、[UpdateDomainConfig](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_UpdateDomainConfig.html) リクエストを送信します。
```
aws opensearch update-domain-config \
--domain-name my-domain \
--auto-tune-options DesiredState=ENABLED,UseOffPeakWindow=true,MaintenanceSchedules=[]
```
ドメインを Auto-Tune メンテナンスウィンドウからオフピークウィンドウへ移行するには、オフピークウィンドウをオンにします。オフピークウィンドウは、個別のリクエストで、または同じリクエストで有効にすることができます。手順については、「[オフピークウィンドウの有効化](#off-peak-enable)」を参照してください。