Este documento explica o que fazer se o Personalized Service Health estiver a sofrer uma interrupção.
O estado de saúde do serviço personalizado pode ser afetado por um incidente, parcial ou totalmente. Pode verificar se existem incidentes, problemas de processamento e problemas de desempenho com a integridade do serviço através do recurso da API Status e do Google Cloud painel de controlo de integridade do serviço.
Use a API Status
O recurso da API Status da API Service Health indica se funcionalidades específicas do Service Health estão a ter problemas.
Antes de começar
Para começar a usar a API Status:
- Ative a API Service Health para o projeto ou a organização que vai usar para aceder a este estado.
-
Verify that billing is enabled for your Google Cloud project.
- Defina autorizações para aceder à API Service Health.
Configure as autorizações da gestão de identidade e de acesso (IAM) no seu projeto ou organização para usar a API Status.
Para configurar as autorizações no seu projeto, execute o seguinte comando:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member {USER|GROUP|SERVICE_ACCOUNT} \ --role roles/servicehealth.viewer
Para configurar autorizaçõ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 obter o seu ORGANIZATION_ID, consulte o artigo Obtenha o ID do recurso da sua organização.
As políticas IAM concedidas numa organização são herdadas por todos os projetos na organização. Estas políticas permitem-lhe aceder às APIs de eventos da organização e do projeto em toda a organização.
Referências
Consulte a referência da API Status para ver o método que pode usar e o significado dos campos na resposta.
Ao definir o produto ou a localização, use os valores encontrados nos produtos e nas localizações do Google Cloud.
Obtenha o estado do Service Health através de um ID do projeto
Para obter o estado do Service Health através de um ID do projeto, use o seguinte pedido:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/status
Se o valor do estado for OK
, o pedido produz a seguinte resposta:
{
"state": "OK",
}
Este estado indica que as funcionalidades acedidas através do ID do projeto, como os eventos ou os impactos, não estão a ter problemas internamente.
Se o valor do estado for ISSUES_DETECTED
, o pedido produz 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 devolve um conjunto de problemas, o que indica que as funcionalidades acedidas através do ID do projeto podem não ser precisas.
Se não tiver autorizações
para obter o estado, recebe 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"
}
}
]
}
}
Obtenha o estado do Service Health através de um ID da organização
Para obter o estado, use o seguinte pedido:
GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status
Se o estado de funcionamento do serviço estiver a funcionar sem problemas, o estado deve gerar a seguinte resposta:
{
"state": "OK",
}
Se o estado de funcionamento do serviço estiver a ter problemas que possam afetar a respetiva precisão ou capacidade, o estado deve 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 não tiver as autorizações para obter o estado, recebe 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"
}
}
]
}
}
Verifique o Google Cloud estado de funcionamento do serviço
Google Cloud O estado do serviço indica se o Personalized Service Health está a ter um problema. Também pode usar um feed RSS para consumir os dados.
Para mais informações sobre o Google Cloud estado do serviço, consulte Incidentes e Google Cloud estado do serviço.