このページは Cloud Translation API によって翻訳されました。

インフラストラクチャメンテナンスイベント

このガイドでは、インフラストラクチャメンテナンスイベントと、それが Cloud Interconnect 接続に与える影響について説明します。

インフラストラクチャメンテナンスイベントとは

インフラストラクチャメンテナンスイベントとは、 Google Cloud が、ネットワーク機器（Cloud Interconnect 用の機器など）のメンテナンスを実施することです。可能な限り通知が提供されるため、ユーザーはインフラストラクチャメンテナンスイベントに対応した計画を立て、ダウンタイムを回避できます。

計画メンテナンス

Google Cloud では、さまざまな種類のメンテナンスイベントが実施されます。メンテナンスイベントの種類による違いは簡素化されているため、各種のメンテナンスイベントは Google Cloud コンソールで同じように表示されます。ほとんどの種類の計画メンテナンスイベントは、ネットワークデバイスが配置されている場所の現地時間の午後 10 時～午前 5 時の間に行われます。たとえば、デバイスが asia-south1 にある場合、計画メンテナンスは通常、インド標準時（UTC+5:30）の午後 10 時～午前 5 時の間に行われます。計画メンテナンスイベントの間隔は決まっていませんが、通常は年に数回実行されます。

計画メンテナンスイベントの一種である物理的な移行は、月曜日～金曜日の午前 9 時～午後 5 時（東部時間）に行われます。

臨時メンテナンス

緊急メンテナンスイベントやスケジュール設定されていないメンテナンスイベントが実行されることもあります。緊急イベントとは、Cloud Interconnect 接続に影響する可能性のある、不定期で計画外のイベントです。ご迷惑をおかけすることになり恐縮ですが、緊急イベントはいつでも警告なく発生する可能性があります。緊急メンテナンスイベントによるネットワーク停止を軽減するために、高可用性のハイブリッドネットワークトポロジを作成することをおすすめします。

計画外のメンテナンスイベントによって影響を受ける合計容量は、イベントの性質によって異なります。Cloud Interconnect 接続の 1 つまたは複数で容量の最大 100% になる可能性があります。

緊急メンテナンス

緊急メンテナンスイベントは計画メンテナンスイベントと似ていますが、14 日未満前にスケジュールされます。また、影響を受ける Cloud Interconnect 接続の合計容量の最大 100% に影響します。

単一のリンクと SLA

単一のエッジアベイラビリティドメインに単一のリンクをプロビジョニングするだけでは、SLA を保証できません。メンテナンス中にサービスにアクセスできなくなることがないように、異なるエッジアベイラビリティドメインに 2 つのリンクをプロビジョニングするようにしてください。詳細については、十分な容量の冗長 Cloud Interconnect 接続を作成するをご覧ください。

イベント通知の受け取り

予定されているメンテナンスイベント、予定外のメンテナンスイベント、緊急のメンテナンスイベントの通知を受け取ります。

計画メンテナンスイベントの通知は、イベントの 14 日前までに Cloud Interconnect オブジェクトの nocContactEmail フィールドにリストされているメールアドレスに送信され、interconnects.get API メソッドで表示されます。詳細については、イベント通知の連絡先の割り当てをご覧ください。

予定外のイベントや緊急イベントが発生した場合は、中断の通知を受け取っても、トラフィックをリダイレクトする時間が十分にない可能性があります。緊急の中断によるトラフィック停止の可能性を低減するためには、ベストプラクティスをご覧ください。

メンテナンスイベントは予定どおりに実行されない場合もあります。メンテナンスイベントのスケジュールが変更またはキャンセルされた場合は、更新されたイベント通知が送信されます。

Partner Interconnect ユーザーの Google Cloud コンソールには、通知は表示されません。

イベント通知の連絡先の割り当て

Cloud Interconnect はプロジェクトオーナーに通知しますが、Essential Contacts API を使用してメンテナンスイベントに関する通知も送信します。プロジェクトに技術担当者を割り当てていない場合、通知は IAM ロールに基づくフォールバックの連絡先に送信されます。

メンテナンスイベントに関する適切な通知を受け取れるようにするため、Cloud Interconnect 接続または VLAN アタッチメントをホストするプロジェクトには、技術担当者の連絡先を少なくとも 1 つ指定してください。

プロジェクトの技術担当者の割り当てについて詳しくは、通知の連絡先の管理をご覧ください。

イベント通知のプロパティ

このセクションは、Dedicated Interconnect、Cross-Cloud Interconnect、Cross-Site Interconnect に適用されます。

計画されたインフラストラクチャメンテナンスイベントの前には、ユーザーに次の通知が送信されます。

影響のあるメンテナンスがスケジュールされると、すべての Cloud Interconnect 接続のプロジェクトオーナーにメールが送信されます。
メールは、Cloud Interconnect オブジェクトの nocContactEmail フィールドに入力されているアドレスに送信されます。このオブジェクトは、 Google Cloud コンソールの Cloud Interconnect の詳細ページで、または次の Google Cloud CLI コマンドを使用して、検索および編集できます。
```
gcloud compute interconnects describe my-interconnect
```
Cloud Interconnect 接続をホストするプロジェクトにリストされている技術担当者にメールが送信されます。

計画外または緊急のインフラストラクチャメンテナンスイベント中は、ユーザーに次の通知が送信されます。

影響のあるメンテナンスがスケジュールされると、すべての Cloud Interconnect 接続のプロジェクトオーナーにメールが送信されます。
メールは、Cloud Interconnect オブジェクトの nocContactEmail フィールドに記載されているアドレスに送信されます。
Cloud Interconnect 接続をホストするプロジェクトにリストされている技術担当者にメールが送信されます。

Partner Interconnect のイベント通知

スケジュール設定されたインフラストラクチャメンテナンスイベントの前には、Partner Interconnect のユーザーに次の通知が送信されます。

VLAN アタッチメントをホストするプロジェクトの技術担当者にメールが送信されます。
VLAN アタッチメントをホストするプロジェクトのすべてのプロジェクトオーナーにメールが送信されます。

サービスの停止ステータス

プロジェクトオーナーと nocContactEmail の連絡先に送信されるイベントメールには、「サービスの停止ステータス」というセクションがあります。サービスの停止ステータスは、以下のいずれかになります。

更新済み: 以前にスケジュールされたメンテナンスイベントが更新または再スケジュールされています。
オーバーラン: 以前にスケジュールされたメンテナンスイベントが進行中で、完了までに予想よりも時間がかかっています。
完了: メンテナンスイベントが完了しています。
キャンセル: 以前にスケジュールされていたメンテナンスイベントがキャンセルされています。
新規: 新しいメンテナンスイベントが実行されています。
変更なし: 以前にスケジュール設定されたメンテナンスイベントが、以前の計画どおりにスケジュールされています。

メンテナンスイベントを表示する

次のオプションのいずれかを選択します。

gcloud

今後の計画メンテナンスイベントなど、接続に関する情報を表示するには、次のコマンドを実行します。

gcloud compute interconnects describe INTERCONNECT_NAME

INTERCONNECT_NAME は、Cloud Interconnect の名前に置き換えます。

出力は次のようになります。expectedOutages を探します。

adminEnabled: true
availableFeatures:
- IF_MACSEC
circuitInfos:
- customerDemarcId: demarc-0
  googleCircuitId: circuit-0
  googleDemarcId: local-demarc-0
creationTimestamp: '2021-12-15T17:02:48.829-08:00'
customerName: Cymbal Group
description: Interconnect connection
expectedOutages:
- description: ''
  endTime: '1705520100000'
  issueType: IT_OUTAGE
  name: pcr-764913
  source: NSRC_GOOGLE
  startTime: '1705501500000'
  state: CANCELLED
- description: ''
  endTime: '1707304200000'
  issueType: IT_OUTAGE
  name: pcr-777490
  source: NSRC_GOOGLE
  startTime: '1707285600000'
  state: COMPLETED
googleIpAddress: 192.0.2.0/24
googleReferenceId: '6006458259035'
id: '249691500371717847'
interconnectType: IT_PRIVATE
kind: compute#interconnect
labelFingerprint: 42WmSpB8rSM=
linkType: LINK_TYPE_ETHERNET_10G_LR
location: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnectLocations/sjc-zone1-6
macsec:
  failOpen: false
  preSharedKeys:
  - name: key-1
    startTime: '2023-08-08T21:09:21.385Z'
macsecEnabled: false
name: cymbal-group-interconnect
nocContactEmail: cloudysanfrancisco@gmail.com
operationalStatus: OS_ACTIVE
peerIpAddress: 192.0.2.0/24
provisionedLinkCount: 1
requestedLinkCount: 1
selfLink: https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME
state: ACTIVE

REST API

今後のメンテナンスイベントなど、接続に関する情報を一覧表示するには、interconnects.get を使用します。

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME

次のように置き換えます。

PROJECT_ID: Cloud Interconnect があるプロジェクト ID
INTERCONNECT_NAME: Cloud Interconnect の名前

出力は次のようになります。

{
"kind": "compute#interconnect",
"description": "Interconnect connection",
"selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/interconnects/INTERCONNECT_NAME",
"id": "249691500371717847",
"creationTimestamp": "2021-12-15T17:02:48.829-08:00",
"name": "INTERCONNECT_NAME",
"location": "https://www.googleapis.com/compute/v1/projects/INTERCONNECT_NAME/global/interconnectLocations/sjc-zone1-6",
"linkType": "LINK_TYPE_ETHERNET_10G_LR",
"requestedLinkCount": 1,
"interconnectType": "IT_PRIVATE",
"adminEnabled": true,
"nocContactEmail": "",
"customerName": "Cymbal Group",
"operationalStatus": "OS_ACTIVE",
"provisionedLinkCount": 1,
"peerIpAddress": "192.0.2.0/24",
"googleIpAddress": "192.0.2.0/24",
"googleReferenceId": "6006458259035",
"expectedOutages": [
  {
    "name": "pcr-764913",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "CANCELLED",
    "issueType": "IT_OUTAGE",
    "startTime": "1705501500000",
    "endTime": "1705520100000"
  },
  {
    "name": "pcr-777490",
    "description": "",
    "source": "NSRC_GOOGLE",
    "state": "COMPLETED",
    "issueType": "IT_OUTAGE",
    "startTime": "1707285600000",
    "endTime": "1707304200000"
  }
],
"circuitInfos": [
  {
    "googleCircuitId": "circuit-0",
    "googleDemarcId": "local-demarc-0",
    "customerDemarcId": "demarc-0"
  }
],
"labelFingerprint": "42WmSpB8rSM=",
"state": "ACTIVE",
"macsec": {
  "preSharedKeys": [
    {
      "name": "key-1",
      "startTime": "2023-08-08T21:09:21.385Z"
    }
  ],
  "failOpen": false
},
"macsecEnabled": false,
"availableFeatures": [
  "IF_MACSEC"
]
}

Unified Maintenance でメンテナンスイベントを表示する

統合メンテナンスを使用すると、Cloud Interconnect インフラストラクチャのメンテナンスイベントを表示できます。また、メンテナンスイベントに関するアラートと通知を送信するように統合メンテナンスを構成することもできます。Partner Interconnect ユーザーの統合メンテナンスには、通知は表示されません。

アラートと通知を構成するの手順に沿って操作しますが、インクルージョンフィルタの作成を求められたら、次のいずれかのフィルタを使用します。

このフィルタには、計画メンテナンス通知のみが含まれます。

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Planned Outage.*"

このフィルタには、緊急メンテナンス通知のみが含まれます。

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Urgent Maintenance.*"

このフィルタには、計画外のメンテナンス通知のみが含まれます。

log_id("maintenance.googleapis.com/maintenance_events") AND jsonPayload.resource.type="compute.googleapis.com/Interconnect" AND jsonPayload.maintenance.title =~ "Unplanned Outage.*"

また、スケジュール済み状態のメンテナンスイベントを表示するには、API を使用してリソースのメンテナンスを表示するをご覧ください。

$ curl \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://maintenance.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/resourceMaintenances?filter=resource.type%3D%22compute.googleapis.com/Interconnect%22%20AND%20state%3D%22SCHEDULED%22"

次のステップ

Cloud Interconnect のベストプラクティスを実施する
通知の連絡先を管理する