Verificar interrupções com o Personalized Service Health

Neste documento, explicamos o que fazer se o Public Service Health estiver passando por uma interrupção.

O Personalized Service Health pode ser afetado por um incidente, parcial ou totalmente. É possível verificar incidentes, problemas de processamento e de desempenho com o Service Health usando o recurso da API Status e o painel do Service Health Google Cloud.

Usar a API Status

O recurso Status da API Service Health informa se recursos específicos do Service Health estão com problemas.

Antes de começar

Para começar a usar a API Status:

  1. Ative a API Service Health para o projeto ou organização que você vai usar para acessar esse status.

  2. Make sure that billing is enabled for your Google Cloud project.

  3. Defina permissões para acessar a API Service Health.

  4. Configure as permissões do Identity and Access Management (IAM) no projeto ou na organização para usar a API Status.

    Para configurar permissões no projeto, execute o seguinte comando:

    gcloud projects add-iam-policy-binding PROJECT_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer

    Para configurar permissões na sua organização, execute o seguinte comando:

    gcloud organizations add-iam-policy-binding ORGANIZATION_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer

    Para conseguir seu ORGANIZATION_ID, consulte Como conseguir o ID do recurso da sua organização.

As políticas do IAM concedidas em uma organização são herdadas por todos os projetos dela. Com elas, é possível acessar APIs de eventos da organização e do projeto em toda a organização.

Referências

Consulte a referência da API Status para saber qual método usar e o significado dos campos na resposta.

Ao definir o produto ou local, use os valores encontrados em Produtos do Google Cloud e locais.

Receber o status do Service Health usando um ID do projeto

Para conferir o status do Service Health usando um ID do projeto, use a seguinte solicitação:

GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/status

Se o valor do status for OK, a solicitação vai gerar a seguinte resposta:

{
  "state": "OK",
}

Esse status indica que os recursos acessados usando o ID do projeto, como eventos ou impactos, não estão apresentando problemas internos.

Se o valor do status for ISSUES_DETECTED, a solicitação vai gerar a seguinte resposta:

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new events",
      "details": {
        "API": "events"
      }
    },
    {
      "message": "We are experiencing problems creating new impacts",
      "details": {
        "API": "impacts"
      }
    }
  ]
}

Um estado ISSUES_DETECTED também retorna um conjunto de problemas, indicando que os recursos acessados usando o ID do projeto podem não ser precisos.

Se você não tiver permissões para receber o status, vai aparecer um erro PERMISSION_DENIED.

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "projects/PROJECT_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

Receber o status do Service Health usando um ID da organização

Para conferir o status, use a seguinte solicitação:

GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status

Se o Service Health estiver funcionando sem problemas, o status vai gerar a seguinte resposta:

{
  "state": "OK",
}

Se o Service Health estiver com problemas que possam afetar a precisão ou a capacidade dele, o status vai gerar uma resposta com o estado ISSUES_DETECTED:

{
  "state": "ISSUES_DETECTED",
  "issues": [
    {
      "message": "We are experiencing problems creating new organization level events",
      "details": {
        "API": "organizationEvents"
      }
    },
    {
      "message": "We are experiencing problems creating new organization level impacts",
      "details": {
        "API": "organizationImpacts"
      }
    }
  ]
}

Se você não tiver as permissões para receber o status, vai aparecer um erro PERMISSION_DENIED.

{
  "error": {
    "code": 403,
    "message": "Permission 'servicehealth.statuses.get denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global/status' (or it may not exist).",
    "status": "PERMISSION_DENIED",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "IAM_PERMISSION_DENIED",
        "domain": "servicehealth.googleapis.com",
        "metadata": {
          "resource": "organizations/ORGANIZATION_ID/locations/global/status",
          "permission": "servicehealth.statuses.get"
        }
      }
    ]
  }
}

Verificar o Google Cloud Service Health

O Google Cloud Service Health informa se o Personalized Service Health está com um problema. Você também pode usar um feed RSS para consumir os dados.

Para mais informações sobre o Google Cloud Service Health, consulte Incidentes e o Google Cloud Service Health.