Supervisa las extensiones de VM

Supervisar el estado y el rendimiento de tus extensiones de VM te ayuda a administrar el uso de recursos y resolver problemas en tu flota de instancias de Compute Engine. Puedes usar los paneles de Cloud Monitoring para visualizar el uso de recursos, como el consumo de CPU o memoria, y configurar políticas de alertas para recibir notificaciones cuando ocurra un evento, como una falla en la instalación.

En este documento, se describe cómo supervisar las extensiones de VM administradas por Gestor de extensiones de VM en tus instancias de Compute Engine con Cloud Monitoring y te ayuda a hacer lo siguiente:

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Selecciona la pestaña que corresponda a la forma en que planeas usar las muestras de esta página:

    Console

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud , no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando: 

      gcloud init

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  • Configura una región y una zona predeterminadas.

    • REST

    Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

      Instala Google Cloud CLI.

      Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Antes de comenzar

Antes de supervisar tus extensiones, asegúrate de haber completado los siguientes pasos:

Roles de IAM obligatorios

Para obtener los permisos que necesitas para supervisar métricas y crear paneles, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu proyecto.

Para obtener los permisos que necesitas para supervisar las métricas y administrar los paneles, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para supervisar las métricas y administrar los paneles. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para supervisar las métricas y administrar los paneles:

  • Para ver los paneles, haz lo siguiente: monitoring.dashboards.get en el proyecto
  • Para crear paneles, haz lo siguiente: monitoring.dashboards.create en el proyecto.
  • Para configurar alertas, haz lo siguiente: monitoring.alertPolicies.create en el proyecto

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

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 a través de roles personalizados o cualquier otro rol predefinido.

Métricas disponibles para las extensiones de VM

Las siguientes métricas están disponibles para supervisar tus extensiones de VM en Monitoring:

Nombre de la métrica Tipo de métrica Descripción
Estado de aplicación de la extensión de VM compute.googleapis.com/vm_extensions/extension/enforcement_status Es el estado de aplicación de una extensión de VM de Compute Engine. Las etiquetas incluyen extension_name y status.

Para obtener una lista de los nombres de las extensiones, consulta extensiones compatibles.

Los valores posibles para status son los siguientes:

  • ENFORCEMENT_STATE_UNSPECIFIED
  • INSTALLING
  • INSTALL_FAILED
  • INSTALLED
  • ROLLING_BACK
  • ROLLBACK_FAILED
  • ROLLED_BACK
  • INCOMPATIBLE
  • REMOVING
  • SERVICE_DISABLED
  • APPLYING_CONFIG
Estado de la extensión de VM compute.googleapis.com/vm_extensions/extension/health_status Es el estado de una extensión de VM. Las etiquetas incluyen extension_name y status.

Para obtener una lista de los nombres de las extensiones, consulta extensiones compatibles.

Los valores posibles para status son los siguientes:
  • HEALTH_STATUS_UNSPECIFIED
  • STARTING
  • RUNNING
  • STOPPING
  • STOPPED
  • CRASHED
Uso máximo de CPU de la extensión de VM compute.googleapis.com/vm_extensions/extension/cpu/max_usage Es el tiempo máximo de CPU que usa la extensión de VM, expresado como un porcentaje.
Bytes máximos usados de la memoria de la extensión de VM compute.googleapis.com/vm_extensions/extension/memory/used_bytes Uso máximo de memoria de la extensión de VM en bytes.

Compila paneles personalizados de supervisión

Puedes crear paneles de Monitoring con los gráficos de extensiones de VM más relevantes para tu caso de uso. Para agregar un gráfico a un panel, sigue estos pasos:

  1. En la consola de Google Cloud , selecciona Monitoring:

    Ir a Monitoring

  2. En el panel de navegación, selecciona Paneles.
  3. Haz clic en Crear panel de control.
  4. Haz clic en Agregar widget.
  5. En la ventana Agregar widget, en Datos, selecciona Métrica.
  6. Para seleccionar la métrica, expande el menú Seleccionar una métrica y, luego, haz lo siguiente:
    1. En Recursos activos, selecciona Instancia de VM.
    2. En Categoría de métrica, selecciona Vm_extensions.
    3. En Métrica, selecciona una métrica, como Estado de salud de la extensión de VM. Para obtener una lista de las métricas disponibles, consulta Métricas disponibles para supervisar extensiones de VM.
    4. Haz clic en Aplicar.

Puedes agregar tantos gráficos al panel como quieras. Para obtener más información, consulta Crea y administra paneles personalizados.

Configurar una política de alertas

Monitoring te permite crear alertas y recibir notificaciones cuando una métrica supera un límite específico. Por ejemplo, puedes recibir una notificación cuando el estado de una extensión cambia a CRASHED.

  1. En la consola de Google Cloud , selecciona Monitoring.

    Ir a Monitoring

  2. En el panel de navegación, selecciona Alertas.
  3. Haz clic en Crear política.
  4. En la página Crear política de alertas, define las condiciones de alerta y los canales de notificación.
    1. Para seleccionar la métrica, expande el menú Seleccionar una métrica y, luego, haz lo siguiente:
      1. En Recursos activos, selecciona Instancia de VM.
      2. En Categoría de métrica, selecciona Vm_extensions.
      3. En Métrica, selecciona una métrica, como Estado de aplicación de la extensión de VM. Para obtener una lista de las métricas disponibles, consulta Métricas disponibles para supervisar extensiones de VM.
      4. Haz clic en Aplicar.
    2. Configura las condiciones del activador, como verificar si la etiqueta status es INSTALL_FAILED.
  5. Sigue las instrucciones para agregar canales de notificación y asignarle un nombre a la política.
  6. Haz clic en Crear política.

Para obtener más información, consulta Crea políticas de alertas.

¿Qué sigue?