Mengubah kuorum dual-region

Halaman ini menjelaskan cara memeriksa status kondisi kuorum dual-region Spanner, dan cara mengubah kuorum secara manual jika terjadi gangguan layanan.

Untuk mengetahui informasi selengkapnya tentang dual-region, lihat Konfigurasi instance dual-region Spanner.

Memeriksa status kuorum dual-region

Anda dapat memeriksa status kuorum dua region dengan cara berikut:

Di halaman Ringkasan database

  1. Buka halaman Spanner Instances di konsol Google Cloud .

    Buka halaman Instances

  2. Klik nama instance yang berada dalam konfigurasi dual-region.

  3. Klik nama database.

  4. Di bagian Ringkasan, cari baris Quorum, yang menampilkan status kuorum dua region instance Anda:

    • Jika kuorum terpenuhi di kedua region, status akan menampilkan Region ganda.

    • Jika failover manual atau yang dikelola Google telah dilakukan, Anda akan melihat nama region penayangan (misalnya, asia-south1).

Menggunakan dasbor Insight sistem

Setelah membuat konfigurasi dual-region, Anda dapat melihat metrik Linimasa kondisi kuorum dual-region di dasbor Insight sistem tingkat Instance.

Untuk mengetahui informasi selengkapnya, lihat Melihat dasbor insight sistem.

Menggunakan Monitoring REST API atau gcloud CLI

Anda dapat menggunakan Monitoring REST API atau gcloud CLI untuk memeriksa kondisi kuorum dua region Anda.

Monitoring REST API

Gunakan API projects.timeSeries.list Monitoring untuk membuat kueri Linimasa kondisi quorum dua region guna memeriksa apakah suatu region dalam kondisi baik pada waktu tertentu.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: project ID Anda.
  • DUAL_REGION_LOCATION: lokasi region di region ganda yang ingin Anda periksa.
  • START_TIME: waktu mulai kueri. Sebaiknya gunakan 5 menit sebelum waktu saat ini.
  • END_TIME: waktu berakhir kueri. Sebaiknya gunakan waktu saat ini.

Metode HTTP dan URL: 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries

Meminta isi JSON: 

{
  "name": "PROJECT_ID",
  "aggregation.alignmentPeriod": "60s",
  "aggregation.crossSeriesReducer": "REDUCE_FRACTION_TRUE",
  "aggregation.groupByFields": "resource.labels.location",
  "aggregation.perSeriesAligner": "ALIGN_NEXT_OLDER",
  "filter": "metric.labels.quorum_availability = "Healthy" AND metric.type = "spanner.googleapis.com/instance/dual_region_quorum_availability" AND resource.labels.location = "DUAL_REGION_LOCATION"",
  "interval.startTime": "START_TIME",
  "interval.endTime": "END_TIME"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "timeSeries": [
    {
      "metric": {
        "type": "spanner.googleapis.com/instance/dual_region_quorum_availability"
      },
      "resource": {
        "type": "spanner_instance",
        "labels": {
          "project_id": "spanner-project",
          "location": "australia-southeast1"
        }
      },
      "metricKind": "GAUGE",
      "valueType": "DOUBLE",
      "points": [
        {
          "interval": {
            "startTime": "2024-07-11T05:41:23Z",
            "endTime": "2024-07-11T05:41:23Z"
          },
          "value": {
            "doubleValue": 1
          }
        }
      ]
    }
  ],
  "unit": "10^2.%"
}

Jika Anda tidak melihat respons serupa, region Anda mungkin tidak dalam kondisi baik, dan Anda mungkin perlu mengubah kuorum region ganda dari region ganda menjadi region tunggal.

gcloud CLI

  1. Download file dual-region-quorum-health-check-script.sh.

    Skrip bash ini memeriksa kondisi region tunggal Anda. Jika region responsif, skrip akan menjalankan perintah gcloud spanner databases change-quorum untuk melakukan failover kuorum dual-region secara manual dari dual-region ke single region.

  2. Ganti variabel berikut dalam skrip:

    • PROJECT: project ID Anda.
    • INSTANCE: ID instance Anda.
    • DATABASE: ID database Anda.
    • SERVING_LOCATION: lokasi region dalam region ganda yang ingin Anda periksa.

  3. Jalankan skrip di lingkungan pengembangan pilihan Anda. Untuk mengetahui informasi selengkapnya, lihat Menginstal gcloud CLI dan menyiapkan Spanner API.

  4. Failback secara manual jika region Anda tidak responsif dan terjadi failover.

Mengubah kuorum dual-region dari dual-region menjadi single region (failover)

Untuk melakukan failover secara manual jika terjadi pemadaman layanan regional atau masalah partisi jaringan:

Konsol Google Cloud

  1. Buka halaman Spanner Instances di konsol Google Cloud .

    Buka halaman Instances

  2. Klik nama instance yang berada dalam konfigurasi dual-region.

  3. Klik System insights di menu navigasi.

  4. Temukan metrik Linimasa kesehatan kuorum dua region.

  5. Jika linimasa kualitas quorum Region ganda menunjukkan adanya gangguan di suatu region, klik Ubah quorum region.

    Cloud Shell akan terbuka.

  6. Untuk mengubah kuorum dual-region dari dual-region menjadi satu region, masukkan perintah berikut yang ada di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk mendapatkan petunjuk mendetail, lihat tab gcloud.

gcloud CLI

Gunakan perintah gcloud spanner databases change-quorum untuk mengubah kuorum region ganda dari region ganda menjadi satu region.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --single-region --serving-location=SERVING_LOCATION
    [--etag=ETAG]

Ganti kode berikut:

  • DATABASE_ID: ID permanen database.

  • INSTANCE_ID: ID permanen untuk instance.

  • SERVING_LOCATION: Konfigurasi instance regional yang ingin Anda alihkan. Misalnya, jika asia-south1 (Mumbai) tidak sehat, dan Anda ingin melakukan failover ke asia-south2 (Delhi), masukkan asia-south2. Pastikan SERVING_LOCATION adalah wilayah yang sehat. Memilih region yang salah untuk failover akan mengakibatkan database tidak tersedia, yang tidak dapat dipulihkan sebelum region kembali online.

Flag opsional:

  • --etag=ETAG: Argumen ETAG dapat digunakan untuk perlindungan pemutaran ulang.

Untuk memeriksa status operasi perubahan kuorum, jalankan perintah gcloud spanner databases describe. Kolom quorumInfo memberikan informasi tentang operasi.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Mengubah kuorum dual-region dari satu region menjadi dual-region (failback)

Untuk melakukan failback secara manual setelah region yang terganggu berfungsi normal atau setelah masalah partisi jaringan teratasi:

Konsol Google Cloud

  1. Buka halaman Spanner Instances di konsol Google Cloud .

    Buka halaman Instances

  2. Klik nama instance yang berada dalam konfigurasi dual-region.

  3. Klik System insights di menu navigasi.

  4. Temukan metrik Linimasa kesehatan kuorum dua region.

  5. Di linimasa kesehatan kuorum Dual-region, klik Ubah kuorum region.

    Cloud Shell akan terbuka.

  6. Untuk mengubah kuorum dua region dari satu region menjadi dua region, masukkan perintah berikut yang ada di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk mendapatkan petunjuk mendetail, lihat tab gcloud.

gcloud CLI

Gunakan perintah gcloud spanner databases change-quorum untuk mengubah kuorum region ganda dari region tunggal menjadi region ganda.

gcloud spanner databases change-quorum
    DATABASE_ID --instance=INSTANCE_ID
    --dual-region
    [--etag=ETAG]

Ganti kode berikut:

  • DATABASE_ID: ID permanen database.

  • INSTANCE_ID: ID permanen untuk instance.

Flag opsional:

  • --etag=ETAG: Argumen ETAG dapat digunakan untuk kontrol konkurensi optimis.

Untuk memeriksa status operasi perubahan kuorum, jalankan perintah gcloud spanner databases describe. Kolom quorumInfo memberikan informasi tentang operasi.

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Langkah berikutnya