En este documento, se describe cómo crear y administrar tus alertas pospuestas. Una alerta pospuesta impide que Cloud Monitoring haga lo siguiente: crear incidentes y emitir notificaciones durante una durante un período específico. Cada alerta pospuesta especifica los recursos a los que se aplica.
Para obtener una descripción general conceptual, consulta Posponer notificaciones e incidentes.
Para crear y administrar las alertas pospuestas, usa la consola de Google Cloud API de Cloud Monitoring.
Antes de comenzar
Asegúrate de tener los permisos necesarios:
-
A fin de obtener los permisos que necesitas para ver y editar las alertas pospuestas con la consola de Google Cloud , solicita a tu administrador que te otorgue el Rol de IAM de Editor de Monitoring (
roles/monitoring.editor
) en tu proyecto. 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.
-
A fin de obtener los permisos que necesitas para ver y editar las alertas pospuestas con la API de Cloud Monitoring , solicita a tu administrador que te otorgue el Rol de IAM de Editor de alertas de Monitoring (
roles/monitoring.snoozeEditor
) en tu proyecto. 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.
Para obtener más información sobre los roles de Cloud Monitoring, consulta Controla el acceso con Identity and Access Management.
-
Si deseas usar los ejemplos de la API de Cloud Monitoring incluidos en este documento, haz lo siguiente:
Crea una variable de entorno,
PROJECT_ID
, para conservar el ID de tu Proyecto de Google Cloud:PROJECT_ID=PROJECT_ID
Autentícate en Google Cloud CLI:
gcloud auth login
Configura el proyecto predeterminado de Google Cloud:
gcloud config set project ${PROJECT_ID}
Crea un token de autorización:
ACCESS_TOKEN=`gcloud auth print-access-token`
Deberás actualizar el token de acceso de forma periódica. Si los comandos que funcionaban de repente informan que no estás autenticado, vuelve a emitir este comando.
Cómo crear una alerta para posponer
Para evitar que las políticas de alertas creen incidentes y envíen notificaciones, crear una alerta pospuesta.
Puedes crear una alerta pospuesta con la consola de Google Cloud, gcloud CLI o la API de Cloud Monitoring.
Console
-
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.
- Para crear una alerta pospuesta a partir de un incidente abierto, haz lo siguiente:
- En el panel Incidentes de la página Alerting, busca tu incidente y haga clic en el Resumen de incidentes.
- En la página Detalles del incidente, haz clic en Posponer y, luego, selecciona la duración de la posposición. No puedes configurar otros campos.
De lo contrario, haz lo siguiente:
- En la página Alertas, haz clic en Crear alerta pospuesta.
- Ingresa un nombre descriptivo para la función de posponer. Este nombre aparece en el Alertas.
- Selecciona una Hora de inicio. Puedes ingresar un horario específico o iniciar la posponer cuando se crea.
- Ingresa la Duración. El valor de este campo determina por cuánto tiempo la alarma dura menos.
Completa la sección Criterios de posposición. Puedes usar la El menú Políticas de alertas para seleccionar las políticas de alertas a las que se aplica la alerta pospuesta.
Puedes agregar hasta 16 políticas de alertas a un posponer.
Después de completar la sección Criterios de posposición, aparecerá el menú Crear alerta pospuesta un panel enumera los incidentes pasados que coinciden con los criterios.
Haz clic en Crear.
API de Cloud Monitoring
Para crear una alerta pospuesta, invoca la función snoozes.create
.
a través de la emisión de una solicitud POST
al extremo Snooze
.
Debes proporcionar un objeto snooze
:
curl -d @my-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \ -H 'Content-Type: application/json' \ -X POST https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes
El método devuelve un objeto snooze
. El campo "name"
que incluye el ID de posponer que genera Monitoring,
es la única diferencia entre el objeto devuelto y el
contenido de my-snooze.json
:
{
"name": "projects/my-project/snoozes/2986666341878464512",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-12T19:00:20Z",
"endTime": "2022-11-12T19:05:20Z"
},
"displayName": "Snooze2"
}
gcloud CLI
Para crear una alerta pospuesta, ejecuta la
Comando gcloud monitoring snoozes create
:
gcloud monitoring snoozes create --criteria-policies=LIST_OF_POLICIES --display-name=DISPLAY_NAME --start-time=START_TIME --end-time=END_TIME
En el comando anterior, el end-time
debe ser al menos un minuto posterior.
que start-time
. Debe seguir las reglas de formato ISO 8601. Sin embargo,
puedes especificar horas absolutas o relativas. En el siguiente ejemplo, se especifica
tiempos absolutos. Para comenzar a posponer una alarma 30 minutos desde la hora actual, usa
--start-time="+PTM30M"
Si especificas varios proyectos, sepáralos con una coma.
Por ejemplo, el siguiente comando crea una alerta pospuesta con el nombre visible de “Semana de mantenimiento”. La alerta pospuesta se aplica a dos políticas de alertas y abarca desde el primero de marzo hasta el siete de marzo:
gcloud monitoring snoozes create --display-name="Maintenance Week" \ --criteria-policies="projects/my-project/alertPolicies/12345,projects/my-project/alertPolicies/23451" \ --start-time="2023-03-01T03:00:00.0-0500" \ --end-time="2023-03-07T23:59:59.5-0500"
En el ejemplo anterior, se crea la siguiente alerta pospuesta en my-project
:
{ "name": "projects/my-project/snoozes/98765", "displayName": "Maintenance Week", "interval": { "startTime": "2023-03-01T08:00:00Z", "endTime": "2023-03-08T04:59:59Z" }, "criteria": { "policies": [ "projects/my-project/alertPolicies/12345", "projects/my-project/alertPolicies/23451", ] } }
Si se ejecuta de forma correcta, la respuesta a este comando es similar a la siguiente:
Created snooze [projects/my-project/snoozes/98765]
El nombre de una política de alertas no se muestra en la consola de Google Cloud. Para determinar el nombre de una política de alertas, realiza una de las siguientes acciones:
- Ejecuta el comando
gcloud alpha monitoring policies list
. Los datos de respuesta incluye el nombre de tus políticas de alertas. - Visualiza la representación JSON de una política de alertas. Puedes descargar el JSON en tu sistema local con una opción en el Detalles de la política.
Crea alertas pospuestas recurrentes
Para crear alertas pospuestas que se produzcan en intervalos recurrentes, puedes escribir una secuencia de comandos
que crea una alerta pospuesta
para una política de alertas. Luego, usa un programador de trabajos, como
cron
o Cloud Scheduler para ejecutar la secuencia de comandos en los recursos requeridos
de un proyecto.
Mostrar alertas pospuestas
Cuando creas una alerta pospuesta, esta se agrega al registro histórico de alertas pospuestas. para tu proyecto. En este registro, se muestran los datos vencidos, activos y próximos. alertas pospuestas. No puedes quitar entradas de este registro, es decir, una alerta pospuesta. Sin embargo, desde esta vista, puedes mostrar los detalles de una función para posponer y puedes realizar acciones como editar o copiar la alerta pospuesta.
Console
Para ver una lista de las alertas pospuestas, sigue estos pasos:
-
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 Ver todas las alertas pospuestas en el panel Posponer.
En la página Posponer, se muestra una lista de las alertas pospuestas y una línea de tiempo que muestra gráficamente tus alertas pospuestas pasadas, próximas y activas.
- Para editar, copiar, cancelar o finalizar una alerta pospuesta, usa el more_vert Menú Más opciones del elemento posponer. El estado de posponer determina qué opciones estarán disponibles.
- Para enumerar todas las alertas pospuestas, habilita Mostrar alertas pospuestas anteriores. De forma predeterminada, solo aparecerán las alertas pospuestas activas y futuras.
- Para cambiar el período de visualización de la tabla Cronograma, usa la Menú Intervalo de tiempo De forma predeterminada, la tabla muestra los datos de la próxima hora; Sin embargo, puedes modificar este campo para especificar intervalos de tiempo pasados o futuros. Las alertas pospuestas vencidas se conservan durante 13 meses.
- Para ver los detalles de una alerta pospuesta específica, haz clic en Ver detalles.
- Para ver un resumen de las alertas pospuestas activas, coloca el cursor en área sombreada de la fila Activo en la tabla Cronograma. La información sobre la herramienta muestra la información de resumen.
- Para ver una representación gráfica de las alertas pospuestas activas, haz lo siguiente: Expande la fila Activo de la tabla Cronograma.
API de Cloud Monitoring
Para enumerar todas las alertas pospuestas que pertenecen a un proyecto de Google Cloud, invoca el
Método snoozes.list
:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes
El método muestra una lista de objetos snooze
. Por ejemplo:
Cuando un proyecto tiene una alerta pospuesta, la respuesta al comando snoozes.list
es similar a lo siguiente:
{
"snoozes": [
{
"name": "projects/my-project/snoozes/2986663705844383744",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-08T19:00:20Z",
"endTime": "2022-11-08T19:05:20Z"
},
"displayName": "Snooze1"
}
]
}
Para obtener información sobre una alerta pospuesta específica, invoca
Método snoozes.get
y especifica el ID del proyecto
y el ID de la alerta pospuesta. En la respuesta anterior,
el ID de posponer es 2986663705844383744
:
curl -H "Authorization: Bearer $ACCESS_TOKEN" \ https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}
El método muestra un solo objeto snooze
:
{
"name": "projects/my-project/snoozes/2986663705844383744",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/787884840895011889"
]
},
"interval": {
"startTime": "2022-11-08T19:00:20Z",
"endTime": "2022-11-08T19:05:20Z"
},
"displayName": "Snooze1"
}
gcloud CLI
Para mostrar las alertas pospuestas de tu proyecto actual, ejecuta
Comando gcloud monitoring snoozes list
:
gcloud monitoring snoozes list OPTIONAL_FLAGS
Para obtener más información sobre las marcas opcionales, consulta la
Página de referencia de gcloud monitoring snoozes list
La respuesta a este comando es una lista de los nombres de las alertas pospuestas del proyecto.
en formato YAML. Por ejemplo, la respuesta a este comando para la
El proyecto de Google Cloud con el ID my-project
es una entrada única:
criteria: policies: - projects/my-project/alertPolicies/12345 - projects/my-project/alertPolicies/23451 displayName: Maintenance Week interval: endTime: '2023-03-08T04:59:59Z' startTime: '2023-03-01T08:00:00Z' name: projects/my-project/snoozes/98765
Para enumerar los detalles de una alerta pospuesta específica, ejecuta el
Comando gcloud monitoring snoozes describe
:
gcloud monitoring snoozes describe NAME
Por ejemplo, para mostrar los detalles de la función de posponer con el nombre
projects/my-project/snoozes/98765
, ejecuta el siguiente comando:
gcloud monitoring snoozes describe projects/my-project/snoozes/98765
Si proporcionas un NAME no válido a un comando describe
, el
contiene un código de error 500
y el siguiente mensaje:
Internal error encountered. Please retry after a few seconds. If internal errors persist, contact support at https://cloud.google.com/support/docs.
Cómo editar una alerta pospuesta
Puedes editar el nombre y el período de una próxima alerta pospuesta, así como la el nombre y la hora de finalización de una alerta pospuesta activa. Por ejemplo, cuando un período de mantenimiento se reprogramó, tal vez debas editar una alerta pospuesta.
No puedes editar una alerta pospuesta anterior ni los criterios de ninguna alerta pospuesta. Sin embargo, si quieres para programar una alerta pospuesta para un período futuro y, a continuación, copia las notificaciones aplicar cambios a la copia antes de seleccionar Crear.
Console
Para editar una alerta pospuesta, sigue estos pasos:
-
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 Ver todas las alertas pospuestas en el panel Posponer.
- En la lista de alertas pospuestas, busca la que deseas editar y, luego, Selecciona Editar alerta pospuesta en el menú more_vert Más opciones.
- Haz clic en Guardar después de completar los cambios.
API de Cloud Monitoring
Para modificar una alerta pospuesta existente, invoca la función snoozes.patch
.
a través de la emisión de una solicitud PATCH
al extremo Snooze
.
Debes proporcionar el objeto snooze
revisado y, luego, incluir
parámetros de consulta que identifican qué campos se modifican. Cuando usas curl,
los parámetros de consulta deben estar codificados en formato URL.
Para las próximas alertas pospuestas, puedes modificar el nombre y el punto. Para actividades pospuestas, puedes modificar el nombre y la hora de finalización. No puedes modificar alertas pospuestas anteriores.
Para actualizar el displayName
de una alerta pospuesta, crea un archivo JSON.
my-updated-snooze.json
, que describe el objeto que se pospone y actualiza la
nombre visible. Luego, ejecuta el comando siguiente:
curl -d @my-updated-snooze.json -H "Authorization: Bearer $ACCESS_TOKEN" \ -H 'Content-Type: application/json' \ -X PATCH https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}?updateMask=displayName
El método devuelve un objeto snooze
idéntico al
contenido del archivo my-updated-snooze.json
:
{
"name": "projects/my-project/snoozes/2986665388391530496",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/7164333552684403347"
]
},
"interval": {
"startTime": "2022-11-08T22:26:05Z",
"endTime": "2022-11-08T22:31:05Z"
},
"displayName": "Updated snooze name"
}
gcloud CLI
Para editar una alerta pospuesta, ejecuta la
Comando gcloud monitoring snoozes update
. Puedes actualizar
el nombre visible, la hora de inicio y la hora de finalización:
gcloud monitoring snoozes update NAME OPTIONAL_FLAGS
Si deseas obtener una lista de opciones para el comando update
, consulta la
Página de referencia de gcloud monitoring snoozes update
.
Por ejemplo, para cambiar el nombre visible de la alerta pospuesta con el nombre
projects/my-project/snoozes/98765
, ejecuta el siguiente comando:
gcloud monitoring snoozes update projects/my-project/snoozes/98765 --display-name="March Maintenance"
Cómo finalizar o cancelar una función para posponer
Si quieres recibir notificaciones de recursos que coinciden con los criterios especificada en una alerta pospuesta activa, y luego finalizar la función. Por ejemplo, cuando se planifica el mantenimiento se completa más rápido de lo previsto, es posible que desees finalizar posponer.
Si tienes una próxima alerta pospuesta que ya no quieres, cancélala. La operación de cancelación establece la duración en cero y da como resultado la función de posponer transición al estado Past.
Console
Para finalizar una alerta pospuesta activa o cancelar una alerta pospuesta siguiente, sigue estos pasos:
-
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 Ver todas las alertas pospuestas en el panel Posponer.
En la lista de alertas pospuestas, busca la que quieres finalizar o cancelar. y, luego, realiza una de las siguientes acciones:
- Para finalizar una alerta pospuesta activa, selecciona Finalizar ahora en la more_vert Menú Más opciones
- Para cancelar una alerta pospuesta próxima, selecciona Cancelar alarma en la more_vert Menú Más opciones
API de Cloud Monitoring
Para finalizar una alerta pospuesta activa, edítala y establece la hora de finalización en hora actual. Para obtener más información, consulta Cómo editar una alerta pospuesta.
Para cancelar una alerta pospuesta siguiente, edítala y establece la hora de finalización en posponer la hora de inicio La hora de inicio debe ser en el futuro. Para obtener más información, consulta Cómo editar una alerta pospuesta.
gcloud CLI
Para finalizar una alerta pospuesta activa o cancelar una alerta pospuesta siguiente, ejecuta la
Comando gcloud monitoring snoozes cancel
:
gcloud monitoring snoozes cancel NAME
Por ejemplo, para cancelar la función de posponer con el nombre
projects/my-project/snoozes/98765
, ejecuta el siguiente comando:
gcloud monitoring snoozes cancel projects/my-project/snoozes/98765
Cómo copiar una alerta pospuesta
Si quieres usar una alerta pospuesta existente como plantilla para otra alerta pospuesta, haz una copia. Cuando copias una alerta pospuesta, El editor de posponer se abre con todos los campos excepto la hora de inicio. configurado en los valores de la alerta pospuesta original. Puedes modificar todos los campos antes de hacer clic en Crear.
Para copiar una alerta pospuesta mediante la consola, 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 Ver todas las alertas pospuestas en el panel Posponer.
- En la lista de alertas pospuestas, busca la que deseas editar y, luego, Selecciona Copiar alerta pospuesta en el menú more_vert Más opciones.
- Aplica tus modificaciones a la copia y, luego, haz clic en Crear.
¿Qué sigue?
Para obtener una descripción general de las alertas, consulta Descripción general de las alertas.
Para obtener información sobre la latencia de las notificaciones y la manera en que las opciones para la de una política de alertas afectan el momento en que se envían notificaciones consulta Comportamiento de las políticas de alertas basadas en métricas.
Para obtener información sobre los incidentes, consulta los siguientes documentos: