SAP HANA を実行する X4 インスタンスのホスト メンテナンス イベントを管理する

このドキュメントでは、SAP HANA ワークロードを実行する Compute Engine X4 インスタンスの計画されたホスト メンテナンス イベントを管理してモニタリングする方法について説明します。

X4 は、数テラバイトの SAP HANA ワークロードを実行するように設計された、Compute Engine ベアメタル マシンタイプの特殊なシリーズです。定期的なソフトウェアとファームウェアの更新には X4 のメンテナンスが必要です。このメンテナンスにより、X4 インスタンスのパフォーマンスが最適化され、安全性、信頼性が高まります。

他の Compute Engine マシンタイプとは異なり、X4 はメンテナンス イベント中のライブ マイグレーション プロセスをサポートしていません。つまり、計画されたホスト メンテナンス イベントでは、Google が X4 インスタンスを停止して更新する必要があるため、これらのイベントが SAP HANA ワークロードにとって重要なものになります。

メンテナンスのライフサイクル

計画されたホスト メンテナンス イベントは、60 日前に届く通知で始まります。この時間枠内で、ホスト メンテナンス イベントをトリガーできます。ホスト メンテナンス イベントを計画された開始日時より前にトリガーしなかった場合、Google は計画された開始日時またはその数分以内に自動的にトリガーします。

計画されたホスト メンテナンス イベントは通常 4 時間以内に完了します。この間、ホストで実行中のインスタンスは停止して再起動されます。

X4 インスタンスの計画されたホスト メンテナンス イベントのおおよその頻度は 90 日以上です。つまり、1 回の定期メンテナンスが完了した後、次の定期メンテナンス イベントは少なくとも 90 日後に発生します。ただし、根本的な問題の重大度によっては、定期メンテナンス以外のメンテナンスが行われることがあります。

以降のセクションでは、計画されたホスト メンテナンス イベントがトリガーされる 2 つの方法（手動と自動）について説明します。

ユーザーが手動でトリガーしたメンテナンス イベント

次の手順は、計画されたホスト メンテナンス イベントをトリガーするシナリオで発生するアクションの例を示しています。

  1. 0 日目に、X4 インスタンスをデプロイします。

  2. 36 日目に、ホストのメンテナンス イベントの予定に関する通知が Google から届きます。

    gcloud compute instances describe コマンドを使用して X4 インスタンスの説明を検索すると、レスポンスに "maintenanceStatus": "PENDING" が表示されます。

    36 日目から 96 日目（60 日前の通知期間）の間に、ホスト メンテナンス イベントをトリガーできます。

  3. 80 日目に、X4 インスタンスのホスト メンテナンス イベントをトリガーします。たとえば、gcloud compute instances perform-maintenance コマンドを実行します。

    Google はメンテナンスのために X4 インスタンスをシャットダウンします。メンテナンス期間は通常 4 時間です。

    gcloud compute instances describe コマンドを使用して、インスタンスの maintenanceStatus フィールドが ONGOING に設定されていることを確認できます。

  4. メンテナンス アクティビティが完了すると、X4 インスタンスが再起動されます。

次のホスト メンテナンス イベントに関する通知を受け取ることができるのは、このメンテナンス イベントの完了から 30 日以上経過した後です。この例では、120 日目に予定されているホスト メンテナンス イベントに関する通知が送信されます。

次の図は、上記のステップを示しています。

お客様がトリガーした計画されたホスト メンテナンス イベントでのアクションの順序を示す図

Google によって自動的にトリガーされるメンテナンス イベント

次の手順は、Google が計画されたホスト メンテナンス イベントをトリガーするシナリオで発生する一連のアクションの例を示しています。お客様がイベントの通知日からイベントの予定開始日までの 60 日前の通知期間中にイベントをトリガーしなかった場合にのみ、Google はイベントの予定開始日にホスト メンテナンス イベントをトリガーします。

  1. 0 日目に、X4 インスタンスをデプロイします。

  2. 45 日目に、ホストのメンテナンス イベントの予定に関する通知が Google から届きます。

    gcloud compute instances describe コマンドを使用して X4 インスタンスの説明を検索すると、レスポンスに "maintenanceStatus": "PENDING" が表示されます。

  3. ホスト メンテナンス イベントの予定開始日である 105 日目に、Google はホスト メンテナンス イベントをトリガーします。通常、メンテナンスは予定された開始時間またはその数分以内に開始されます。

    gcloud compute instances describe コマンドを使用して X4 インスタンスの説明を検索すると、レスポンスに "maintenanceStatus": "ONGOING" が表示されます。

  4. Google はメンテナンスのために X4 インスタンスをシャットダウンします。通常、メンテナンスの時間枠は 4 時間です。

  5. メンテナンス アクティビティが正常に完了すると、X4 インスタンスが再起動されます。

次のホスト メンテナンス イベントに関する通知を受け取ることができるのは、このメンテナンス イベントの完了から 30 日以上経過した後です。この例では、150 日目に予定されているホスト メンテナンス イベントに関する通知が送信されます。

次の図は、上記のステップを示しています。

Google がトリガーする計画されたホスト メンテナンス イベントでのアクションの順序を示す図

メンテナンス イベントに関する情報を表示する

計画されたホスト メンテナンス イベントごとに、60 日前に通知が送信されます。X4 の計画的なホスト メンテナンス イベントはすべて、スケジュールされたメンテナンスとして分類されます。

計画されたホスト メンテナンス イベントに関する情報を表示するには、次の操作を行います。

  • Google Cloud CLI を使用して X4 インスタンスにクエリを実行する
  • REST API を使用して X4 インスタンスにクエリを実行する
  • X4 インスタンスのメタデータ サーバーにクエリを実行する
  • Cloud Logging でログを確認する

必要な IAM ロールと権限など、これらのアクションを実行する方法については、ホスト メンテナンス イベントのモニタリングと計画をご覧ください。

これらのオプションを使用する場合は、machineType メタデータ フィールドを使用して X4 インスタンスをフィルタできます。このフィールドは、インスタンスのマシンタイプを表します。次の例に、X4 インスタンスに関する情報がログ エクスプローラでどのように表示されるかを示します。

metadata: {
  canReschedule: true
  latestWindowStartTime: "2025-07-21T00:00:01Z"
  machineType: "x4-megamem-1920-metal"
  maintenanceStatus: "PENDING"
  type: "SCHEDULED"
  windowEndTime: "2025-07-21T04:00:00Z"
  windowStartTime: "2025-07-21T00:00:00Z"
}
methodName: "compute.instances.upcomingMaintenance"

メンテナンス イベントをシミュレートする

計画されたホスト メンテナンス イベントのエンドツーエンド プロセスをモニタリングしたり、実装したインテグレーションや自動化をテストしたりするには、gcloud CLI または REST API を使用して X4 インスタンスのホスト メンテナンス イベントをシミュレートします。

X4 インスタンスでホスト メンテナンス イベントをシミュレートしようとすると、X4 インスタンスの onHostMaintenance プロパティが TERMINATE の値に固定されているため、インスタンスが終了して再起動されました。詳細については、使用可能なホストメンテナンス プロパティをご覧ください。

計画メンテナンス イベントをシミュレートする方法については、終了するコンピューティング インスタンスのホスト メンテナンンスをシミュレートするをご覧ください。

メンテナンス イベントをトリガーする

60 日前の通知期間が終了する前に、いつでも計画されたホスト メンテナンス イベントをトリガーできます。これを行うには、gcloud CLI または REST API を使用します。

ホスト メンテナンス イベントをトリガーするには、Compute Engine インスタンスを停止および起動する gcloud CLI または REST API リソースを使用しないでください。

計画されたホスト メンテナンス イベントをトリガーする方法や、そのステータスを確認する方法については、ホスト メンテナンス イベントを手動で開始するをご覧ください。

メンテナンス イベントが適用されなくなった

まれに、計画外のメンテナンスで X4 インスタンスに影響する問題が発生することがあります。その場合、Google Cloud はインスタンスを正常な別のホストに自動的に移行します。同様に、60 日前の通知期間中に X4 インスタンスを手動で停止して起動すると、インスタンスは使用可能なホストにプロビジョニングされます。

Google Cloud は、最新の X4 マシンのフリートを確保することを目的としています。X4 インスタンスの新しいホストで最新のファームウェアが実行されている場合、以前にスケジュールされたホスト メンテナンス イベントは X4 インスタンスに適用されなくなります。この場合、ホスト メンテナンス イベントは自動的に解決されるため、SAP HANA ワークロードのダウンタイムが短くなる可能性があります。

メンテナンス イベントの完了を確認する

Compute Engine X4 インスタンスの予定されたホスト メンテナンス イベントが正常に完了したことを確認するには、次の操作を行います。

  • gcloud CLI または REST API を使用してインスタンスにクエリを実行します。レスポンスに upcomingMaintenance フィールドは含まれません。

    インスタンスのクエリ方法については、インスタンスでメンテナンス イベント通知を確認するをご覧ください。

  • Cloud Logging で、インスタンスのログを確認します。次のようなログメッセージが表示されます。

    Maintenance window is completed for this instance. All maintenance notifications on the instance has been removed.

    インスタンスのログを検索する方法については、Cloud Logging でメンテナンス イベント通知を確認するをご覧ください。

メンテナンス イベントをモニタリングする

Compute Engine X4 インスタンスの計画されたホスト メンテナンス イベントのモニタリングを設定すると、進行中のメンテナンス イベントのステータスや今後のメンテナンス イベントに関する情報をチームと共有できるようになります。

ホスト メンテナンス イベントは、次のようにモニタリングできます。

  • 各メンテナンス イベントは Cloud Logging に複数のメッセージを送信するため、ログベースのアラート ポリシーを設定して、特定のメンテナンス イベント通知を検索し、通知チャンネルを使用してアラートを送信できます。

    ログをフィルタするには、machineType メタデータ フィールドを使用します。このフィールドは、X4 インスタンスに対応するマシンタイプ（x4-megamem-960-metal、x4-megamem-1440-metal、x4-megamem-1920-metal など）を表します。

    計画されたホスト メンテナンス イベントのアラートを構成する方法については、ホスト メンテナンス通知のアラートを構成するをご覧ください。

  • maintenance-system-events.json テンプレートをインポートして、 Google Cloud プロジェクトにモニタリング ダッシュボードを作成します。このダッシュボードのテンプレートは、GitHub リポジトリ GoogleCloudPlatform/sapagent で入手できます。

    JSON ファイルをアップロードしてモニタリング ダッシュボードを作成する方法については、ダッシュボード テンプレートをインストールするをご覧ください。