Crear y gestionar aplazamientos

En este documento se describe cómo crear y gestionar tus posponer. La opción de posponer impide que Cloud Monitoring cree incidentes y envíe notificaciones durante un periodo específico. Cada aplazamiento especifica los recursos a los que se aplica.

Para obtener una descripción general, consulta Posponer notificaciones e incidentes.

Para crear y gestionar tus aplazamientos, puedes usar la Google Cloud consola o la API Cloud Monitoring.

Esta función solo se admite en proyectos de Google Cloud . En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Antes de empezar

Completa los siguientes pasos en el Google Cloud proyecto que almacena tu política de alertas:

  1. Asegúrate de que tienes los permisos necesarios:

    Para obtener más información sobre los roles de Cloud Monitoring, consulta Controlar el acceso con Gestión de Identidades y Accesos.

  2. Si quieres usar los ejemplos de la API Cloud Monitoring que se incluyen en este documento, haz lo siguiente:

    1. Crea una variable de entorno, PROJECT_ID, para almacenar el ID de tu proyectoGoogle Cloud :

      PROJECT_ID=PROJECT_ID

    2. Autentícate en Google Cloud CLI:

      gcloud auth login

    3. Configura el Google Cloud proyecto predeterminado:

      gcloud config set project ${PROJECT_ID}

    4. Crea un token de autorización:

      ACCESS_TOKEN=`gcloud auth print-access-token`

      Debes actualizar periódicamente el token de acceso. Si los comandos que funcionaban de repente informan de que no estás autenticado, vuelve a emitir este comando.

Crear una repetición

Para evitar que las políticas de alertas creen incidentes y envíen notificaciones, crea una suspensión. Si restringes una posposición a una política de alertas, esta puede incluir filtros basados en etiquetas. Si añade filtros basados en etiquetas, la suspensión solo se aplicará a los incidentes que coincidan con los filtros. Una vez que hayas creado una suspensión, no podrás modificar el filtro basado en etiquetas ni la lista de políticas a las que se aplica.

consola

La consola de Google Cloud ofrece dos formas de crear una posposición:

  • Si empiezas desde la página Detalles del incidente de un incidente abierto, el cuadro de diálogo que completes para crear el aplazamiento se preconfigurará para mostrar tu política de alertas. El cuadro de diálogo también te permite seleccionar etiquetas, que se adjuntan a la posposición como filtros basados en etiquetas.

  • Si empiezas en la página Alertas, puedes crear un aplazamiento cuyos criterios incluyan hasta 16 políticas de alertas. Sin embargo, no puedes adjuntar filtros basados en etiquetas a tu posposición, aunque los criterios de posposición incluyan una política de alertas.

Para crear una suspensión a partir de un incidente abierto, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el panel Incidentes de la página Alertas, busca el incidente y haz clic en Resumen del incidente.
  4. En la página Detalles del incidente, haz clic en Posponer y, a continuación, selecciona la duración de la posposición.

  5. Opcional: Para añadir un filtro basado en etiquetas a tu posposición, ve a la sección Etiquetas y selecciona una o varias etiquetas. Un filtro basado en etiquetas puede incluir etiquetas de recursos y de métricas. Si la política de alertas no se basa en PromQL, el filtro también puede incluir etiquetas de metadatos.

    Normalmente, las suspensiones se aplican a todos los incidentes creados por una política de alertas. Los filtros te permiten posponer los incidentes cuyas etiquetas coincidan con las etiquetas del filtro.

  6. Haz clic en Posponer. Ahora, la suspensión se aplica a la política de alertas que ha creado el incidente.

Para crear una alerta desde la página Alertas, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En la página Alertas, haz clic en Crear posposición.
  4. Introduce un nombre descriptivo para la posposición. Este nombre se muestra en la página Alertas.
  5. Selecciona una hora de inicio. Puedes introducir una hora específica o iniciar la repetición cuando se cree.
  6. Introduce la duración. El valor de este campo determina la duración de la repetición.

  7. Completa la sección Criterios de aplazamiento. Puedes usar el menú Políticas de alertas para seleccionar las políticas de alertas a las que se aplica la opción de posponer.

    Puedes añadir hasta 16 políticas de alertas a una suspensión.

    Una vez que se ha creado una posposición, no se pueden modificar sus criterios.

    Después de completar la sección Criterios de aplazamiento, en el panel Crear aplazamiento se muestran los incidentes anteriores que coinciden con los criterios.

  8. Haz clic en Crear.

API de Cloud Monitoring

La API Cloud Monitoring te permite crear un aplazamiento cuyos criterios incluyan hasta 16 políticas de alertas. Si la suspensión se aplica a una política de alertas, también puedes incluir filtros basados en etiquetas.

Para crear una alarma, invoca el método snoozes.create enviando una solicitud POST al endpoint 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. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

El método devuelve un objeto snooze. El campo "name", que incluye el ID de la suspensión que genera Monitoring, es la única diferencia entre el objeto devuelto 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"
}

CLI de gcloud

La CLI de gcloud te permite crear un aplazamiento cuyos criterios incluyan hasta 16 políticas de alertas. Si la suspensión se aplica a una política de alertas, también puedes incluir filtros basados en etiquetas.

Para crear una alarma, 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 --criteria-filter=FILTER

Antes de ejecutar el comando anterior, sustituya lo siguiente:

  • LIST_OF_POLICIES: las políticas a las que se aplica la opción de posponer. Si especificas varios proyectos, sepáralos con comas.
  • PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  • DISPLAY_NAME: el nombre que se mostrará en la Google Cloud consola.
  • START_TIME: la hora de inicio.

  • END_TIME : hora de finalización. El valor debe ser al menos un minuto posterior a la hora de inicio.

    Para las horas de inicio y de finalización, debes seguir las reglas de formato ISO 8601. Sin embargo, puedes especificar horas absolutas o relativas. En el siguiente ejemplo se especifican horas absolutas. Para posponer una alarma 30 minutos a partir de la hora actual, usa --start-time="+PTM30M".

  • FILTER: opcional. Se puede definir un filtro basado en etiquetas cuando la suspensión se aplica a una política de alertas. El filtro, que puede incluir etiquetas de recursos, métricas y metadatos, aplica la suspensión a las incidencias con etiquetas coincidentes. Cuando la política de alertas se basa en PromQL, el filtro no puede usar etiquetas de metadatos. Para obtener más información, consulta la página de referencia de gcloud monitoring snoozes create.

Por ejemplo, el siguiente comando crea una suspensión de una política de alertas con el ID "12345". El periodo de posposición es el intervalo comprendido entre el 1 y el 7 de marzo del 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 aplazamiento 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 la acción se realiza correctamente, la respuesta a este comando será 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. 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.
  • Ver la representación JSON de una política de alertas. Puedes descargar la representación JSON en tu sistema local mediante una opción de la página Detalles de la política.

Crear repeticiones periódicas

Para crear aplazamientos que se produzcan en intervalos recurrentes, puedes escribir una secuencia de comandos que cree un aplazamiento para una política de alertas. A continuación, usa un programador de tareas como cron o Cloud Scheduler para ejecutar la secuencia de comandos según la programación que necesites.

Listar las posposiciones

Cuando creas una posposición, se añade al registro histórico de posposiciones de tu proyecto. Este registro muestra las alarmas pospuestas caducadas, activas y próximas. No puedes eliminar entradas de este registro, es decir, no puedes eliminar una posposición. Sin embargo, en esta vista puedes ver los detalles de una alarma pospuesta y realizar acciones como editarla o copiarla.

consola

Para ver una lista de las alarmas pospuestas, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

  3. En el panel Pospuestas, haz clic en Ver todas las posposiciones.

    La página Posponer muestra una lista de las alarmas pospuestas y una cronología que muestra gráficamente las alarmas pospuestas anteriores, las próximas y las activas.

    • Para editar, copiar, cancelar o finalizar una repetición, usa el menú Más opciones de la repetición. El estado de la alarma determina las opciones disponibles.
    • Para ver todas las posposiciones, habilita Mostrar posposiciones anteriores. De forma predeterminada, solo se muestran las posposiciones activas y próximas.
    • Para cambiar el periodo que se muestra en la tabla Cronología, usa el menú Intervalo. De forma predeterminada, la tabla muestra los datos de la hora siguiente, pero puedes modificar este campo para especificar intervalos de tiempo anteriores o futuros. Las alarmas pospuestas caducadas se conservan durante 13 meses.
    • Para ver los detalles de una suspensión específica, haz clic en Ver detalles.
    • Para ver un resumen de las alarmas pospuestas activas, coloque el puntero sobre el área sombreada de la fila Activas de la tabla Cronología. La descripción emergente muestra la información de resumen.
    • Para ver una representación gráfica de las alarmas pospuestas activas, despliega la fila Activas de la tabla Cronología.

API de Cloud Monitoring

Para enumerar todos los aplazamientos que pertenecen a un proyecto 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. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

El método devuelve una lista de objetos snooze. Por ejemplo, si un proyecto tiene una alarma pospuesta, la respuesta al comando snoozes.list será 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 suspensión específica, invoca el método snoozes.get y especifica el ID del proyecto y el ID de la suspensión. En la respuesta anterior, el ID de la posposición es 2986663705844383744:

curl -H "Authorization: Bearer $ACCESS_TOKEN" \
https://monitoring.googleapis.com/v3/projects/${PROJECT_ID}/snoozes/${SNOOZE_ID}

El método devuelve un único 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"
}

CLI de gcloud

Para ver las posposiciones de tu proyecto actual, ejecuta el comando gcloud monitoring snoozes list:

gcloud monitoring snoozes list --project=PROJECT_ID OPTIONAL_FLAGS

Antes de ejecutar el comando anterior, sustituya lo siguiente:

  • PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  • 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 aplazamientos del proyecto, con formato YAML. Por ejemplo, la respuesta a este comando para el proyectoGoogle 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 ver los detalles de una suspensión específica, ejecuta el comando gcloud monitoring snoozes describe:

gcloud monitoring snoozes describe NAME --project=PROJECT_ID

Por ejemplo, para mostrar los detalles de 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á el 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.

Editar una repetición

Puedes editar el nombre y el periodo de una posposición programada, así como el nombre y la hora de finalización de una posposición activa. Por ejemplo, si se reprograma una ventana de mantenimiento, es posible que tengas que editar una posposición.

No puedes editar una posposición anterior, los criterios de ninguna posposición ni los filtros basados en etiquetas adjuntos a una posposición.

Si quieres programar una repetición anterior para un periodo futuro, copia la repetición y aplica los cambios a la copia antes de seleccionar Crear.

consola

Para editar una alarma pospuesta, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el panel Pospuestas, haz clic en Ver todas las posposiciones.
  4. En la lista de alarmas pospuestas, busca la que quieras editar y, a continuación, selecciona Editar alarma pospuesta en el menú Más opciones.
  5. Haz clic en Guardar cuando hayas acabado.

API de Cloud Monitoring

Para modificar una alarma pospuesta, invoca el método snoozes.patch enviando una solicitud PATCH al endpoint Snooze. Debe proporcionar el objeto snooze revisado e incluir parámetros de consulta que identifiquen los campos modificados. Cuando se usa curl, los parámetros de consulta deben codificarse como URL.

En el caso de las posposiciones programadas, puedes modificar el nombre y el periodo. En el caso de las alarmas pospuestas activas, puedes modificar el nombre y la hora de finalización. No puedes modificar las repeticiones 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. A continuación, ejecuta el siguiente comando:

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_ID es una variable de entorno que almacena el ID de tu proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

  • SNOOZE_ID es una variable de entorno que almacena el ID de la posposición.

El método devuelve un objeto snooze 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"
}

CLI de gcloud

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 --project=PROJECT_ID OPTIONAL_FLAGS

Antes de ejecutar el comando anterior, sustituya lo siguiente:

  • NAME: el nombre de la alarma pospuesta.
  • PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  • 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 de la posposición 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

Finalizar o cancelar una posposición

Si quieres recibir notificaciones de los recursos que coincidan con los criterios especificados en una alerta pospuesta activa, finaliza la alerta. Por ejemplo, si el mantenimiento programado se completa antes de lo previsto, puedes finalizar una posposición.

Si tienes una alarma programada para posponerse que ya no quieres, cancélala. La operación de cancelación establece la duración en cero y hace que la repetición pase al estado Pasado.

consola

Para finalizar una repetición activa o cancelar una repetición programada, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el panel Pospuestas, haz clic en Ver todas las posposiciones.

  4. En la lista de aplazamientos, busca el que quieras finalizar o cancelar y haz una de las siguientes acciones:

    • Para finalizar una posposición activa, selecciona Finalizar ahora en el menú Más opciones.
    • Para cancelar una repetición programada, selecciona Cancelar repetición en el menú Más opciones.

API de Cloud Monitoring

Para finalizar una alarma pospuesta activa, edita la alarma y define la hora de finalización como la hora actual. Para obtener más información, consulta Editar una repetición.

Para cancelar una repetición programada, edita la repetición y define la hora de finalización como la hora de inicio de la repetición. La hora de inicio debe ser posterior a la actual. Para obtener más información, consulta Editar una repetición.

CLI de gcloud

Para finalizar una alarma pospuesta activa o cancelar una alarma pospuesta programada, ejecuta el comando gcloud monitoring snoozes cancel:

gcloud monitoring snoozes cancel NAME --project=PROJECT_ID

Antes de ejecutar el comando anterior, sustituya lo siguiente:

  • NAME: el nombre de la alarma pospuesta.
  • PROJECT_ID: identificador del proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.

Por ejemplo, para cancelar la repetición con el nombre projects/my-project/snoozes/778899, ejecuta el siguiente comando:

gcloud monitoring snoozes cancel projects/my-project/snoozes/778899 --project=PROJECT_ID

Copiar una alarma pospuesta

Si quieres usar una posposición como plantilla para otra, haz una copia. Cuando copias una alarma pospuesta, se abre el editor de alarmas pospuestas con todos los campos, excepto la hora de inicio, definidos con los valores de la alarma pospuesta original. Puedes modificar todos los campos antes de hacer clic en Crear.

Para copiar una posposición mediante la consola, haz lo siguiente:

  1. En la Google Cloud consola, ve a la página  Alertas:

    Ve a Alertas.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. En la barra de herramientas de la Google Cloud consola, selecciona tu Google Cloud proyecto. En el caso de las configuraciones de App Hub, seleccione el proyecto host de App Hub o el proyecto de gestión de la carpeta habilitada para aplicaciones.
  3. En el panel Pospuestas, haz clic en Ver todas las posposiciones.
  4. En la lista de alarmas pospuestas, busca la que quieras editar y, a continuación, selecciona Copiar alarma pospuesta en el menú Más opciones.
  5. Aplica las modificaciones a la copia y, a continuación, haz clic en Crear.

Siguientes pasos