Monitoring recoge y almacena información sobre el rendimiento de Google Cloud servicios como Compute Engine. La información sobre el rendimiento se denomina métricas y series temporales. Puedes acceder a las métricas y series temporales de tus reservas de Compute Engine para hacer lo siguiente:
Recibe notificaciones oportunas cuando el consumo de tus reservas se encuentre en un estado específico mediante las políticas de alertas de Monitoring.
Por ejemplo, estos métodos pueden ayudarte a verificar que tus reservas se están consumiendo según lo previsto o a tomar medidas a tiempo para evitar costes innecesarios derivados de recursos desperdiciados o reservas no utilizadas.
To enable APIs, you need the Service Usage Admin IAM
role (roles/serviceusage.serviceUsageAdmin), which
contains the serviceusage.services.enable permission. Learn how to grant
roles.
Si aún no lo has hecho, configura la autenticación.
La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and
APIs, you don't need to set up authentication.
REST
Para usar las muestras de la API REST de esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la CLI de gcloud.
Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .
Roles obligatorios
Para obtener los permisos que necesitas para crear paneles de control de Monitoring o políticas de alertas para monitorizar el consumo de reservas, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Monitoring (roles/monitoring.admin) en el proyecto.
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para crear paneles de Monitoring o políticas de alertas con los que monitorizar el consumo de reservas. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:
Permisos obligatorios
Para crear paneles de control o políticas de alertas de Monitoring para monitorizar el consumo de reservas, se necesitan los siguientes permisos:
Para crear paneles de control, sigue estos pasos:
monitoring.dashboards.create
en el proyecto
Para crear alertas de políticas, sigue estos pasos:
monitoring.alertPolicies.create
en el proyecto
Al crear paneles de control de Monitoring o políticas de alertas, primero debe seleccionar la Google Cloud métrica que quiera medir para saber cómo funciona el Google Cloud servicio. En el caso de las reservas, puede seleccionar las siguientes métricas de Compute Engine:
Reservadas: el número de instancias de máquina virtual (VM) reservadas en cada reserva del proyecto actual.
Usadas: número de VMs consumidas en cada reserva del proyecto actual.
Después de seleccionar una métrica, puede filtrar o agrupar aún más las mediciones de la métrica de reservas. Para obtener más información sobre los filtros disponibles para las reservas, consulta Filtros de reservas en este documento.
Filtros de reservas
Puede usar filtros de monitorización para agrupar o filtrar los datos de series temporales asociados a una o varias reservas.
En concreto, al crear paneles de control de Monitoring o políticas de alertas, puede limitar los datos de serie temporal que usan especificando una o varias de las siguientes etiquetas:
Selector
Nombre de la etiqueta
Descripción
metadata.system
machine_type
El tipo de máquina especificado en las VMs reservadas de una reserva.
metadata.system
name
El nombre de una reserva.
metadata.system
state
El estado de una reserva. Solo puedes monitorizar las reservas que tengan el estado ACTIVE, es decir, las que ya se hayan creado.
metric
reserved_resource_type
El tipo de recursos de zona reservados por una reserva. Solo puedes monitorizar el tipo instance, que es una instancia de VM.
metric
service_name
Si seleccionas la métrica Usado en la consola Google Cloud , puedes ver qué Google Cloud producto consume la reserva.
El valor puede ser uno de los siguientes:
COMPUTE_ENGINE: VMs en Compute Engine
VERTEX_ONLINE_PREDICTION: VMs in Vertex AI
prediction jobs
VERTEX_TRAINING: VMs in Vertex AI
custom training jobs
Si usas reservas tanto en Compute Engine como en Vertex AI, crea un filtro para cada valor anterior.
resource
location
Zona en la que se encuentra una reserva.
resource
reservation_id
Identificador (ID) de una reserva.
resource
resource_container
El número de proyecto del proyecto en el que existe una reserva. Solo puedes monitorizar las reservas que se hayan creado en tu proyecto.
Cuando crea un filtro, debe especificar el selector y el nombre de la etiqueta, seguidos de un operador de comparación y, a continuación, el valor por el que quiere filtrar. Por ejemplo, si quieres que tu consulta filtre tus reservas por zona us-central1-a, usa el siguiente filtro:
resource.location="us-central1-a"
Para asegurarte de que el valor que especificas en un filtro coincide con el valor del campo de una reserva, consulta los detalles de la reserva.
Monitorizar el consumo de reservas
Para monitorizar el consumo de tus reservas, selecciona uno de los métodos que se especifican en este documento:
Crea un panel de control: crea paneles de control de Monitoring y añade widgets a las áreas de gráficos para mostrar los datos de series temporales vinculados al consumo de tus reservas.
Este método es útil cuando, por ejemplo, quieres verificar que una VM está consumiendo correctamente una reserva o comparar la tendencia de consumo de varias reservas.
Crear políticas de alertas: crea políticas de alertas para enviar alertas cuando los datos de serie temporal vinculados al consumo de tus reservas alcancen un umbral definido.
Este método es útil cuando, por ejemplo, quieres recibir una notificación cuando el número de máquinas virtuales usadas en el proyecto actual sea inferior a una proporción específica o cuando una reserva no se haya usado durante un periodo determinado.
Crear un panel de control
Puedes crear paneles de control de Monitoring
y ver las series temporales vinculadas al consumo de tus reservas mediante la
consola Google Cloud (recomendada) y la API de Monitoring.
Cuando defina cómo mostrar los datos de serie temporal de un filtro de Monitoring, debe usar uno de los siguientes métodos:
Consulta básica: este método es útil para configurar rápidamente los datos de series temporales de un widget de panel de control.
Por ejemplo, puede usar Consulta básica para ver rápidamente cuál de sus reservas de una zona específica aún no se ha consumido por completo.
PromQL este método es útil para recuperar, filtrar y manipular datos de series temporales para crear configuraciones más complejas para un widget de panel de control.
Por ejemplo, puedes usar PromQL en Cloud Monitoring
para mostrar la proporción de VMs consumidas con respecto a las VMs reservadas en tus reservas.
Consulta básica
En el siguiente ejemplo se describe cómo crear un panel de control de Monitoring con un gráfico de líneas para mostrar las reservas consumidas en la zona us-central1-a.
Consola
Para crear un panel de control de monitorización con Consulta básica, sigue estos pasos:
En la consola de Google Cloud , ve a Paneles de control.
FILTER: el filtro de monitorización
que quieres usar en tu panel de control. Por ejemplo, para monitorizar las reservas consumidas en la zona us-central1-a, especifica lo siguiente:
En el siguiente ejemplo se describe cómo crear un panel de control de Monitoring con un widget de gráfico de líneas para mostrar la proporción de máquinas virtuales usadas con respecto a las máquinas virtuales reservadas en tus reservas.
Consola
Para crear un panel de control de Monitoring y añadir un widget configurado con una consulta mediante PromQL, sigue estos pasos:
En la Google Cloud consola, ve a la página Paneles de control:
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.
Haz clic en addCrear panel de control.
Se abrirá la página Nuevo panel de control.
Haz clic en add_boxAñadir widget.
Aparecerá el panel Añadir widget.
Haz clic en uno de los widgets disponibles. Por ejemplo, haz clic en el widget Línea.
Aparecerá el panel Configurar widget.
Si no ve el editor de código, haga clic en
codePromQL o
codeMQL. En Idioma, selecciona PromQL.
En el editor de consultas, introduce una consulta de PromQL. Por ejemplo, para ver la relación entre las VMs usadas y las VMs reservadas en tus reservas, especifica lo siguiente:
Para crear un panel de control de Monitoring y añadir un widget configurado con una consulta mediante PromQL, haz una solicitud POST al método dashboards.create.
PROMQL_QUERY: la consulta de PromQL que se va a usar en el widget de gráfico de líneas. Por ejemplo, para ver la proporción de máquinas virtuales usadas con respecto a las reservadas en tus reservas, especifica lo siguiente:
Puedes crear políticas de alertas de Monitoring para recibir notificaciones sobre el consumo de reservas en el proyecto actual mediante la consola Google Cloud y la API de Monitoring.
Cuando definas una condición de alerta para una política de alertas, debes usar uno de los siguientes métodos:
Consulta básica: este método es útil para crear condiciones de alerta sencillas.
Por ejemplo, puedes usar Consulta básica para crear una condición de alerta que se active cada vez que se consuma una reserva por primera vez.
PromQL este método es útil para recuperar, filtrar y manipular datos de series temporales con el fin de crear condiciones de alerta más complejas.
Por ejemplo, puedes usar el lenguaje de consulta de Prometheus (PromQL) para crear una condición de alerta que se active cuando la proporción de máquinas virtuales reservadas y consumidas alcance un umbral específico.
Consulta básica
En el siguiente ejemplo se crea una política de alertas que envía una notificación de alerta cuando se consume una reserva por primera vez. En concreto, la alerta se activa cuando el número de VMs consumidas en una reserva es superior a 0.
Consola
Para crear una política de alertas de Monitoring con una consulta básica, sigue estos pasos:
En la ventana Selecciona una métrica, haz lo siguiente:
En el campo Filtrar por nombre de recurso o métrica, introduce
Reservation.
Si la métrica Reserva aparece en la lista Recursos activos, selecciónela. De lo contrario, haz lo siguiente:
Desmarca Mostrar solo recursos y métricas activos.
Aparecerá la lista Recursos inactivos.
En la lista Recursos inactivos, selecciona Reserva.
En la lista Categorías de métricas activas, vuelva a seleccionar Reserva.
Aparecerá la lista Métricas activas.
En la lista Métricas activas, seleccione una de las métricas disponibles.
Por ejemplo, selecciona Usado.
Haz clic en Aplicar.
Haz clic en add_boxAñadir filtro.
Aparecerá la sección Añadir filtro.
En la sección Añadir filtro, haga lo siguiente:
En la lista Etiqueta, selecciona uno de los filtros de reservas disponibles que se especifican en este documento.
Por ejemplo, para filtrar tus reservas por nombre, selecciona nombre.
En la lista Comparación, seleccione uno de los operadores disponibles.
Por ejemplo, selecciona = (igual) (opción predeterminada).
En la lista Valor, seleccione el nombre de la reserva que quiera monitorizar.
Haz clic en Listo.
Haz clic en Siguiente.
Aparecerá el panel Configurar activador de alerta.
En la sección Tipos de condición, seleccione una de las siguientes opciones:
Para activar la condición si una serie temporal supera o no alcanza un valor específico, selecciona Umbral.
Para activar la condición si una serie temporal no tiene datos durante un periodo específico, selecciona Falta de métrica.
Para activar la condición si se prevé que una serie temporal cruce el umbral en un futuro próximo, seleccione Previsión.
Por ejemplo, selecciona Umbral (opción predeterminada).
En la lista Activador de alerta, seleccione la condición que activa la alerta.
Por ejemplo, selecciona Cualquier infracción de serie temporal (opción predeterminada).
En la lista Posición del umbral, selecciona cuándo se activa la condición.
Por ejemplo, selecciona Por encima del umbral.
En el campo Valor de umbral, introduzca un valor para la condición.
Por ejemplo, escribe 0.
En el campo Nombre de la condición, escriba el nombre de la condición.
Por ejemplo, introduce
Reservation RESERVATION_NAME consumed.
Donde RESERVATION_NAME es el nombre de la reserva que has especificado en los pasos anteriores.
Haz clic en Siguiente.
Aparecerá el panel Configurar notificaciones y finalizar alerta.
Haz clic en Usar canales de notificaciones.
En el campo Canales de notificación, selecciona los canales en los que quieras recibir notificaciones sobre el incidente.
Si no tienes ningún canal de notificación disponible, haz clic en Gestionar canales de notificaciones y sigue los pasos para crear canales de notificación. Para obtener más información, consulta cómo crear y gestionar canales de notificación.
En el campo Duración del cierre automático de incidencias, selecciona el periodo tras el cual se cerrará automáticamente una incidencia.
Por ejemplo, selecciona 3 días.
En el campo Nombre de la política de alertas, escribe el nombre de la política de alertas.
Por ejemplo, introduce
Alert: you started consuming reservation RESERVATION_NAME!
Donde RESERVATION_NAME es el nombre de la reserva que has especificado en los pasos anteriores.
Haz clic en Siguiente.
Se abrirá la página de revisión de la condición de alerta.
Haz clic en Crear política.
La creación de la política de alertas puede tardar unos segundos. Esta acción te redirige a la página Crear política de alertas.
Para obtener más información sobre las opciones que tiene al crear políticas de alertas con la consola de Google Cloud y la consulta básica, consulte Crear políticas de alertas basadas en métricas.
RESERVATION_NAME: el nombre de una reserva que se encuentre en el proyecto actual.
FILTER: el filtro de monitorización
que se va a usar en tu política de alertas. Por ejemplo, para monitorizar la métrica used
de la reserva
RESERVATION_NAME, especifique lo siguiente:
AUTO_CLOSE_TIME: tiempo en segundos que debe transcurrir antes de que se cierre automáticamente un incidente. El valor debe estar comprendido entre 0s y 604800s (7 días). Por ejemplo, introduce 259200s (3 días).
NOTIFICATION_CHANNEL: el nombre de un canal de notificaciones que ya exista. Para configurar un canal de notificaciones, consulta el artículo Crear y gestionar canales de notificaciones.
Para obtener más información sobre las opciones que tienes al crear políticas de alertas con la API Monitoring y la consulta básica, consulta Crear políticas de alertas con la API.
PromQL
En el siguiente ejemplo se crea una política de alertas que envía una notificación de alerta cada vez que el porcentaje de máquinas virtuales usadas con respecto a las máquinas virtuales reservadas en tus reservas supera el 90%.
Consola
Para crear una política de alertas de Monitoring con PromQL, sigue estos pasos:
En Policy configuration mode (Modo de configuración de la política), selecciona Code editor (MQL or PromQL) (Editor de código [MQL o PromQL]).
Aparecerá el panel Editor de consultas.
Selecciona PromQL como idioma e introduce una consulta de PromQL.
Por ejemplo, para crear una consulta que agrupe tus reservas por nombre y active una condición de alerta cuando se haya consumido más del 90% de tus reservas, introduce la siguiente consulta:
Aparecerá el panel Configurar activador de alerta.
Si el Nombre de la condición, introduce un nombre para la condición.
Por ejemplo, introduce
Over 90% of your reservations are consumed.
Vuelve a hacer clic en Siguiente.
Aparecerá el panel Configurar notificaciones y finalizar alerta.
Haz clic en Usar canales de notificaciones.
En el campo Canales de notificación, selecciona los canales en los que quieras recibir notificaciones sobre el incidente.
Si no tienes ningún canal de notificación disponible, haz clic en Gestionar canales de notificaciones y sigue los pasos para crear canales de notificación. Para obtener más información, consulta cómo crear y gestionar canales de notificación.
En el campo Duración del cierre automático de incidencias, selecciona el periodo tras el cual se cerrará automáticamente una incidencia.
Por ejemplo, selecciona 3 días.
En el campo Nombre de la política de alertas, escribe el nombre de la política de alertas.
Por ejemplo, escribe Alert: over 90% of your reservations are consumed..
Haz clic en Siguiente.
Se abrirá la página de revisión de la condición de alerta.
Haz clic en Crear política.
La creación de la política de alertas puede tardar unos segundos. Esta acción te redirige a la página Crear política de alertas.
Para crear una política de alertas de Monitoring con PromQL, envía una solicitud POST al método projects.alertPolicies.create.
POST https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alertPolicies
{
"displayName": "Alert: over 90% of your reservations are consumed.",
"conditions": [
{
"displayName": "Over 90% of your reservations are consumed.",
"conditionMonitoringQueryLanguage": {
"duration": "0s",
"trigger": {
"count": 1
},
"query": "PROMQL_QUERY"
}
}
],
"alertStrategy": {
"autoClose": "AUTO_CLOSE_TIME"
},
"combiner": "OR",
"enabled": true,
"notificationChannels": [
"projects/PROJECT_ID/notificationChannels/NOTIFICATION_CHANNEL"
]
}
Haz los cambios siguientes:
PROJECT_ID: el ID del proyecto actual.
PROMQL_QUERY: una consulta de PromQL que se usará en la política de alertas. Por ejemplo, para crear una consulta que monitorice cuándo el porcentaje de VMs usadas con respecto a las VMs reservadas supera el 90% en las reservas del proyecto actual, especifica lo siguiente:
AUTO_CLOSE_TIME: tiempo en segundos que debe transcurrir antes de que se cierre automáticamente un incidente. El valor debe estar comprendido entre 0s y 604800s (7 días). Por ejemplo, introduce 259200s (3 días).
NOTIFICATION_CHANNEL: el nombre de un canal de notificaciones que ya exista. Para configurar un canal de notificaciones, consulta el artículo Crear y gestionar canales de notificaciones.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-12 (UTC)."],[],[],null,[]]