Peristiwa pemeliharaan infrastruktur

Panduan ini menjelaskan peristiwa pemeliharaan infrastruktur dan pengaruhnya terhadap koneksi Cloud Interconnect.

Yang dimaksud dengan peristiwa pemeliharaan infrastruktur

Peristiwa pemeliharaan infrastruktur adalah waktu saat Google Cloud melakukan pemeliharaan pada peralatan jaringan, termasuk peralatan untuk Cloud Interconnect. Jika memungkinkan, kami akan memberikan notifikasi agar Anda dapat merencanakan peristiwa pemeliharaan infrastruktur dan mencegah periode nonaktif.

Pemeliharaan terencana

Google Cloud melakukan berbagai jenis peristiwa pemeliharaan. Perbedaan antara jenis peristiwa pemeliharaan disederhanakan, sehingga peristiwa pemeliharaan dari berbagai jenis terlihat sama di konsol Google Cloud . Sebagian besar jenis peristiwa pemeliharaan terencana terjadi antara pukul 22.00 hingga 05.00 waktu setempat di lokasi perangkat jaringan berada. Misalnya, jika perangkat berada di asia-south1, pemeliharaan terencana biasanya terjadi antara pukul 22.00 dan 05.00 Waktu Standar India (UTC+5:30). Peristiwa pemeliharaan terencana tidak memiliki interval yang ditetapkan antar-kejadian, tetapi umumnya terjadi beberapa kali dalam setahun.

Salah satu jenis peristiwa pemeliharaan terencana, yaitu migrasi fisik, terjadi dari Senin hingga Jumat, pukul 09.00 hingga 17.00 Waktu Bagian Timur.

Pemeliharaan tidak terencana

Peristiwa pemeliharaan darurat atau yang tidak terjadwal juga dapat terjadi. Peristiwa darurat adalah peristiwa tidak rutin dan tidak terencana yang dapat memengaruhi koneksi Cloud Interconnect. Sayangnya, peristiwa darurat dapat terjadi kapan saja, tanpa peringatan. Google merekomendasikan agar Anda membuat topologi jaringan hybrid ketersediaan tinggi untuk mengurangi pemadaman jaringan yang disebabkan oleh peristiwa pemeliharaan darurat.

Total kapasitas yang terpengaruh oleh peristiwa pemeliharaan yang tidak direncanakan bervariasi berdasarkan sifat peristiwa tersebut. Kapasitas ini bisa mencapai 100% pada satu atau beberapa koneksi Cloud Interconnect Anda.

Pemeliharaan mendesak

Peristiwa pemeliharaan mendesak mirip dengan peristiwa pemeliharaan terencana, tetapi dijadwalkan kurang dari 14 hari sebelumnya. Selain itu, hal ini memengaruhi hingga 100% kapasitas total pada setiap koneksi Cloud Interconnect yang terpengaruh.

Satu link di satu domain ketersediaan edge tidak memiliki SLA. Untuk mencegah hilangnya akses ke layanan selama pemeliharaan, pastikan Anda menyediakan dua link di domain ketersediaan edge yang berbeda. Untuk mengetahui informasi selengkapnya, lihat Membuat koneksi Cloud Interconnect redundan dengan kapasitas yang memadai.

Menerima notifikasi acara

Anda menerima notifikasi untuk peristiwa pemeliharaan terencana, tidak terencana, dan mendesak.

Notifikasi untuk peristiwa pemeliharaan terencana dikirim setidaknya 14 hari sebelum peristiwa ke email yang tercantum di kolom nocContactEmail dari objek Cloud Interconnect dan ditampilkan dalam metode API interconnects.get. Untuk mengetahui informasi selengkapnya, lihat Menetapkan kontak untuk notifikasi acara.

Selama peristiwa yang tidak direncanakan atau mendesak, Anda mungkin menerima notifikasi untuk gangguan, tetapi tidak memiliki cukup waktu untuk mengalihkan traffic. Untuk mengurangi kemungkinan gangguan traffic karena gangguan darurat, lihat Praktik terbaik.

Peristiwa pemeliharaan mungkin tidak terjadi sesuai rencana. Kami mengirimkan notifikasi acara yang diperbarui jika acara pemeliharaan dijadwalkan ulang atau dibatalkan.

Notifikasi tidak muncul di konsol untuk pengguna Partner Interconnect. Google Cloud

Menetapkan kontak untuk notifikasi acara

Cloud Interconnect memberi tahu pemilik project dan juga menggunakan Essential Contacts API untuk mengirim notifikasi tentang peristiwa pemeliharaan. Jika Anda tidak menetapkan kontak teknis ke project, notifikasi akan dikirim ke kontak penggantian, yang didasarkan pada peran IAM.

Untuk memastikan Anda menerima notifikasi yang tepat terkait peristiwa pemeliharaan, tentukan setidaknya satu kontak teknis untuk project yang menghosting koneksi Cloud Interconnect atau lampiran VLAN.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan kontak teknis untuk project, lihat Mengelola kontak untuk notifikasi.

Properti notifikasi acara

Bagian ini berlaku untuk Dedicated Interconnect, Cross-Cloud Interconnect, dan Cross-Site Interconnect.

Sebelum peristiwa pemeliharaan infrastruktur yang direncanakan, pengguna akan menerima notifikasi berikut:

  • Email dikirim ke semua pemilik project koneksi Cloud Interconnect segera setelah pemeliharaan yang berdampak dijadwalkan.

  • Email dikirim ke alamat yang tercantum di kolom nocContactEmail dari objek Cloud Interconnect. Anda dapat menemukan dan mengedit objek ini di konsol Google Cloud di halaman detail Cloud Interconnect, atau dengan menggunakan perintah Google Cloud CLI berikut:

    gcloud compute interconnects describe my-interconnect

  • Email akan dikirim ke kontak teknis yang tercantum untuk project yang menghosting koneksi Cloud Interconnect.

Selama peristiwa pemeliharaan infrastruktur tidak terencana atau mendesak, pengguna akan menerima notifikasi berikut:

  • Email dikirim ke semua pemilik project koneksi Cloud Interconnect segera setelah pemeliharaan yang berdampak dijadwalkan.

  • Email dikirim ke alamat yang tercantum di kolom nocContactEmail dari objek Cloud Interconnect.

  • Email akan dikirim ke kontak teknis yang tercantum untuk project yang menghosting koneksi Cloud Interconnect.

Notifikasi peristiwa Partner Interconnect

Sebelum peristiwa pemeliharaan infrastruktur terjadwal, pengguna Partner Interconnect akan menerima notifikasi berikut:

  • Email akan dikirim ke kontak teknis untuk project yang menghosting lampiran VLAN.

  • Email dikirim ke semua pemilik project untuk project yang menghosting lampiran VLAN.

Status gangguan

Email acara yang dikirim ke pemilik project dan kontak nocContactEmail menyertakan bagian berjudul "Status Gangguan". Berikut ini penjelasan kemungkinan status gangguan:

  • Diperbarui: peristiwa pemeliharaan yang dijadwalkan sebelumnya yang diperbarui atau dijadwalkan ulang.

  • Overrun: peristiwa pemeliharaan yang sebelumnya dijadwalkan sedang berlangsung dan membutuhkan waktu lebih lama dari yang diperkirakan untuk diselesaikan.

  • Selesai: peristiwa pemeliharaan yang telah selesai.

  • Dibatalkan: peristiwa pemeliharaan yang sebelumnya dijadwalkan dan dibatalkan.

  • Baru: peristiwa pemeliharaan baru.

  • Tidak ada perubahan: peristiwa pemeliharaan yang dijadwalkan sebelumnya dan masih dijadwalkan seperti yang direncanakan sebelumnya.

Melihat peristiwa pemeliharaan

Pilih salah satu opsi berikut:

gcloud

Untuk menampilkan informasi tentang koneksi Anda, termasuk peristiwa pemeliharaan terencana mendatang, jalankan perintah berikut:

gcloud compute interconnects describe INTERCONNECT_NAME

Ganti INTERCONNECT_NAME dengan nama Cloud Interconnect.

Outputnya mirip dengan berikut ini; cari 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

Untuk mencantumkan informasi tentang koneksi Anda, termasuk acara pemeliharaan mendatang, gunakan interconnects.get:

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

Ganti kode berikut:

  • PROJECT_ID: project ID tempat Cloud Interconnect berada

  • INTERCONNECT_NAME: nama Cloud Interconnect

Outputnya mirip dengan hal berikut ini:

{
"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"
]
}

Melihat peristiwa pemeliharaan di Unified Maintenance

Anda dapat menggunakan Pemeliharaan Terpadu untuk melihat peristiwa pemeliharaan infrastruktur Cloud Interconnect, dan Anda dapat mengonfigurasi Pemeliharaan Terpadu untuk mengirimkan pemberitahuan dan notifikasi tentang peristiwa pemeliharaan. Notifikasi tidak muncul di Pemeliharaan Terpadu untuk pengguna Partner Interconnect.

Ikuti langkah-langkah di halaman Mengonfigurasi pemberitahuan dan notifikasi, tetapi gunakan salah satu filter penyertaan berikut saat Anda diminta untuk membuatnya:

  • Filter ini hanya menyertakan notifikasi pemeliharaan terencana:

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

  • Filter ini hanya mencakup notifikasi pemeliharaan mendesak:

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

  • Filter ini hanya berisi notifikasi pemeliharaan yang tidak direncanakan:

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

Atau, untuk melihat peristiwa pemeliharaan dengan status Dijadwalkan, lihat Melihat pemeliharaan resource menggunakan 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"

Langkah berikutnya