Conceitos do Personalized Service Health

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 Service Health

Um evento de Service Health (v1,v1beta) é qualquer evento disruptivo que afete um Google Cloud produto que seja 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 emergentes e ativas Google Cloud relevantes para seus projetos. É uma categoria de um evento de 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.

Um incidente pode 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 gravemente degradados.

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:

    • Em surgimento: os engenheiros do Google estão investigando ativamente o incidente para determinar o impacto. Um incidente emergente se tornará um incidente confirmado ou resolvido assim que 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 a um incidente pai. Todas as atualizações futuras serão publicadas apenas no 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 aconteceu. 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 passando por 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 granular de interrupção 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 atingirem 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 descreve como um incidente afeta seu projeto. A relevância pode mudar conforme o incidente avança.

A relevância pode ter os seguintes valores:

  • Afetado: foi verificado que o incidente está afetando o projeto. Disponível apenas para alguns produtos do Google Cloud .
  • 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.

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 tag OUTPUT_ONLY que 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 matriz OUTPUT_ONLY que 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:

  1. Abra o guia Produtos e locais compatíveis.
  2. Encontre o produto do Target Google Cloud na tabela.
  3. Copie o valor listado em ID do produto.

Como alternativa, determine os identificadores imutáveis corretos diretamente dos payloads da API:

  1. Faça uma chamada de API que retorne recursos de evento (como projects.locations.events.list).
  2. Inspecione os mapeamentos de bloco impact na matriz JSON resultante.
  3. Extraia a string presente na propriedade product. Esse valor indica o ID do produto estável, independentemente dos nomes de exibição.