Halaman ini diterjemahkan oleh Cloud Translation API.

Ubah kuorum dual-region

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

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

Memeriksa status kuorum region ganda

Anda dapat memeriksa status kuorum dual-region dengan cara berikut:

Di halaman Database overview
Menggunakan Dasbor insight sistem
Menggunakan Cloud Monitoring REST API atau gcloud CLI

Di halaman Ringkasan database

Buka halaman Spanner Instances di Konsol Google Cloud.

Buka halaman Instance
Klik nama instance yang ada di konfigurasi dual-region.
Klik nama database.
Di bagian Ringkasan, cari baris Quorum, yang menampilkan dual-region status kuorum 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 wilayah penayangan (misalnya, asia-south1).

Menggunakan dasbor Insight sistem

Setelah membuat konfigurasi dual-region, Anda dapat melihat 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 kondisi kuorum dual-region Anda.

Monitoring REST API

Menggunakan Monitoring projects.timeSeries.list API untuk mengkueri Ketersediaan kuorum region ganda metrik untuk memeriksa apakah suatu wilayah responsif pada waktu tertentu.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

PROJECT_ID: project ID Anda.
DUAL_REGION_LOCATION: lokasi wilayah di dual-region 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah masuk ke CLI gcloud dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login , atau menggunakan Cloud Shell, yang otomatis memasukkan Anda ke CLI gcloud kami. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login . Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/timeSeries" | Select-Object -Expand Content

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 dual-region dari region ganda menjadi wilayah tunggal.

gcloud CLI

Mendownload dual-region-quorum-health-check-script.sh .

Skrip bash ini memeriksa kondisi region untuk satu region. Jika responsif, maka skrip menjalankan gcloud spanner databases change-quorum untuk melakukan failover kuorum dual-region secara manual dari region tunggal.
Ganti variabel berikut dalam skrip:
- PROJECT: project ID Anda.
- INSTANCE: ID instance Anda.
- DATABASE: ID database Anda.
- SERVING_LOCATION: lokasi region di dual-region yang yang ingin Anda periksa.
Jalankan skrip di lingkungan pengembangan pilihan Anda. Untuk selengkapnya informasi, lihat Instal Google Cloud CLI dan siapkan Spanner API.
failback manual jika wilayah Anda tidak responsif dan adalah failover.

Mengubah kuorum region ganda dari region ganda menjadi region tunggal (failover)

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

Konsol Google Cloud

Buka halaman Spanner Instances di Konsol Google Cloud.

Buka halaman Instances
Klik nama instance yang ada di konfigurasi dual-region.
Klik System insights di menu navigasi.
Temukan metrik Ketersediaan kuorum region ganda.
Jika metrik ketersediaan kuorum Dual-region menunjukkan adanya gangguan di suatu wilayah, klik Aktifkan Cloud Shell di bagian atas Konsol Google Cloud.

Cloud Shell akan terbuka.
Untuk mengubah kuorum dual-region dari dual-region menjadi satu wilayah, masukkan perintah berikut yang ada di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk petunjuk terperinci, lihat tab gcloud.

gcloud CLI

Menggunakan gcloud spanner databases change-quorum untuk mengubah kuorum dual-region dari dual-region 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 di skrip untuk menyiapkan database.
INSTANCE_ID: ID permanen untuk di instance Compute Engine.
SERVING_LOCATION: Instance regional yang ingin Anda lakukan failover. Misalnya, jika asia-south1 (Mumbai) tidak responsif, dan Anda ingin melakukan failover ke asia-south2 (Delhi), masukkan asia-south2. Pastikan SERVING_LOCATION responsif teritorial Anda. Memilih region yang salah untuk failover akan mengakibatkan database tidak tersedia, yang tidak dapat dipulihkan sebelum region kembali online.

Flag opsional:

--etag=ETAG: ETAG dapat digunakan untuk perlindungan replay.

Untuk memeriksa status operasi perubahan kuorum Anda, jalankan gcloud spanner databases describe perintah. 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 failover secara manual setelah region yang terganggu responsif atau setelah jaringan masalah partisi telah diselesaikan:

Konsol Google Cloud

Buka halaman Spanner Instances di Konsol Google Cloud.

Buka halaman Instance
Klik nama instance yang berada dalam konfigurasi region ganda.
Klik System insights di menu navigasi.
Temukan metrik Ketersediaan kuorum region ganda.
Pada metrik ketersediaan kuorum region ganda, klik Ubah kuorum wilayah.

Cloud Shell akan terbuka.
Untuk mengubah kuorum dual-region dari dual-region menjadi satu wilayah, masukkan perintah berikut yang ada di tab gcloud CLI: gcloud spanner databases change-quorum. Untuk petunjuk terperinci, lihat tab gcloud.

gcloud CLI

Menggunakan gcloud spanner databases change-quorum untuk mengubah kuorum dual-region dari satu region menjadi dual-region.

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

Ganti kode berikut:

DATABASE_ID: ID permanen di skrip untuk menyiapkan database.
INSTANCE_ID: ID permanen untuk di instance Compute Engine.

Flag opsional:

--etag=ETAG: ETAG dapat digunakan untuk kontrol konkurensi optimistis.

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

gcloud spanner databases describe DATABASE_ID
    --instance=INSTANCE_ID

Langkah selanjutnya

Pelajari Konfigurasi instance region ganda lebih lanjut.