Neste documento, descrevemos os principais conceitos e termos usados no Personalized Service Health (PSH). Entender esses conceitos ajuda a interpretar eventos e configurar alertas de maneira eficaz.
Evento do Personalized Service Health
Um evento do Service Health (v1,v1beta) é qualquer evento disruptivo que afete um produto do Google Cloud relevante para seus projetos ou recursos. Alguns exemplos são interrupções de rede, erros de configuração e problemas de desempenho.
Cada evento contém detalhes sobre o impacto geral, atualizações do Google e informações específicas do seu projeto do Google Cloud .
Incidente
Incidentes são interrupções ou degradações de serviço Google Cloud relevantes para seus projetos. Um incidente também é uma categoria de um evento do Service Health.
Um incidente inclui o seguinte:
- Impacto do incidente: detalhes do escopo do evento, como produtos e locais doGoogle Cloud afetados.
- Atualizações de Google Cloud: atualizações periódicas do suporte doGoogle Cloud .
- Relevância personalizada: relevância do incidente para seu projeto do Google Cloud.
- Sintomas, soluções alternativas e ETAs: informações para ajudar a avaliar o impacto, aplicar uma solução alternativa ou saber mais sobre a causa raiz.
Os incidentes podem ter um relatório de incidente, que inclui os fatores que contribuíram para o incidente e as etapas que o Google Cloud planeja seguir para evitar que incidentes semelhantes ocorram novamente. Os alertas de incidente estão disponíveis para incidentes que atendem às seguintes condições:
- O incidente tem impacto global ou está afetando uma porcentagem significativa de projetos de clientes em uma ou mais regiões.
- Um ou mais produtos estão indisponíveis ou com desempenho muito reduzido.
Estados de eventos e estados detalhados
Um evento tem dois campos que indicam o estado dele. Os valores desses campos mudam conforme o evento evolui.
Estado do evento: indica o estado geral do evento. Pode ser um destes:
- Ativo: o evento está afetando o Google Cloud e vai continuar recebendo atualizações.
- Fechado: o evento não está mais afetando nenhum produto do Google Cloud ou foi mesclado com outro evento.
Estado detalhado: fornece mais informações sobre o estado do evento. Ele se aplica apenas a incidentes e pode ser um dos seguintes valores, dependendo do estado do evento:
Emergente: os engenheiros do Google estão investigando ativamente o incidente para determinar o impacto. Um incidente emergente se tornará um incidente confirmado ou resolvido quando a avaliação de impacto for concluída. Um incidente ativo pode ser um incidente emergente.
O suporte para incidentes emergentes está disponível apenas para produtos de rede do Google Cloud.
Confirmado: o incidente foi confirmado pelos engenheiros do Google e está afetando pelo menos um produto do Google Cloud . Atualizações de status contínuas serão fornecidas até que o problema seja resolvido.
Um incidente ativo pode ser um incidente confirmado.
Mesclado: o incidente foi mesclado com um incidente pai. Todas as outras atualizações serão publicadas apenas para o pai.
Resolvido: o incidente não está mais afetando nenhum produto do Google Cloud depois que uma ação foi realizada. Não haverá mais atualizações.
Um incidente encerrado geralmente é um incidente resolvido.
Falso positivo: após a investigação, os engenheiros do Google concluíram que o incidente não está afetando um produto do Google Cloud . Esse estado pode mudar se o incidente for analisado novamente.
Fechado automaticamente: o incidente foi fechado automaticamente pelos seguintes motivos:
- Não foi possível confirmar o impacto do incidente.
- O incidente foi intermitente ou resolvido por conta própria.
O incidente não tem uma resolução porque nenhuma ação ou investigação foi realizada. Se for intermitente, o incidente poderá ser reaberto.
Status de interrupção granular
Durante um incidente com vários produtos ou locais, produtos ou locais individuais podem se recuperar antes que o incidente geral seja resolvido. O Personalized Service Health fornece status de interrupção granular por produto e por local para refletir a recuperação parcial enquanto um incidente está ativo. O status de interrupção granular está disponível para eventos para envolvidos no projeto e da organização.
Um produto ou local pode ter um dos seguintes status de interrupção granular:
- Afetado: o produto ou local está passando por uma interrupção devido ao incidente.
- Resolvido: o produto ou local específico não está mais enfrentando interrupções e foi recuperado.
Distinção entre estados de eventos e status granular
É importante distinguir entre o estado geral do evento, o estado detalhado e o status de interrupção granular de produtos ou locais individuais:
- Estado geral e detalhado do evento: aplicam-se ao incidente como um todo. Um incidente permanece Ativo (com um estado detalhado, como Confirmado) enquanto pelo menos um produto ou local permanecer Afetado. Um incidente passa para Fechado (com um estado detalhado de Resolvido) somente depois que todos os produtos e locais associados alcançarem o status Resolvido.
- Status de interrupção granular: aplica-se de forma independente a cada produto ou local afetado. Um produto ou local individual pode passar para Resolvido enquanto o estado geral do evento permanece Ativo.
Quando um incidente é mesclado a um incidente pai, os status de interrupção granular do incidente filho são limpos, e o incidente filho delega o status granular ao incidente pai como a única fonte de verdade.
Relevância
O Personalized Service Health avalia o impacto de todos os incidentes no seu projeto. Se o impacto do incidente no seu projeto for possível ou confirmado, ele vai ficar disponível no painel e na API do Service Health.
A relevância indica se o projeto foi afetado, está relacionado ou parcialmente relacionado a um evento. Para produtos compatíveis em pré-lançamento, a relevância também identifica os recursos específicos do projeto que são afetados.
A relevância pode ter os seguintes valores:
- Afetado: o incidente está afetando o projeto. Em Produtos compatíveis (pré-lançamento), também é possível ver quais recursos específicos do projeto são afetados.
- Relacionado: o incidente tem uma conexão direta com o projeto e afeta um produto do Google Cloud no local usado por ele.
- Parcialmente relacionado: o incidente está associado a um produto do Google Cloud que o projeto usa, mas talvez ele não esteja sendo afetado. Por exemplo, o incidente pode estar afetando um produto do Google Cloud que o projeto usa, mas em um local que não é usado por ele.
- Não afetado: o incidente não está afetando o projeto.
- Desconhecido: o impacto no projeto não é conhecido neste momento.
Recursos afetados
Quando um evento tem uma relevância de IMPACTED para seu projeto,
o Personalized Service Health pode identificar os recursos específicos do Google Cloud
no projeto que são afetados pela interrupção (por exemplo, uma instância específica
do Cloud SQL ou um cluster do Google Kubernetes Engine).
Na API Service Health v1beta, cada recurso afetado é representado por um recurso Impact (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}). Um recurso Impact contém:
- Eventos vinculados (
events): um ou mais nomes de recursosEventdo Service Health para envolvidos no projeto (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID}) associados ao impacto no recurso. - Recurso afetado (
asset):assetName: o nome completo do recurso do recurso doGoogle Cloud afetado (por exemplo,//cloudsql.googleapis.com/projects/123456789/instances/my-db-instance).assetType: o tipo de recurso do Inventário de recursos do Cloud do recurso afetado (por exemplo,sqladmin.googleapis.com/Instanceoucontainer.googleapis.com/Cluster).
- Descrição (
description): contexto adicional sobre o impacto no recurso, quando disponível. - Carimbos de data/hora (
createTime,updateTime): quando o registro de impacto do recurso foi criado e atualizado pela última vez.
Lembre-se dos seguintes comportamentos ao usar recursos afetados na pré-lançamento:
- Impactos no projeto x impactos na organização:
- O impacto (
projects.locations.impacts) tem como escopo um único projeto e só retorna recursos que não são de contêiner quando o evento tem relevânciaIMPACTEDconfirmada para esse projeto e quando o suporte ao produto está disponível. - O impacto na organização (
organizations.locations.organizationImpacts) agrega toda a organização para retornar recursos de contêiner (projetos) com qualquer relevância diferente de zero (PARTIALLY_RELATED,RELATEDouIMPACTED), em que relevância diferente de zero significa qualquer projeto que possa ser afetado por umOrganizationEvent.
- O impacto (
- Pré-requisito de ativação da API: para receber registros de
Impact, a API Service Health (servicehealth.googleapis.com) precisa estar ativada no projeto pelo menos 24 horas antes do início do evento. Ativar a API depois que um evento começa adiciona retroativamente eventos para envolvidos no projeto dos últimos 90 dias, mas não adiciona retroativamente impactos no nível do recurso. - Ciclo de vida da duração do evento: quando um recurso é identificado como afetado por
um evento, o registro
Impactdele permanece associado ao evento durante o ciclo de vida do incidente. Use o recursoEventvinculado para acompanhar o estado geral do incidente (ACTIVEouCOMPLETED) e as atualizações de comunicações. - Produtos compatíveis e escopo do incidente: o impacto no nível do recurso está
disponível para produtos Google Cloud e tipos de recursos
compatíveis.
Se um evento afetar um produto que não é compatível com o impacto no nível do recurso ou
se a interrupção estiver em um plano de controle ou em um nível regional não vinculado a
instâncias de recursos individuais, o projeto
Eventainda vai aparecer comrelevance: IMPACTED, enquantoimpacts.listvai retornar uma lista vazia.
Para consultar os recursos afetados, consulte Gerenciar eventos que afetam um projeto.
Nomes de identidade e de exibição do produto (somente Alfa e Beta)
Para permitir que os administradores identifiquem rapidamente as operações sem exigir mapeamentos
locais de identificadores de produtos, as entradas de eventos nas versões v1alpha e v1beta
fornecem strings de exibição dentro dos recursos referenciados.
Especificamente nos objetos Product especificados em payloads padrão
(localizados nas coleções impact em Event e
OrganizationEvent), duas novas propriedades ajudam na identificação:
display_name(string): uma tagOUTPUT_ONLYque expõe títulos de produtos legíveis por humanos adequados para leituras de clientes (como"Google Cloud SQL").previous_display_names(string repetida): uma matrizOUTPUT_ONLYque detalha todos os títulos que esse recurso específico aceitava anteriormente. Isso mantém a continuidade no rastreamento de eventos por meio de mudanças de marca ativas.
Os campos de exibição de produtos são adiados na plataforma vGA (v1) para máxima estabilidade
do sistema.
Para determinar os identificadores imutáveis corretos para uso em filtros e alertas:
- Abra o guia Produtos e locais compatíveis.
- Encontre o produto de destino Google Cloud na tabela.
- Copie o valor listado em ID do produto.
Como alternativa, determine os identificadores imutáveis corretos diretamente dos payloads da API:
- Faça uma chamada de API que retorne recursos de evento (como
projects.locations.events.list). - Inspecione os mapeamentos de bloco
impactna matriz JSON resultante. - Extraia a string presente na propriedade
product. Esse valor indica o ID do produto estável, independentemente dos nomes de exibição.