Mudar o quórum birregional

Nesta página, descrevemos como verificar o status de integridade do quorum de duas regiões do Spanner e como mudar manualmente o quorum em caso de interrupções no serviço.

Para mais informações sobre regiões duplas, consulte as Configurações de instâncias birregionais do Spanner.

Verificar o status do quórum birregional

É possível verificar o status do seu quorum de duas regiões das seguintes maneiras:

Na página Visão geral do banco de dados
Usar o painel "Insights do sistema"
Usar uma API REST do Cloud Monitoring ou a Google Cloud CLI

Na página "Visão geral do banco de dados"

Acesse a página Instâncias do Spanner no console do Google Cloud .

Acessar a página "Instâncias"
Clique no nome da instância que está em uma configuração de duas regiões.
Clique no nome do banco de dados.
Em "Visão geral", procure a linha Quorum, que mostra o status de quórum de duas regiões da sua instância:
- Se o quórum for atendido nas duas regiões, o status vai mostrar Birregional.
- Se um failover manual ou gerenciado pelo Google tiver sido realizado, o nome da região de exibição vai aparecer (por exemplo, asia-south1).

Usar o painel "Insights do sistema"

Depois de criar uma configuração de duas regiões, é possível conferir a métrica Linha do tempo de integridade do quorum de duas regiões no painel "Insights do sistema no nível da instância".

Para mais informações, consulte Visualizar o painel de insights do sistema.

Usar a API REST do Monitoring ou a CLI gcloud

Use a API REST do Monitoring ou a CLI gcloud para verificar a integridade do seu quorum de duas regiões.

API REST do Monitoring

Use a API Monitoring projects.timeSeries.list para consultar o cronograma de integridade do quórum birregional e verificar se uma região está íntegra em um determinado momento.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_ID: o ID do projeto.
DUAL_REGION_LOCATION: o local da região na região dupla que você quer verificar.
START_TIME: o horário de início da consulta. Recomendamos usar 5 minutos antes da hora atual.
END_TIME: o horário de término da consulta. Recomendamos usar a hora atual.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando abaixo:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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.%"
}

Se você não encontrar uma resposta semelhante, talvez sua região não esteja íntegra e seja necessário mudar o quórum birregional de birregional para região única.

CLI da gcloud

Faça o download do arquivo dual-region-quorum-health-check-script.sh.

Esse script bash verifica a integridade da sua região única. Se a região estiver íntegra, o script vai executar o comando gcloud spanner databases change-quorum para fazer failover manual do quórum birregional de birregional para região única.
Substitua as seguintes variáveis no script:
- PROJECT: o ID do projeto.
- INSTANCE: o ID da sua instância.
- DATABASE: o ID do banco de dados.
- SERVING_LOCATION: o local da região na região dupla que você quer verificar.
Execute o script no ambiente de desenvolvimento de sua escolha. Para mais informações, consulte Instalar a CLI gcloud e configurar a API Spanner.
Faça um failback manual se a região não estiver íntegra e tiver ocorrido um failover.