En este documento, se describen los tipos de eventos que se pueden mostrar como anotaciones en los gráficos. Un evento es una actividad, como un reinicio o una falla, que afecta el funcionamiento de un sistema. Mostrar eventos puede ayudarte a correlacionar datos de diferentes fuentes cuando solucionas un problema.
Para cada evento, se proporcionan vínculos a referencias o documentación para solucionar problemas, junto con información para consultar el evento. Por ejemplo, cuando se identifican eventos mediante el análisis de tus registros, se proporciona una consulta adecuada para usar con el Explorador de registros o con una política de alertas basada en registros.
Para agregar anotaciones a tus gráficos, configura el panel o la pestaña que muestra el gráfico. Por ejemplo, puedes configurar la mayoría de los paneles que se encuentra en la página Paneles de la consola de Google Cloud para mostrar eventos. De manera similar, puedes configurar algunas pestañas de Observabilidad específicas del servicio, como los de Compute Engine y Google Kubernetes Engine, para mostrar eventos. Para obtener información sobre la configuración, consulta Cómo mostrar eventos en un panel.
En la siguiente captura de pantalla, se muestra un gráfico que muestra varias eventos que se identificaron a través del análisis de entradas de registro, y una Evento de Service Health:
Cada anotación puede enumerar varios eventos. En la captura de pantalla anterior, se muestra un evento para una implementación de GKE.
Tipos de eventos de alerta
En esta sección, se describen los tipos de eventos de alerta que se pueden mostrar en un panel.
Alerta abierta
Los eventos de alerta abierta te ayudan a correlacionar tus datos del gráfico con cuándo incidentes abiertos. Se muestra un evento de alerta abierta cuando se cumplen las siguientes condiciones:
- El incidente correspondiente se abrió durante el intervalo de tiempo especificado por el panel.
- No se cierra el incidente correspondiente.
No se realizan anotaciones para incidentes que se hayan abierto fuera del el intervalo de tiempo especificado por el panel. Del mismo modo, no se muestra un evento de alerta abierta cuando se abrió el incidente correspondiente y, luego, se cerró dentro del intervalo de tiempo especificado por el panel.
La información sobre herramientas de un evento de alerta abierta incluye lo siguiente:
- Nombre de la política de alertas.
- Información resumida, cuando está disponible. Por ejemplo, este información podría incluir el umbral y el valor medido.
- La duración del incidente y la fecha y hora en que se abrió.
- Etiquetas de métricas y recursos. Es posible que la información sobre herramientas no muestre todas las etiquetas.
- Un botón Ver, que abre la página Detalles del incidente.
Tipos de eventos de Google Kubernetes Engine
En esta sección, se describen los tipos de eventos de Google Kubernetes Engine que se pueden que se muestran en un panel.
Carga de trabajo de GKE parcheada o actualizada
Este tipo de evento te ayuda a solucionar problemas de GKE de implementación de cargas de trabajo o StatefulSet, ya que estos eventos pueden correlacionarse regresiones de rendimiento o algún otro problema de rendimiento. Se muestra este tipo de evento cuando se crea, actualiza o borra una carga de trabajo.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=k8s_cluster protoPayload.methodName=(
io.k8s.apps.v1.deployments.create OR io.k8s.apps.v1.deployments.patch OR
io.k8s.apps.v1.deployments.update OR io.k8s.apps.v1.deployments.delete OR
io.k8s.apps.v1.deployments.deletecollection OR io.k8s.apps.v1.statefulsets.create OR
io.k8s.apps.v1.statefulsets.patch OR io.k8s.apps.v1.statefulsets.update OR
io.k8s.apps.v1.statefulsets.delete OR io.k8s.apps.v1.statefulsets.deletecollection OR
io.k8s.apps.v1.daemonsets.create OR io.k8s.apps.v1.daemonsets.patch OR
io.k8s.apps.v1.daemonsets.update OR io.k8s.apps.v1.daemonsets.delete OR
io.k8s.apps.v1.daemonsets.deletecollection
)
-protoPayload.authenticationInfo.principalEmail="system:addon-manager"
-protoPayload.request.metadata.namespace=(kube-system OR gmp-system OR gmp-public OR gke-gmp-system)
Para obtener más información, consulta Descripción general de la implementación de cargas de trabajo y Ver métricas de observabilidad.
Falla de un Pod de GKE
Este tipo de evento te ayuda a identificar y solucionar fallas de pods de GKE. Las fallas de los Pods pueden deberse al agotamiento de la memoria o a un error de la aplicación. Este tipo de evento se muestra cuando ocurre alguna de las siguientes situaciones:
- El estado del pod es
CrashLoopBackoff - El pod finaliza con un código de salida distinto de cero.
- El Pod finaliza con una condición de memoria insuficiente.
- Se expulsa el Pod.
- El sondeo de preparación/funcionamiento falla.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
(
log_id(events)
(
(resource.type=k8s_pod jsonPayload.reason=(BackOff OR Unhealthy OR Killing OR Evicted)) OR
(resource.type=k8s_node jsonPayload.reason=OOMKilling)
)
severity=WARNING
) OR (
log_id(cloudaudit.googleapis.com%2Factivity) resource.type=k8s_cluster
(protoPayload.methodName=io.k8s.core.v1.pods.eviction.create OR
(protoPayload.methodName=io.k8s.core.v1.pods.delete
protoPayload.response.status.containerStatuses.state.terminated.exitCode:*
-protoPayload.response.status.containerStatuses.state.terminated.exitCode=0
)
)
)
Para obtener información sobre la solución de problemas, consulta Solución de problemas: CrashLoopBackOff.
No se pudo programar un pod de GKE
Este tipo de evento te ayuda a identificar y solucionar problemas cuando los Pods no pueden programadas en un nodo. Este tipo de evento se muestra cuando falla la programación de grupos de anuncios por cualquiera de los siguientes motivos:
- CPU del nodo insuficiente
- Memoria de nodo insuficiente.
- No hay nodos para taints o tolerancias.
- Nodos en el límite máximo de pods
- Grupo de nodos con el tamaño máximo
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
(
log_id(events) resource.type=k8s_pod jsonPayload.reason=(NotTriggerScaleUp OR FailedScheduling)
) OR (
log_id(container.googleapis.com/cluster-autoscaler-visibility)
resource.type=k8s_cluster jsonPayload.noDecisionStatus.noScaleUp:*
)
Para obtener información sobre la solución de problemas, consulta Soluciona problemas: Pod no programable.
No se pudo crear un contenedor de GKE
Este tipo de evento te ayuda a identificar y solucionar problemas con las fallas para crear un contenedor de GKE. La creación del contenedor puede fallar debido a por motivos como fallas en las activaciones de volúmenes o las extracciones de imágenes.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
log_id(events) resource.type=k8s_pod jsonPayload.reason=(Failed OR FailedMount) severity=WARNING
Para obtener información sobre la solución de problemas, consulta Solución de problemas: ImagePullBackOff y ErrImagePull.
El escalador de pods aumenta y reduce la escala
Este evento te brinda visibilidad sobre el reescalador de Horizontal Pod Autoscaler, aumentar o disminuir la cantidad de Pods en ejecución para una carga de trabajo. Para obtener más información, consulta Ajuste de escala automático horizontal de Pods.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=k8s_cluster log_id(events) jsonPayload.involvedObject.kind=HorizontalPodAutoscaler jsonPayload.reason=SuccessfulRescale
Aumento y reducción de la escala vertical del escalador automático de clúster
Este evento te permite ver cuándo el escalador automático del clúster aumenta o disminuye la cantidad de nodos en un grupo de nodos de tu clúster. Para obtener más información, Consulta Acerca del ajuste de escala automático de clústeres y Visualiza eventos del escalador automático de clústeres.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
(resource.type=k8s_cluster log_id(container.googleapis.com%2Fcluster-autoscaler-visibility) jsonPayload.decision:*)
Crea y borra clústeres
Este evento realiza un seguimiento de la creación y eliminación de clúster de GKE acciones. Para obtener más información, consulta Crea un clúster de Autopilot, Crea un clúster zonal y Cómo borrar un clúster.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=gke_cluster log_id(cloudaudit.googleapis.com%2Factivity)
protoPayload.methodName=(
google.container.v1alpha1.ClusterManager.CreateCluster OR
google.container.v1beta1.ClusterManager.CreateCluster OR
google.container.v1.ClusterManager.CreateCluster OR
google.container.v1alpha1.ClusterManager.DeleteCluster OR
google.container.v1beta1.ClusterManager.DeleteCluster OR
google.container.v1.ClusterManager.DeleteCluster
)
operation.first=true
Actualización del clúster
Este evento realiza un seguimiento de las actualizaciones de los clústeres de GKE. Las actualizaciones incluyen las actualizaciones automáticas de la versión del plano de control, así como actualizaciones manuales y cambios en la configuración de clúster. Para obtener más información, consulta Actualiza un clúster o grupo de nodos de forma manual y Actualizaciones de clústeres estándar.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=gke_cluster log_id(cloudaudit.googleapis.com%2Factivity)
(
protoPayload.methodName=(
google.container.internal.ClusterManagerInternal.PatchCluster OR
google.container.internal.ClusterManagerInternal.UpdateClusterInternal OR
google.container.internal.ClusterManagerInternal.UpdateCluster
)
) OR (
protoPayload.methodName=(
google.container.v1beta1.ClusterManager.UpdateCluster OR
google.container.v1.ClusterManager.UpdateCluster
)
operation.first=true
)
protoPayload.metadata.operationType=(UPGRADE_MASTER OR REPAIR_CLUSTER OR UPDATE_CLUSTER)
Actualización del grupo de nodos
Este evento realiza un seguimiento de las actualizaciones del grupo de nodos de GKE. Las actualizaciones incluyen actualizaciones automáticas de la versión del grupo de nodos, así como actualizaciones manuales, cambios en la configuración y cambios de tamaño. Para obtener más información, consulta Actualiza un clúster o un grupo de nodos de forma manual y Actualizaciones de clústeres estándar.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=gke_nodepool log_id(cloudaudit.googleapis.com%2Factivity)
(
protoPayload.methodName=(
google.container.internal.ClusterManagerInternal.UpdateClusterInternal OR
google.container.internal.ClusterManagerInternal.RepairNodePool
)
) OR (
protoPayload.methodName=(
google.container.v1beta1.ClusterManager.UpdateNodePool OR
google.container.v1.ClusterManager.UpdateNodePool OR
google.container.v1beta1.ClusterManager.SetNodePoolSize OR
google.container.v1.ClusterManager.SetNodePoolSize OR
google.container.v1beta1.ClusterManager.SetNodePoolManagement OR
google.container.v1.ClusterManager.SetNodePoolManagement OR
google.container.v1beta1.ClusterManager.SetNodePoolAutoscaling OR
google.container.v1.ClusterManager.SetNodePoolAutoscaling
)
operation.first=true
)
Tipos de eventos de Cloud Run
En esta sección, se describen los tipos de eventos de Cloud Run que se pueden mostrar en un panel.
Implementación de Cloud Run
Este tipo de evento te ayuda a identificar y solucionar problemas Fallas de implementación de Cloud Run. La implementación puede fallar por motivos como la eliminación de una cuenta de servicio, permisos incorrectos, la importación de un contenedor fallida o el inicio de un contenedor fallido.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
log_id(cloudaudit.googleapis.com%2Factivity) resource.type=cloud_run_revision protoPayload.methodName=google.cloud.run.v1.Services.ReplaceService
Para obtener información sobre la solución de problemas, consulta Solución de problemas: problemas de Cloud Run.
Tipos de eventos de Cloud SQL
En esta sección, se describen los tipos de eventos de Cloud SQL que se pueden mostrar en un panel.
Conmutación por error de Cloud SQL
Este tipo de evento te ayuda a identificar cuándo ocurren conmutaciones por error manuales o automáticas. Una conmutación por error ocurre cuando hay una falla de instancia o zona, y la instancia en espera se convierte en la nueva instancia principal. Durante una conmutación por error, Cloud SQL cambia automáticamente a entregar datos desde la instancia en espera.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=cloudsql_database
(
(
log_id(cloudaudit.googleapis.com%2Factivity)
protoPayload.methodName=cloudsql.instances.failover
operation.last=true
) OR (
log_id(cloudaudit.googleapis.com%2Fsystem_event)
protoPayload.methodName=cloudsql.instances.autoFailover
)
)
Para obtener más información, consulta Acerca de la alta disponibilidad.
Iniciar o detener Cloud SQL
Este tipo de evento te ayuda a identificar si se inició, detuvo o reinició manualmente una instancia de Cloud SQL. Cuando se detiene una instancia, también se detienen todas las conexiones, los archivos abiertos y las operaciones en ejecución.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
log_id(cloudaudit.googleapis.com%2Factivity) resource.type=cloudsql_database protoPayload.methodName=cloudsql.instances.update operation.last=true protoPayload.metadata.intents.intent=(START_INSTANCE OR STOP_INSTANCE)
Para obtener más información, consulta Acerca de la alta disponibilidad y Inicia, detén y reinicia instancias.
Almacenamiento de Cloud SQL
Este tipo de evento te ayuda a identificar eventos relacionados con el almacenamiento de Cloud SQL, incluidos cuando el almacenamiento de la base de datos está lleno y cuando una base de datos se cierra para alcanzar la capacidad de almacenamiento. Bases de datos con capacidad de almacenamiento y sin el almacenamiento automático habilitado podría cerrarse para evitar que se dañen los datos.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=cloudsql_database
(
(
(log_id(cloudsql.googleapis.com%2Fpostgres.log) OR log_id(cloudsql.googleapis.com%2Fmysql.err))
textPayload=~"No space left on device"
severity=(ERROR OR EMERGENCY)
) OR (
log_id(cloudaudit.googleapis.com%2Fsystem_event)
protoPayload.methodName=cloudsql.instances.databaseShutdownOutOfStorage
)
)
Tipos de eventos de Compute Engine
En esta sección, se describen los tipos de eventos de Compute Engine que se pueden mostrar en un panel.
Cierres de máquinas virtuales
Este tipo de evento te ayuda a identificar los cierres de máquina virtual (VM). incluidos los restablecimientos y las detenciones activados de forma manual, los cierres de SO invitado, las finalizaciones de mantenimiento y los errores de host.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=gce_instance
(
(
log_id(cloudaudit.googleapis.com%2Factivity)
protoPayload.methodName=(
beta.compute.instances.reset OR v1.compute.instances.reset OR
beta.compute.instances.stop OR v1.compute.instances.stop
)
operation.first=true
) OR (
log_id(cloudaudit.googleapis.com%2Fsystem_event)
protoPayload.methodName=(
compute.instances.hostError OR
compute.instances.guestTerminate OR
compute.instances.terminateOnHostMaintenance
)
)
)
Para obtener más información, consulta Iniciar y detener una VM Soluciona problemas de apagado y reinicio de VM.
Falla en el inicio de la instancia de VM
Este evento hace un seguimiento de los errores de inicio de la instancia de VM de Compute Engine. El evento muestra los errores de inicio debido a desabastecimiento, agotamiento del espacio de la IP, cuota excedida, o de integridad de VM protegidas.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=gce_instance
(
(
log_id(cloudaudit.googleapis.com%2Factivity)
protoPayload.methodName=(beta.compute.instances.insert OR v1.compute.instances.insert)
protoPayload.status.message=(ZONE_RESOURCE_POOL_EXHAUSTED OR IP_SPACE_EXHAUSTED OR QUOTA_EXCEEDED)
) OR (
log_id(compute.googleapis.com%2Fshielded_vm_integrity)
severity="ERROR"
)
)
Error de SO invitado de la instancia de VM
Este evento realiza un seguimiento de errores específicos del SO invitado de la instancia de VM de Compute Engine tal como se registra en los registros de la consola en serie. Los errores registrados son disco lleno, fallo en la activación del sistema de archivos y fallos de inicio que activan el modo de emergencia de Linux.
Para que estos eventos sean visibles, debes habilitar el registro de salidas del puerto en serie para
Cloud Logging mediante la configuración de serial-port-logging-enable=true en la VM o en
los metadatos del proyecto. Para obtener más información, consulta Habilita y habilita el registro de salida del puerto en serie.
Si deseas crear una política de alertas basada en registros para este tipo de evento, usa la siguiente consulta:
resource.type=gce_instance
log_id(serialconsole.googleapis.com%2Fserial_port_1_output)
textPayload=~("No space left on device" OR "Failed to mount" OR "You are in emergency mode")
Actualización del grupo de instancias administrado
Este tipo de evento te ayuda a identificar cuándo se actualizó tu grupo de instancias administrado (MIG). Por ejemplo, se agregaron o quitaron VMs, o se actualizó el límite de tamaño. Para obtener más información, consulta Aplica de forma automática las actualizaciones de configuración de VM en un MIG.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=gce_instance_group_manager log_id(cloudaudit.googleapis.com%2Factivity) operation.first=true protoPayload.methodName=(beta.compute.instanceGroupManagers.patch OR v1.compute.instanceGroupManagers.patch)
Para obtener más información, consulta Trabaja con instancias administradas y Cómo solucionar problemas de grupos de instancias administradas.
Escalador automático de grupos de instancias administrado
Este evento hace un seguimiento de las decisiones de escalamiento tomadas por el escalador automático de un MIG. Estas decisiones podrían incluir cambios en el tamaño recomendado de un MIG o un cambio en el estado del escalador automático en sí. Si quieres obtener más información, consulta Ajuste de escala automático para grupos de instancias.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
resource.type=autoscaler log_id(cloudaudit.googleapis.com%2Fsystem_event) protoPayload.methodName=(compute.autoscalers.resize OR compute.autoscalers.changeStatus)
Tipos de eventos de Personalized Service Health
En esta sección, se describen los tipos de Personalized Service Health que se pueden mostrar en un panel.
Incidente de Google Cloud
Cuando soluciones problemas, te recomendamos que diferencies entre las fallas causadas por un servicio que te pertenece y las que causa un servicio de Google Cloud que usas. Cuando habilitas la función Personalized Service Health en un panel puedes ver las interrupciones o los eventos del estado del servicio para los servicios de Google Cloud. Para obtener una lista de los servicios integrados en Service Health, consulta Productos de Google admitidos.
A diferencia de otros tipos de eventos, los incidentes de Google Cloud no se identifican analizando las entradas de registro. Si deseas recibir una notificación cuando ocurran estos eventos, crea una política de alertas. Puedes seleccionar una política de alertas preconfigurada con las opciones de la página Service Health Dashboard. Para obtener más información, consulta la guía de inicio rápido para configurar una alerta.
La supervisión identifica los incidentes de Google Cloud mediante la emisión de una solicitud a la API de Service Health y, luego, filtra la respuesta a aquellos incidentes que son relevantes para los datos que estás viendo. La solicitud tiene la siguiente configuración:
La enumeración
Relevancese establece enRELATED,IMPACTEDoPARTIALLY_RELATED. Esta restricción garantiza que tu panel solo muestra eventos para los servicios de Google Cloud a los que proyecto de Google Cloud.La enumeración
DetailedStateno está configurada enFALSE_POSITIVE.
Las anotaciones de Service Health se muestran con una hora de inicio y una duración. Se muestra la duración cambiando el color de fondo del gráfico. Cuadro de información para un incidente de Google Cloud identifica lo siguiente:
- El servicio de Google Cloud
- Indica si el incidente está abierto o resuelto.
- Fecha y hora de inicio del evento.
- Chips que muestran la cantidad de productos y ubicaciones afectados. Para ver una lista de los productos o las ubicaciones afectados, coloca el puntero en el chip correspondiente.
- Un botón Ver, que cuando se selecciona abre la página de detalles de la el incidente.
Para obtener información sobre cómo enviar una solicitud al la API de Service Health, consulta Verifica si hay interrupciones con Service Health.
Para obtener información sobre la solución de problemas, consulta Soluciona problemas comunes en Service Health.
Tipos de eventos de verificación de tiempo de actividad
En esta sección, se describen los tipos de eventos de verificación de tiempo de actividad que se pueden mostrar en un panel.
Error en la verificación de tiempo de actividad
Este tipo de evento te ayuda a identificar fallas en las verificaciones de tiempo de actividad de los eventos configurados regiones.
Si quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, usa la siguiente consulta:
log_id(monitoring.googleapis.com%2Fuptime_checks) ( resource.type=uptime_url OR resource.type=gce_instance OR resource.type=gae_app OR resource.type=k8s_service OR resource.type=servicedirectory_service OR resource.type=cloud_run_revision OR resource.type=aws_ec2_instance OR resource.type=aws_elb_load_balancer ) labels.uptime_result_type=UptimeCheckResult severity=NOTICE
Para obtener información sobre la solución de problemas, consulta Soluciona problemas de monitores sintéticos y verificaciones de tiempo de actividad.
¿Qué sigue?
Para obtener información sobre cómo mostrar eventos en tus paneles, consulta Cómo mostrar eventos en un panel.