En este documento, se describe cómo crear y administrar tus pospones. La posposición evita que Cloud Monitoring creé incidentes y emita notificaciones durante un período específico. Cada posposición especifica los recursos a los que se aplica.
Para obtener una descripción general conceptual, consulta Posponer notificaciones e incidentes.
Para crear y administrar tus posposiciones, usa la consola de Google Cloud o la API de Cloud Monitoring.
Esta función solo es compatible con proyectos de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
Antes de comenzar
Completa lo siguiente en el proyecto de Google Cloud que almacena tu política de alertas:
Asegúrate de tener los permisos necesarios:
-
Para obtener los permisos que necesitas para ver y editar las posposiciones con la consola de Google Cloud, pídele 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.
-
Para obtener los permisos que necesitas para ver y editar las posposiciones con la API de Cloud Monitoring, pídele a tu administrador que te otorgue el rol de IAM de editor de posposición 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 en este documento, haz lo siguiente:
Crea una variable de entorno,
PROJECT_ID, para contener el ID de tu proyecto de Google Cloud:PROJECT_ID=PROJECT_ID
Autentica 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 pospuesta
Para evitar que las políticas de alertas creen incidentes y envíen notificaciones, crea una posposición.
Puedes crear una posposición con la consola de Google Cloud, la CLI de gcloud o la API de Cloud Monitoring.
Console
En la consola de Google Cloud, puedes crear una posposición desde un incidente abierto o desde la página Alertas.
Para crear una posposición a partir de un incidente abierto, 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- En el panel Incidentes de la página Alertas, busca el incidente y haz clic en su Resumen del incidente.
- En la página Detalles del incidente, haz clic en Posponer y, luego, selecciona la duración de la posposición.
- Opcional: Para aplicar la posposición a otros incidentes relacionados con la misma política de alertas, ve a la sección Etiquetas y selecciona una o más etiquetas de recursos. Cuando haces clic en Posponer, también se posponen los incidentes con cualquiera de las etiquetas de recursos seleccionadas.
- Haz clic en Posponer.
Para crear una posposición desde la página Alertas, 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- En la página Alertas, haz clic en Crear posposición.
- Ingresa un nombre descriptivo para la posposición. Este nombre se muestra en la página Alertas.
- Selecciona una Hora de inicio. Puedes ingresar una hora específica o iniciar la posposición cuando se crea.
- Ingresa la duración. El valor de este campo determina la duración del posponer.
Completa la sección Criterios de posposición. Puedes usar el menú Políticas de alertas para seleccionar las políticas de alertas a las que se aplica la posposición.
Puedes agregar hasta 16 políticas de alertas a una posposición.
Una vez que se crea una opción para posponer, no se pueden modificar sus criterios.
Después de completar la sección Criterios de posposición, en el panel Crear posposición, se enumeran los incidentes anteriores que coinciden con los criterios.
Haz clic en Crear.
API de Cloud Monitoring
Para crear un aplazamiento, invoca el método snoozes.create enviando 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
En la expresión anterior, PROJECT_ID es una variable de entorno que almacena el ID de tu proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
El método muestra un objeto snooze. El campo "name", que incluye el ID de posponer que genera la supervisión, es la única diferencia entre el objeto que se muestra y el contenido de my-snooze.json:
{
"name": "projects/my-project/snoozes/778899",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/001122"
]
},
"interval": {
"startTime": "2022-11-12T19:00:20Z",
"endTime": "2022-11-12T19:05:20Z"
},
"displayName": "Snooze2"
}
gcloud CLI
Para crear una posposición, ejecuta el 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 --project=PROJECT_ID
Antes de ejecutar el comando anterior, reemplaza lo siguiente:
- LIST_OF_POLICIES: Son las políticas a las que se aplica la posposición. Si especificas varios proyectos, sepáralos con una coma.
- PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- DISPLAY_NAME: Es el nombre que se mostrará en la consola de Google Cloud.
- START_TIME: Es la hora de inicio.
END_TIME : Es la hora de finalización. El valor debe ser, como mínimo, un minuto después de la hora de inicio.
Para las horas de inicio y finalización, debes seguir las reglas de formato ISO 8601. Sin embargo, puedes especificar horas absolutas o relativas. En el siguiente ejemplo, se especifican tiempos absolutos. Para iniciar una posposición 30 minutos después de la hora actual, usa
--start-time="+PTM30M".
Por ejemplo, el siguiente comando crea un aplazamiento para una política de alertas con un ID de "12345". El período de aplazamiento es el intervalo del 1 al 7 de marzo de 2025.
gcloud monitoring snoozes create --display-name="Maintenance Week" \
--criteria-policies="projects/my-project/alertPolicies/12345" \
--start-time="2025-03-01T03:00:00.0-0500" \
--end-time="2025-03-07T23:59:59.5-0500" \
--project=PROJECT_ID
En el ejemplo anterior, se crea el siguiente posponer en my-project:
{
"name": "projects/my-project/snoozes/778899",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/12345"
]
},
"interval": {
"startTime": "2025-03-01T03:00:00.0-0500",
"endTime": "2025-03-07T23:59:59.5-0500"
},
"displayName": "Maintenance Week"
}
Si se realiza de forma correcta, la respuesta a este comando es similar a la siguiente:
Created snooze [projects/my-project/snoozes/778899]
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, haz una de las siguientes acciones:
- Ejecuta el comando
gcloud alpha monitoring policies list. Los datos de respuesta de este comando incluyen el nombre de tus políticas de alertas. - Consulta la representación JSON de una política de alertas. Puedes descargar la representación de JSON a tu sistema local usando una opción en la página Detalles de la política.
Cómo crear alertas pospuestas recurrentes
Para crear posposiciones que se produzcan en intervalos recurrentes, puedes escribir una secuencia de comandos que cree una posposición para una política de alertas. Luego, usa un programador de tareas, como cron o Cloud Scheduler, para ejecutar la secuencia de comandos en el programa requerido.
Cómo ver la lista de alertas pospuestas
Cuando creas una posposición, se agrega al registro histórico de posposiciones de tu proyecto. Este registro muestra los recordatorios aplazados vencidos, activos y próximos. No puedes quitar entradas de este registro, es decir, no puedes borrar un aplazamiento. Sin embargo, desde esta vista, puedes mostrar los detalles de una posposición y realizar acciones como editarla o copiarla.
Console
Para ver una lista de las posposiciones, 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
Haz clic en Ver todas las posposiciones en el panel Posponer.
En la página Posponer, se muestra una lista de las posposiciones y un cronograma que muestra gráficamente las posposiciones anteriores, próximas y activas.
- Para editar, copiar, cancelar o finalizar una posposición, usa el menú more_vert Más opciones de la posposición. El estado de posponer determina qué opciones están disponibles.
- Para ver una lista de todas las alertas pospuestas, habilita Mostrar alertas pospuestas anteriores. De forma predeterminada, solo se muestran los posponemientos activos y próximos.
- Para cambiar el período de visualización de la tabla Cronograma, usa el menú Intervalo de tiempo. De forma predeterminada, la tabla muestra los datos de la hora siguiente. Sin embargo, puedes modificar este campo para especificar períodos anteriores o futuros. Las posposiciones vencidas se retienen durante 13 meses.
- Para ver los detalles de una posposición específica, haz clic en Ver detalles.
- Para ver un resumen de las posposiciones activas, coloca el puntero sobre el área sombreada de la fila Activas en la tabla Rutas. La información sobre la herramienta muestra la información de resumen.
- Para ver una representación gráfica de las posposiciones activas, expande la fila Activas de la tabla Cronograma.
API de Cloud Monitoring
Para enumerar todas las posposiciones 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
En la expresión anterior, PROJECT_ID es una variable de entorno que almacena el ID de tu proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
El método muestra una lista de objetos snooze. Por ejemplo, cuando un proyecto tiene una posposición, la respuesta al comando snoozes.list es similar a la siguiente:
{
"name": "projects/my-project/snoozes/778899",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/12345"
]
},
"interval": {
"startTime": "2025-03-01T03:00:00.0-0500",
"endTime": "2025-03-07T23:59:59.5-0500"
},
"displayName": "Snooze2"
}
Para obtener información sobre una posposición específica, invoca el método snoozes.get y especifica el ID del proyecto y el ID de la posposición. En la respuesta anterior, el ID de posposición 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/778899",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/12345"
]
},
"interval": {
"startTime": "2025-03-01T03:00:00.0-0500",
"endTime": "2025-03-07T23:59:59.5-0500"
},
"displayName": "Snooze2"
}
gcloud CLI
Para enumerar las posposiciones de tu proyecto actual, ejecuta el comando gcloud monitoring snoozes list:
gcloud monitoring snoozes list OPTIONAL_FLAGS --project=PROJECT_ID
Antes de ejecutar el comando anterior, reemplaza lo siguiente:
- PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- OPTIONAL_FLAGS: Para obtener 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 nombres de pospones en el proyecto, con el formato YAML. Por ejemplo, la respuesta a este comando para el proyecto de Google Cloud con el ID my-project es una sola entrada:
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/778899
Para enumerar los detalles de una posposición específica, ejecuta el comando gcloud monitoring snoozes describe:
gcloud monitoring snoozes describe NAME --project=PROJECT_ID
Por ejemplo, para mostrar los detalles sobre la posposición con el nombre projects/my-project/snoozes/778899, ejecuta el siguiente comando:
gcloud monitoring snoozes describe projects/my-project/snoozes/778899 --project=PROJECT_ID
Si proporcionas un NAME no válido a un comando describe, la respuesta contendrá un código de error de 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 posposición, así como el nombre y la hora de finalización de una posposición activa. Por ejemplo, cuando se reprograma un período de mantenimiento, es posible que debas editar una posposición.
No puedes editar una opción para posponer anterior ni los criterios de ninguna. Sin embargo, si quieres programar una posposición anterior para un período futuro, cópiala y aplica los cambios a la copia antes de seleccionar Crear.
Console
Para editar una posposición, 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- Haz clic en Ver todas las posposiciones en el panel Posponer.
- En la lista de posponer, busca la que quieres editar y, luego, selecciona Editar posponer en el menú Más opciones more_vert.
- Haz clic en Guardar después de completar los cambios.
API de Cloud Monitoring
Para modificar una posposición existente, invoca el método snoozes.patch. Para ello, emite una solicitud PATCH al extremo Snooze.
Debes proporcionar el objeto snooze revisado y, luego, incluir parámetros de consulta que identifiquen qué campos se modifican. Cuando usas curl,
los parámetros de consulta deben estar codificados como URL.
Para las próximas posposiciones, puedes modificar el nombre y el período. En el caso de las posposiciones activas, puedes modificar el nombre y la hora de finalización. No puedes modificar las posposiciones anteriores.
Para actualizar el displayName de una posposición, crea un archivo JSON, my-updated-snooze.json, que describa el objeto de posposición y actualice el 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
En la expresión anterior:
PROJECT_IDes una variable de entorno que almacena el ID de tu proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.SNOOZE_IDes una variable de entorno que almacena el ID de la posposición.
El método muestra un objeto snooze que es idéntico al contenido del archivo my-updated-snooze.json:
{
"name": "projects/my-project/snoozes/778899",
"criteria": {
"policies": [
"projects/my-project/alertPolicies/12345"
]
},
"interval": {
"startTime": "2025-03-01T03:00:00.0-0500",
"endTime": "2025-03-07T23:59:59.5-0500"
},
"displayName": "Snooze2"
}
gcloud CLI
Para editar una posposición, ejecuta el 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 --project=PROJECT_ID
Antes de ejecutar el comando anterior, reemplaza lo siguiente:
- NAME: Es el nombre del posponer.
- PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- OPTIONAL_FLAGS: Para obtener información sobre las marcas opcionales, consulta la página de referencia de
gcloud monitoring snoozes update.
Por ejemplo, para cambiar el nombre visible del posponer con el nombre projects/my-project/snoozes/778899, ejecuta el siguiente comando:
gcloud monitoring snoozes update projects/my-project/snoozes/778899 --display-name="Maintenance Week" --project=PROJECT_ID
Cómo finalizar o cancelar una posposición
Si quieres recibir notificaciones de recursos que coincidan con los criterios especificados en una posposición activa, finaliza la posposición. Por ejemplo, cuando el mantenimiento programado se completa más rápido de lo previsto, es posible que desees finalizar una posposición.
Si tienes una próxima posposición que ya no quieres, cancela la posposición. La operación de cancelación establece la duración en cero y hace que la posposición realice la transición al estado Pasado.
Console
Para finalizar una posposición activa o cancelar una próxima, 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- Haz clic en Ver todas las posposiciones en el panel Posponer.
En la lista de posponer, busca la que deseas finalizar o cancelar y, luego, realiza una de las siguientes acciones:
- Para finalizar una posposición activa, selecciona Finalizar ahora en el menú Más opciones de more_vert.
- Para cancelar una próxima posposición, selecciona Cancelar posposición en el menú Más opciones more_vert.
API de Cloud Monitoring
Para finalizar una función de posponer activa, edítala y configura la hora de finalización en la hora actual. Para obtener más información, consulta Cómo editar una posposición.
Para cancelar una próxima posposición, edítala y establece la hora de finalización en la hora de inicio de la posposición. La hora de inicio debe ser futura. Para obtener más información, consulta Cómo editar una posposición.
gcloud CLI
Para finalizar una posposición activa o cancelar una próxima, ejecuta el comando gcloud monitoring snoozes cancel:
gcloud monitoring snoozes cancel NAME --project=PROJECT_ID
Antes de ejecutar el comando anterior, reemplaza lo siguiente:
- NAME: Es el nombre del posponer.
- PROJECT_ID: Es el identificador del proyecto. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
Por ejemplo, para cancelar el posponer con el nombre projects/my-project/snoozes/778899, ejecuta el siguiente comando:
gcloud monitoring snoozes cancel projects/my-project/snoozes/778899 --project=PROJECT_ID
Cómo copiar una alerta para posponer
Cuando quieras usar una posposición existente como una plantilla para otra, crea una copia. Cuando copias una posposición, el editor de posposición se abre con todos los campos, excepto la hora de inicio, establecida en los valores de la posposición original. Puedes modificar todos los campos antes de hacer clic en Crear.
Para copiar una posposición con 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.
- En la barra de herramientas de la consola de Google Cloud, selecciona tu proyecto de Google Cloud. Para las configuraciones de App Hub, selecciona el proyecto host de App Hub o el proyecto de administración de la carpeta habilitada para apps.
- Haz clic en Ver todas las posposiciones en el panel Posponer.
- En la lista de posponer, busca la que deseas editar y, luego, selecciona Copiar posponer en el menú Más opciones de more_vert.
- Aplica las 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 alertas.
Para obtener más información sobre la latencia de notificaciones y cómo las opciones de los parámetros de una política de alertas afectan cuándo se envían, consulta Comportamiento de las políticas de alertas basadas en métricas.
Para obtener información sobre los incidentes, consulta los siguientes documentos: