Conceptos de Personalized Service Health

En este documento, se describen los conceptos y términos clave que se usan en Personalized Service Health (PSH). Comprender estos conceptos te ayuda a interpretar los eventos y configurar las alertas de manera eficaz.

Evento de Personalized Service Health

Un evento de Service Health (v1,v1beta) es cualquier evento disruptivo que afecte a un producto de Google Cloud que sea relevante para tus proyectos o recursos. Entre los ejemplos, se incluyen las interrupciones de la red, los errores de configuración y los problemas de rendimiento.

Cada evento contiene detalles sobre el impacto general del evento, actualizaciones de Google y la información específica de tu proyecto de Google Cloud .

Incidente

Los incidentes son interrupciones o degradaciones del servicio de Google Cloud emergentes y activas relevantes para tus proyectos. Un incidente también es una categoría de un evento de Service Health.

Un incidente incluye lo siguiente:

  • Impacto del incidente: Detalles del alcance del evento, como los productos y las ubicaciones deGoogle Cloud afectados.
  • Actualizaciones de Google Cloud: Son actualizaciones periódicas de la asistencia deGoogle Cloud .
  • Relevancia personalizada: Es la relevancia del incidente para tu proyecto de Google Cloud.
  • Síntomas, soluciones alternativas y ETAs: Información para ayudar a evaluar el impacto, aplicar una solución alternativa o conocer más sobre la causa raíz.

Los incidentes pueden tener un informe de incidentes, que incluye los factores que contribuyeron al incidente y los pasos que Google Cloud planea seguir para evitar que se repitan incidentes similares. Los informes de incidentes están disponibles para los incidentes que cumplen con las siguientes condiciones:

  • El incidente tiene un impacto global o afecta a un porcentaje significativo de los proyectos de los clientes en una o más regiones.
  • Uno o más productos no están disponibles o están muy degradados.

Estados de eventos y estados detallados

Un evento tiene dos campos que indican su estado. Los valores de estos campos cambian a medida que evoluciona el evento.

  • Estado del evento: Indica el estado general del evento. Puede ser uno de los siguientes:

    • Activo: El evento afecta de forma activa a Google Cloud y seguirá recibiendo actualizaciones.
    • Cerrado: El evento ya no afecta a ningún producto de Google Cloud ni se combinó con otro evento.
  • Estado detallado: Proporciona más información sobre el estado del evento. Se aplica solo a los incidentes y puede ser uno de los siguientes valores según el estado del evento:

    • Emergente: Los ingenieros de Google están investigando activamente el incidente para determinar el impacto. Un incidente emergente se convertirá en un incidente confirmado o resuelto una vez que se complete la evaluación de impacto. Un incidente activo puede ser un incidente emergente.

      La asistencia para incidentes emergentes solo está disponible para los productos de redes de Google Cloud.

    • Confirmado: Los ingenieros de Google confirman el incidente y afecta al menos a un producto de Google Cloud . Se proporcionarán actualizaciones de estado continuas hasta que se resuelva.

      Un incidente activo puede ser un incidente confirmado.

    • Combinado: El incidente se combinó con un incidente superior. Todas las actualizaciones posteriores se publicarán solo en el superior.

    • Resuelto: El incidente ya no afecta a ningún producto de Google Cloud después de que se tomaron medidas. No habrá más actualizaciones.

      Un incidente cerrado suele ser un incidente resuelto.

    • Falso positivo: Después de investigar, los ingenieros de Google concluyeron que el incidente no afecta a un producto de Google Cloud . Este estado puede cambiar si se vuelve a revisar el incidente.

    • Cerrado automáticamente: El incidente se cerró automáticamente por los siguientes motivos:

      • No se pudo confirmar el impacto del incidente.
      • El incidente fue intermitente o se resolvió por sí solo.

      El incidente no tiene una resolución porque no se realizó ninguna acción ni investigación. Si es intermitente, es posible que el incidente se vuelva a abrir.

Estado de interrupción detallado

Durante un incidente de varios productos o ubicaciones, los productos o las ubicaciones individuales pueden recuperarse antes de que se resuelva el incidente general. Personalized Service Health proporciona un estado de interrupción detallado por producto y por ubicación para reflejar la recuperación parcial mientras un incidente está activo. El estado de interrupción detallado está disponible para los eventos a nivel del proyecto y de la organización.

Un producto o una ubicación pueden tener uno de los siguientes estados de interrupción detallados:

  • Afectado: El producto o la ubicación experimentan interrupciones debido al incidente.
  • Resuelto: El producto o la ubicación específicos ya no experimentan interrupciones y se recuperaron.

Distinción entre los estados de los eventos y el estado detallado

Es importante distinguir entre el estado general del evento, el estado detallado y el estado de interrupción detallado de los productos o las ubicaciones individuales:

  • Estado general y detallado del evento: Se aplican al incidente en su totalidad. Un incidente permanece Activo (con un estado detallado, como Confirmado) siempre que al menos un producto o una ubicación permanezcan Afectados. Un incidente pasa a Cerrado (con un estado detallado de Resuelto) solo después de que todos los productos y ubicaciones asociados hayan alcanzado el estado Resuelto.
  • Estado de interrupción detallado: Se aplica de forma independiente a cada producto o ubicación afectados. Un producto o una ubicación individuales pueden pasar al estado Resuelto, mientras que el estado general del evento permanece Activo.

Cuando un incidente se combina con un incidente superior, se borran los estados de interrupción detallados del incidente secundario, y este delega el estado detallado al incidente superior como la fuente única de información.

Relevancia

Personalized Service Health evalúa el impacto de todos los incidentes en tu proyecto. Si el impacto del incidente en tu proyecto es posible o se confirma, estará disponible en el panel y la API de Service Health.

La relevancia indica si tu proyecto se ve afectado, está relacionado o está parcialmente relacionado con un evento. En el caso de los productos compatibles en versión preliminar, la relevancia también identifica los recursos específicos de tu proyecto que se ven afectados.

La relevancia puede tener los siguientes valores:

  • Afectado: Se confirmó que el incidente afecta a tu proyecto. En Productos compatibles (versión preliminar), también puedes ver qué recursos específicos de tu proyecto se ven afectados.
  • Relacionado: El incidente tiene una conexión directa con tu proyecto y afecta a un producto de Google Cloud en una ubicación que se usa en tu proyecto.
  • Parcialmente relacionado: El incidente está asociado con un producto de Google Cloud que se usa en tu proyecto, pero es posible que no lo esté afectando. Por ejemplo, el incidente puede estar afectando a un producto de Google Cloud que se usa en tu proyecto, pero en una ubicación que no utiliza tu proyecto.
  • No afectado: El incidente no afecta a tu proyecto.
  • Desconocido: En este momento, se desconoce el impacto que tiene el incidente en tu proyecto.

Recursos afectados

Cuando un evento tiene una relevancia de IMPACTED para tu proyecto, Personalized Service Health puede identificar los recursos específicos de Google Cloud en tu proyecto que se ven afectados por la interrupción (por ejemplo, una instancia específica de Cloud SQL o un clúster de Google Kubernetes Engine).

En la API de Service Health v1beta, cada recurso afectado se representa con un recurso Impact (projects/{PROJECT_ID}/locations/global/impacts/{IMPACT_ID}). Un recurso Impact contiene lo siguiente:

  • Eventos vinculados (events): Uno o más nombres de recursos de Service Health Event a nivel de proyecto (projects/{PROJECT_ID}/locations/global/events/{EVENT_ID}) asociados con el impacto en el recurso.
  • Activo afectado (asset):
  • Descripción (description): Es el contexto adicional sobre el impacto en el recurso, cuando está disponible.
  • Marcas de tiempo (createTime, updateTime): Indica cuándo se creó por primera vez el registro de impacto del recurso y cuándo se actualizó por última vez.

Recuerda los siguientes comportamientos cuando uses recursos afectados en la vista previa:

  • Impactos en el proyecto frente a impactos en la organización:
    • Impact (projects.locations.impacts) se limita a un solo proyecto y solo devuelve recursos que no son contenedores cuando el evento confirmó la relevancia de IMPACTED para ese proyecto y cuando la asistencia del producto está disponible.
    • Impacto en la organización (organizations.locations.organizationImpacts) agrega en toda la organización para devolver recursos de contenedor (proyectos) con cualquier relevancia distinta de cero (PARTIALLY_RELATED, RELATED o IMPACTED), en la que relevancia distinta de cero significa cualquier proyecto que pueda verse afectado por un OrganizationEvent.
  • Requisito previo de habilitación de la API: Para recibir registros de Impact, la API de Service Health (servicehealth.googleapis.com) debe estar habilitada en el proyecto al menos 24 horas antes de que comience el evento. Habilitar la API después de que se inicia un evento reabastece los eventos a nivel del proyecto de los últimos 90 días, pero no reabastece los impactos a nivel del recurso.
  • Ciclo de vida de la duración del evento: Una vez que se identifica que un recurso se ve afectado por un evento, su registro Impact permanece asociado con el evento durante el ciclo de vida del incidente. Usa el recurso Event vinculado para hacer un seguimiento del estado general del incidente (ACTIVE o COMPLETED) y las actualizaciones de las comunicaciones.
  • Productos admitidos y alcance de los incidentes: El impacto a nivel del recurso está disponible para los productos Google Cloud y tipos de recursos admitidos. Si un evento afecta a un producto que no admite el impacto a nivel de recurso o si la interrupción se produce a nivel del plano de control o regional, no vinculada a instancias de recursos individuales, el proyecto Event aún aparece con relevance: IMPACTED, mientras que impacts.list devuelve una lista vacía.

Para consultar los recursos afectados, consulta Administra los eventos que afectan a un proyecto.

Nombres de identidad y nombres visibles de los productos (solo para las versiones alfa y beta)

Para permitir que los administradores identifiquen con rapidez las operaciones sin necesidad de asignaciones locales de identificadores de productos, las entradas de eventos en las versiones v1alpha y v1beta proporcionan cadenas de visualización dentro de los recursos a los que se hace referencia.

Específicamente, dentro de los objetos Product que se indican en las cargas útiles estándar (ubicadas dentro de las colecciones impact en Event y OrganizationEvent), hay dos propiedades nuevas que ayudan con la identificación:

  • display_name (cadena): Es una etiqueta OUTPUT_ONLY que expone títulos de productos legibles por humanos adecuados para las lecturas de los clientes (como "Google Cloud SQL").
  • previous_display_names (cadena repetida): Es un array de OUTPUT_ONLY que detalla todos los títulos que este recurso específico admitía anteriormente. Esto mantiene la continuidad en el seguimiento de los eventos a través de los cambios de marca activos.

Los campos de visualización de productos se aplazan en la plataforma de vGA (v1) para obtener la máxima estabilidad del sistema.

Para determinar los identificadores inmutables correctos que se usarán en los filtros y las alertas, haz lo siguiente:

  1. Abre la guía Productos y ubicaciones admitidos.
  2. Busca el producto de destino Google Cloud en la tabla.
  3. Copia el valor que aparece en ID del producto.

Como alternativa, determina los identificadores inmutables correctos directamente desde las cargas útiles de la API:

  1. Realiza una llamada a la API que devuelva recursos de eventos (como projects.locations.events.list).
  2. Inspecciona las asignaciones de bloques impact en el array de JSON resultante.
  3. Extrae la cadena presente en la propiedad product. Este valor indica el ID del producto estable, independientemente de los diferentes nombres visibles.