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 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 recursos Event do Service Health para envolvidos no projeto (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID}) associados ao impacto no recurso.
  • Recurso afetado (asset):
  • 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ância IMPACTED confirmada 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, RELATED ou IMPACTED), em que relevância diferente de zero significa qualquer projeto que possa ser afetado por um OrganizationEvent.
  • 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 Impact dele permanece associado ao evento durante o ciclo de vida do incidente. Use o recurso Event vinculado para acompanhar o estado geral do incidente (ACTIVE ou COMPLETED) 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 Event ainda vai aparecer com relevance: IMPACTED, enquanto impacts.list vai 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 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 de destino 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.