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 distintas fuentes para solucionar problemas un problema.
Para cada evento, se incluyen vínculos a referencias o documentación junto con información para hacer consultas sobre el evento. Por ejemplo, cuando los eventos se identifican a través del análisis de tus registros una consulta adecuada para usar con el Explorador de registros o con una siempre que se proporcione una política de alertas.
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 Muestra 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 un 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 pueden mostrarse en una o un panel dinámico más robusto.
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 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. De manera similar, un no se muestra el evento de alerta abierta cuando se abrió el incidente correspondiente y, luego, se cierra dentro del intervalo de tiempo especificado en el panel.
La información sobre la herramienta para un evento de alerta abierta incluye lo siguiente:
- Nombre de la política de alertas.
- Información resumida, cuando está disponible. Por ejemplo, esta podría incluir el umbral y el valor medido.
- La duración del incidente, además de la fecha y hora cuando se abrió el incidente.
- Etiquetas de métricas y recursos. Es posible que la información sobre la herramienta 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 muestra en un panel.
Carga de trabajo de GKE con parches 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 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 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 problemas el Pod de GKE falla. 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:
- No hay suficiente CPU de nodo.
- Memoria de nodo insuficiente.
- No hay nodos para taints o tolerancias.
- Nodos en el límite máximo de Pods.
- El grupo de nodos tiene el tamaño máximo.
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=(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 Solución de 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 errores en las activaciones de volúmenes o en las extracciones de imágenes.
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=(Failed OR FailedMount) severity=WARNING
Para obtener información sobre la solución de problemas, consulta Solución de problemas: ImagePullBackOff y ErrImagePull.
Aumento y reducción de la escala vertical del escalador automático de Pods
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 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(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 escala verticalmente o o reducir la cantidad de nodos de 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 Crear un clúster de Autopilot, Crea un clúster zonal y Borra 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 actualizaciones automáticas de versiones del plano de control, así como actualizaciones manuales cambios en la configuración del clúster. 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 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 un grupo de nodos automático de versiones, así como actualizaciones manuales, cambios de 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 quieres Crea una política de alertas basada en registros para esto. tipo de evento y, luego, 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 que se muestra 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. Deployment puede fallar por algunos motivos como una cuenta de servicio borrada, permisos incorrectos, la importación de un contenedor falló o no se pudo iniciar un contenedor.
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=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 que se muestra en un panel.
Conmutación por error de Cloud SQL
Este tipo de evento te ayuda a identificar cuándo se producen conmutaciones por error manuales o automáticas. Una conmutación por error ocurre cuando hay una falla de instancia o zona la instancia en espera se convierte en la instancia principal nueva. Durante una conmutación por error, Cloud SQL cambia automáticamente a la entrega de 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 una instancia de Cloud SQL que se haya iniciar, detener o reiniciar. Cuando se detiene una instancia, todas las conexiones, archivos abiertos y también se detienen 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 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(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 que se muestran 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 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.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.
Error de inicio de 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 del 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 como que registran los registros de la consola en serie. Los errores rastreados son disco lleno, archivo y fallas de inicio del sistema 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 o inhabilita el registro de salidas de puertos en serie.
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(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 tu grupo de instancias administrado (MIG) tiene se actualizaron. Por ejemplo, si 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 Trabajar con instancias administradas y Soluciona problemas de grupos de instancias administrados.
Escalador automático de grupo 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 estés solucionando problemas, puedes diferenciar fallas causadas por un servicio de tu propiedad y una causada por un servicio de Google Cloud que uses. 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 tus entradas de registro. Si quieres recibir notificaciones cuando ocurran estos eventos, crear una política de alertas. Puedes seleccionar una política de alertas preconfigurada con las opciones de la página Panel de estado del servicio. Para obtener más información, consulta la guía de inicio rápido para configurar una alerta.
La supervisión identifica incidentes de Google Cloud emitiendo una solicitud a la API de Service Health y, luego, filtrando a los incidentes que son relevantes para los datos que está viendo. La solicitud tiene la siguiente configuración:
La enumeración
Relevance
se establece enRELATED
,IMPACTED
oPARTIALLY_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
DetailedState
no está establecida comoFALSE_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
- 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 enumerar los productos o las ubicaciones afectados, coloca tu puntero en el 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 una o un panel dinámico más robusto.
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 Muestra eventos en un panel.