Mengubah kuorum dual-region

Halaman ini menjelaskan cara memeriksa status kesehatan kuorum dua wilayah 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 region ganda

Anda dapat memeriksa status kuorum region ganda 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 region ganda.

  3. Klik nama database.

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

    • Jika kuorum terpenuhi di kedua region, statusnya 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 region ganda, Anda dapat melihat metrik Ketersediaan kuorum region ganda 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 status quorum dua region.

Monitoring REST API

Gunakan API Monitoring projects.timeSeries.list untuk membuat kueri metrik Ketersediaan kuorum dua region untuk memeriksa apakah 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 dalam region ganda yang ingin Anda periksa.
  • START_TIME: waktu mulai kueri. Sebaiknya gunakan 5 menit sebelum waktu saat ini.
  • END_TIME: waktu akhir 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 sehat, 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 satu region Anda. Jika region berfungsi dengan baik, skrip akan menjalankan perintah gcloud spanner databases change-quorum untuk melakukan failover kuorum dual-region secara manual dari dual-region ke satu 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 Google Cloud CLI dan menyiapkan Spanner API.

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

Mengubah kuorum region ganda dari region ganda menjadi region tunggal (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 region ganda.

  3. Klik Insight sistem di menu navigasi.

  4. Temukan metrik Ketersediaan kuorum region ganda.

  5. Jika metrik ketersediaan kuorum region ganda menunjukkan adanya gangguan di suatu region, klik Ikon tombol Aktifkan Cloud Shell Activate Cloud Shell di bagian atas konsol Google Cloud.

    Cloud Shell akan terbuka.

  6. Untuk mengubah kuorum region ganda dari region ganda menjadi satu region, masukkan perintah berikut yang ditemukan di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk petunjuk selengkapnya, 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 failover. Misalnya, jika asia-south1 (Mumbai) tidak sehat, dan Anda ingin melakukan failover ke asia-south2 (Delhi), masukkan asia-south2. Pastikan SERVING_LOCATION adalah region 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 replay.

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 region ganda dari region tunggal menjadi region ganda (failback)

Untuk melakukan failback secara manual setelah region yang terganggu kembali 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 region ganda.

  3. Klik Insight sistem di menu navigasi.

  4. Temukan metrik Ketersediaan kuorum region ganda.

  5. Pada metrik Ketersediaan kuorum region ganda, klik Ubah kuorum region.

    Cloud Shell akan terbuka.

  6. Untuk mengubah kuorum region ganda dari region ganda menjadi satu region, masukkan perintah berikut yang ditemukan di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk petunjuk selengkapnya, 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 selanjutnya