En este documento, se describe cómo configurar un panel para que muestre anotaciones de eventos. Un evento es una actividad, como una implementación o una falla, que afecta el funcionamiento de un sistema. Mostrar anotaciones de eventos puede ayudarte a correlacionar datos de diferentes fuentes cuando solucionas un problema.
Acerca de las anotaciones de eventos
Puedes mostrar eventos en la mayoría de los paneles enumerados en el En la página Paneles de la consola de Google Cloud. 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 configurar los tipos de eventos que se muestran en un panel o en una pestaña Observabilidad, puedes usar la consola de Google Cloud. Para los paneles que creas, que se clasifican como paneles personalizados, también puedes usar la API de Cloud Monitoring.
A menos que uses la API de Cloud Monitoring o realices una acción para guardar tu selecciones de tipo de evento, las que elijas solo se aplicarán a tu sesión actual. Cuando usas la consola de Google Cloud, cuando fijas tus selecciones, se guardan.
Para obtener una lista de tipos de eventos, referencias de solución de problemas y otra información, consulta la página Tipos de eventos.
Tipos de eventos recomendados
Es posible que veas los siguientes tipos de eventos habilitados en un panel o en una La pestaña Observabilidad, aunque no hayas seleccionado ningún tipo de evento:
- Alerta abierta.
- incidentes de Personalized Service Health, cuando la API de Service Health está habilitada.
- Para cada tipo de resource con datos en la panel, un tipo de evento.
Cuando se agrega un tipo de evento automáticamente, es un tipo de evento recomendado. Puedes dejar estos tipos de eventos en el estado recomendado y guardarlos en el panel JSON o descartarlos, lo que quita la recomendación. Para determinar qué tipos de eventos se guardan, expande el menú Select Event Types y, luego, consulta la sección Fijados.
Cómo se identifican los eventos
Los paneles consultan diferentes fuentes de datos para identificar los eventos para mostrar en tu panel:
Los eventos de alerta se identifican por Supervisión Los eventos de alerta proporcionan información sobre cuándo incidentes.
Los eventos de Custom Service Health se identifican por lo siguiente: las consultas que Monitoring envía a la API de Service Health. Estos eventos indican cuando se produce una interrupción en un servicio de Google Cloud.
Todos los demás tipos de eventos se identifican analizando las entradas de registro que pasar a través de los receptores de Cloud Logging en tu proyecto de Google Cloud. Estas entradas de registro incluyen las que genera tu proyecto y aquellos enrutados a tu proyecto. Para recibir una notificación cuando ocurra uno de estos eventos, puedes crear una política de alertas basada en registros. En la política de alertas, usa las consultas que se proporcionan en la página Tipos de eventos.
Cómo se muestran los eventos
Para todos los eventos, a medida que ocurren, los gráficos del panel se muestran anotado. Los eventos identificados a través del análisis de entradas de registro se muestran con una sola referencia temporal. En cambio, los eventos de Service Health se muestran una hora de inicio y, luego, el fondo del gráfico se cambia a lo largo de la duración del evento. Estos eventos también muestran un ícono de corazón.
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:
Como se muestra en la captura de pantalla anterior, el cuadro de información de un evento incluye información como la siguiente:
- Nombre del evento.
- Fecha y hora de inicio del evento.
- Para los eventos de Service Health, los chips que muestran la cantidad de las ubicaciones y los productos afectados. Para enumerar los productos o las ubicaciones afectados, coloca tu puntero en el correspondiente.
- Un botón Ver, que cuando se selecciona abre una página que muestra más información adicional sobre el evento. Por ejemplo, podría abrir el Explorador de registros, para que puedas ver las entradas de registro, o bien puede abrir la página de detalles para un evento de Service Health.
Los filtros de panel, que limitan los datos que muestra un panel, por lo general, filtran tanto datos como eventos de series temporales.
Antes de comenzar
-
A fin de obtener los permisos que necesitas para ver y mostrar eventos en los paneles, y para crear políticas de alertas solicita a tu administrador que te otorgue el los siguientes roles de IAM en tu proyecto:
-
Visualiza y crea paneles y políticas de alertas:
Editor de Monitoring (
roles/monitoring.editor
). -
Visualiza y muestra eventos identificados a partir de entradas de registro de acceso a los datos que se crearon en tu proyecto de Google Cloud:
Visor de registros (
roles/logging.viewer
). -
Visualiza y muestra los eventos identificados a partir de las entradas de registro que se crearon en tu proyecto de Google Cloud:
Visualizador de registros privados (
roles/logging.privateLogViewer
). -
Visualiza los eventos de Service Health:
Visualizador de Custom Service Health (
roles/servicehealth.viewer
)
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
-
Visualiza y crea paneles y políticas de alertas:
Editor de Monitoring (
Si quieres mostrar eventos de Service Health en tu y habilita la API de Service Health:
Mostrar eventos
En esta sección, se describe cómo configurar un panel o una pestaña Observabilidad. para mostrar eventos.
Configura paneles para mostrar eventos
En esta sección, se describe cómo configurar los paneles que se enumeran en En la página Paneles de la consola de Google Cloud, se muestran los eventos.
Obtén una lista de tipos de eventos, referencias para solucionar problemas y consultas que puede usarse con el Explorador de registros o con políticas de alertas basadas en registros, consulta la página Tipos de eventos.
Console
Para mostrar eventos en un panel, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página Paneles.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona el panel que deseas ver.
En la barra de herramientas del panel, asegúrate de que El botón de activación de Eventos está activado.
Si el botón de activación de Eventos no se muestra, el el panel no puede mostrar eventos.
Haz clic en Seleccionar tipos de eventos, selecciona los tipos de eventos en los que deseas panel para mostrar y, luego, realiza una de las siguientes acciones:
Si estás viendo un panel personalizado y quieres guardar tu tipo de evento selecciones y, luego, haz clic en Fijar los elementos seleccionados. Si tienes inhabilitado el guardado automático, haz lo siguiente: en tu panel, ve a la barra de herramientas del panel y Haz clic en Guardar.
Cuando fijas tus selecciones, modificas la definición JSON de la o un panel dinámico más robusto. Por lo tanto, cuando se vuelva a abrir el panel, tus selecciones se cargan y en el panel se muestran anotaciones de los tipos de eventos.
De lo contrario, haz clic en OK.
Después de actualizar la lista de tipos de eventos para mostrar, Cloud Monitoring emite consultas, lo que tarda un momento y, luego, agrega las anotaciones a los gráficos del panel.
Para ver el resumen de un evento o acceder a vínculos a información adicional, haz lo siguiente: usa el puntero para activar la información.
API
Si deseas configurar un panel personalizado para que muestre eventos,
Incluye un campo annotations
en el objeto Dashboard
.
El campo annotations
contiene una instancia de un objeto DashboardAnnotations
.
que contiene dos campos:
El campo
defaultResourceName
enumera los valores predeterminados a nivel del panel para Proyectos de Google Cloud para buscar eventos. Si no especificas este campo, y, luego, se busca el proyecto seleccionado.Un array de objetos
EventAnnotation
. Cada contiene lo siguiente:- Un campo
displayName
, que te permite definir la etiqueta en la botón de activación específico del evento. Cuando no se especifica este campo o cuando el valor de este campo es una cadena vacía, se muestra el nombre predeterminado del evento. - Un campo
enabled
, que controla el valor del botón de activación del evento Cuando seatrue
, el botón de activación estará en la posiciónon
y se mostrarán los eventos en el panel. Cuando esfalse
, el botón de activación está en la posiciónoff
. - Un campo
eventType
, que contiene un valor deEventType
enumeración. - Un campo
filter
, que te permite especificar una consulta para adjuntar al en una consulta específica del evento. Cuando el valor de este campo es una cadena vacía, y, luego, se usa la consulta específica del evento. - Un campo
resourceNames
, que te permite definir una lista de Proyectos de Google Cloud para buscar eventos. Cuando este campo si es un array vacío, se busca el proyecto seleccionado.
- Un campo
A continuación, se muestra un objeto annotations
de ejemplo para una actualización del clúster
para cada evento. En este ejemplo, el campo filter
restringe los eventos a un
clúster específico:
"annotations": {
"defaultResourceNames": [],
"eventAnnotations": [
{
"displayName": "",
"enabled": true,
"eventType": "GKE_CLUSTER_UPDATE",
"filter": "resource.labels.cluster_name=my-cluster",
"resourceNames": []
}
]
}
Para obtener información detallada sobre cómo usar la API de Cloud Monitoring para crear paneles, consulta Crear y administrar paneles por API y Ejemplo: Habilita los eventos en los paneles.
Configura la pestaña Observabilidad para mostrar eventos
En esta sección, se describe cómo configurar la observabilidad, para mostrar los eventos. Algunos servicios, como Compute Engine y Google Kubernetes Engine, proporcionan una pestaña Observabilidad que muestre datos de registro y métricas.
Console
Si deseas configurar la pestaña Observabilidad para que muestre eventos, haz lo siguiente:
Ve a la pestaña Observabilidad de un servicio o producto.
Por ejemplo, podrías ir a la página Clústeres de Kubernetes y, luego, selecciona la pestaña Observabilidad. De forma similar, puedes ir a la a la página Cargas de trabajo de Kubernetes o a la página de detalles de un de máquina virtual (VM) y, luego, selecciona la pestaña Observabilidad.
Asegúrate de que el menú Panel esté configurado como Predefinido. No se pueden mostrar eventos en paneles personalizados.
En la barra de herramientas, haz clic en event_available Select Events, y completa el diálogo.
Después de actualizar la lista de eventos para mostrar, se envían las búsquedas a recuperar los datos del evento y, luego, se actualiza el panel.
Cuando el botón event_available Seleccionar eventos no esté , la pestaña no se puede configurar para que muestre eventos.
API
No disponible.
Ver detalles del evento
En un gráfico que muestra anotaciones de eventos, puedes usar los vínculos proporcionados en el cuadro de información para acceder a información.
Para acceder a los detalles de un evento específico, haz clic en Ver.
La página de la consola de Google Cloud que se abre con el botón Ver está determinada por el tipo de evento. Por ejemplo, para un evento de verificación de tiempo de actividad, este botón abre el panel de la verificación de tiempo de actividad. Para un cambio de registro, se abrirá el Explorador de registros.
Crea políticas de alertas
Cuando se identifican eventos a través del análisis de las entradas de registro que pasar por los receptores de Cloud Logging de tu proyecto de Google Cloud, pueden recibir notificaciones cuando ocurren estos eventos Configurar una alerta basada en registros Consulta sobre políticas de alertas basadas en registros tus entradas de registro a medida que se reciben. Cuando la consulta devuelve un campo resultado, se crea un incidente y se envían notificaciones.
Console
Para crear una alerta basada en registros, haz lo siguiente:
Si no configuraste un canal de notificaciones, haz lo siguiente:
-
En la consola de Google Cloud, ve a la página notifications Alertas.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Haz clic en Editar canal de notificaciones.
- Ve al tipo de canal de notificaciones que quieres configurar. Haz clic en Agregar nuevo y, luego, completa el cuadro de diálogo.
-
-
En la consola de Google Cloud, ve a la página Explorador de registros.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
En la barra de herramientas, selecciona Crear alerta.
Ingresa un nombre para la política de alertas y, luego, haz clic en Siguiente.
En la sección Define las entradas de registro para alertar sobre, haz lo siguiente: ingresa una consulta o actualiza la que se copió del panel Consulta. cuando seleccionaste Crear alerta.
Para cada tipo de evento, la página Tipos de evento enumera un que sea adecuada para usarse en una política de alertas basada en registros.
Completa el cuadro de diálogo y haz clic en Guardar.
API
Para crear una política de alertas basada en registros con la API de Cloud Monitoring, sigue estos pasos: haz lo siguiente:
Identifica la consulta que se incluirá en la condición del política de alertas. Para cada tipo de evento, el En la página Tipos de eventos, se muestra una lista con que sea adecuada para usarse en una política de alertas basada en registros.
Crea el archivo JSON que contiene la representación de la alerta política de la empresa. Para obtener más información sobre este paso y un ejemplo, consulta Diseña la política de alertas.
Invoca el método de la API alertPolicies.create. Por ejemplo, puedes emitir el
gcloud alpha monitoring policies create
kubectl.
Ocultar eventos
Console
Para ocultar todos los eventos, en la barra de herramientas del panel, Asegúrate de que el botón de activación toggle_off Eventos esté desactivado.
Para ocultar un tipo de evento, desactiva el botón de activación de ese tipo de evento. posición.
API
Para ocultar un tipo de evento en un panel personalizado, busca el
Un objeto EventAnnotation
para el tipo de evento
y, luego, establece el campo enabled
en false
.
Para obtener información detallada sobre cómo usar la API de Cloud Monitoring, consulta Crea y administra paneles por API.
¿Qué sigue?
- Comparte un panel personalizado
- Explora los datos del gráfico
- Accede a paneles específicos de los recursos
- Agrega filtros temporales a los paneles personalizados
- Agrega filtros permanentes a los paneles personalizados