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 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 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. Es una categoría de un evento de Service Health.

Un incidente incluye lo siguiente:

• Impacto del incidente: Son los detalles del alcance del evento, como los productos y las ubicaciones deGoogle Cloud afectados.
• Actualizaciones de Google Cloud: Actualizaciones periódicas de la asistencia de Google 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.

Un incidente puede tener un informe de incidentes, que incluye los factores que contribuyeron al incidente y los pasos que Google Cloud planea tomar para evitar que vuelvan a ocurrir 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 proyectos de 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 o 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 la investigación, 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 se vuelva a abrir el incidente.

Estado de interrupción detallado

Durante un incidente que afecta a varios productos o ubicaciones, es posible que los productos o las ubicaciones individuales se recuperen 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.

Nota: Las alertas configuradas en Cloud Logging se aplican a las revisiones generales de eventos y a los cambios de estado, no a las transiciones de estado detalladas y aisladas para productos o ubicaciones individuales.

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 describe cómo un incidente afecta tu proyecto. La relevancia puede cambiar a medida que avanza el incidente.

La relevancia puede tener los siguientes valores:

• Afectado: Se verificó que el incidente afecta a tu proyecto. Solo está disponible para algunos productos de Google Cloud .
• 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 usa 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.

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.

Nota: Los campos display_name y previous_display_name tienen fines de visualización y pueden cambiar como resultado del cambio de marca del producto. Para la lógica programática (llamadas a la API y políticas de alertas), usa IDs de productos estables.

Los campos de visualización de productos se aplazan en la plataforma de vGA (v1) para lograr 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 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.