Supervisar los cambios en el estado de salud de la máquina virtual

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Este documento describe cómo ver y leer las entradas del registro de cambios de estado de una VM en un grupo de instancias administrado (MIG) y proporciona casos de uso específicos para ayudarlo a monitorear las VM en el grupo.

Si configuró la verificación de estado basada en aplicaciones para MIG, Compute Engine escribe una entrada de registro cada vez que cambia el estado de salud de una instancia administrada; por ejemplo, cuando la instancia pasa del estado HEALTHY a UNHEALTHY . Estas entradas de registro le ayudan a monitorear y depurar el estado de cada instancia administrada, así como el estado general del MIG.

Antes de comenzar

• Revisar la configuración de la comprobación de estado y la reparación automática .
• Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras 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.

  gcloud

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

  REST

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

  After installing the Google Cloud CLI, initialize it by running the following command:

  gcloud init

  If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

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

Precios

Compute Engine utiliza Cloud Logging para generar entradas de registro para cambios en el estado de salud de las instancias administradas. Cloud Logging le proporciona una asignación gratuita por mes, después de la cual las entradas de registro se cotizan por volumen de datos. Para obtener más información, consulte el resumen de precios de Cloud Logging .

Para evitar los costos de registro, puede desactivar los registros de cambios de estado de salud.

Ver registros de cambios de estado de salud

Siempre que los registros de cambios de estado de salud permanezcan habilitados , Compute Engine escribe una entrada de registro en los registros de la plataforma cada vez que cambia el estado de salud de una instancia administrada. Puede ver estos registros para un proyecto, para un MIG específico o para una instancia administrada específica.

Ver registros de un proyecto o un MIG

Para ver las entradas de registro de un proyecto o de un MIG específico, use la consola de Google Cloud, la CLI de gcloud o REST.

gcloud logging read 'resource.type="gce_instance_group_manager" AND
    logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
    jsonPayload.instanceHealthStateChange:*'\
    --limit 10

gcloud logging read 'resource.type="gce_instance_group_manager" AND
    logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
    jsonPayload.instanceHealthStateChange:* AND
    resource.labels.instance_group_manager_name="MIG_NAME"' \
    --limit 10

curl -H "Content-Type: application/json" -H "Authorization: Bearer OAUTH2_TOKEN" -X POST -d \
'{"filter":
    "resource.type=gce_instance_group_manager AND
    logName=projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events AND
    jsonPayload.instanceHealthStateChange:*",
    "orderBy": "timestamp desc",
    "pageSize": 10,
    "resourceNames": ["projects/PROJECT_ID"]
}' https://logging.googleapis.com/v2/entries:list?alt=json

curl -H "Content-Type: application/json" -H "Authorization: Bearer OAUTH2_TOKEN" -X POST -d \
'{"filter":
    "resource.type=gce_instance_group_manager AND
    logName=projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events AND
    jsonPayload.instanceHealthStateChange:* AND
    resource.labels.instance_group_manager_name=MIG_NAME",
    "orderBy": "timestamp desc",
    "pageSize": 10,
    "resourceNames": ["projects/PROJECT_ID"]
}' https://logging.googleapis.com/v2/entries:list?alt=json

Para obtener más información sobre cada entrada de registro, consulte Formato de las entradas de registro .

Dependiendo de si desea archivar los registros, utilizarlos para análisis, transmitirlos a otras aplicaciones o activar una función en la nube, puede exportar los registros a destinos como Cloud Storage, BigQuery o Pub/Sub. Para obtener más información sobre la exportación de registros, consulte Descripción general de las exportaciones de registros .

Ver registros de cambios de estado de salud para una máquina virtual específica

Para ver las entradas de registro de una instancia administrada específica, use la consola de Google Cloud, la CLI de gcloud o REST.

gcloud logging read 'resource.type="gce_instance_group_manager" AND
    logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
    jsonPayload.instanceHealthStateChange:* AND
    labels."compute.googleapis.com/instance_name"="INSTANCE_NAME"' \
    --limit 10

curl -H "Content-Type: application/json" -H "Authorization: Bearer OAUTH2_TOKEN" -X POST -d \
'{"filter":
    "resource.type=gce_instance_group_manager AND
        logName=projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events AND
        jsonPayload.instanceHealthStateChange:* AND
        labels.\"compute.googleapis.com/instance_name\"=\"INSTANCE_NAME\"",
    "orderBy": "timestamp desc",
    "pageSize": 10,
    "resourceNames": ["projects/PROJECT_ID"]
}' https://logging.googleapis.com/v2/entries:list?alt=json

Formato de las entradas del registro

Las entradas del registro de cambios del estado de salud de la instancia contienen información útil para monitorear y depurar el estado de sus instancias administradas.

Los registros se escriben en registros de plataforma con el nombre de registro instance_group_manager_events . Los registros de la plataforma le ayudan a depurar y solucionar problemas.

logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events"

Las entradas del registro de cambios de estado de salud contienen los siguientes tipos de información:

• Información general que se muestra en la mayoría de los registros, como gravedad, ID del proyecto, nombre e ID de MIG, número de proyecto, marca de tiempo, etc.
• Campos específicos del estado de salud de la instancia.

Dentro de cada entrada del registro de cambios de estado de salud, el campo jsonPayload.instanceHealthStateChange contiene la siguiente información:

Los campos de registro de tipo booleano normalmente solo aparecen si tienen un valor true . Si un campo booleano tiene un valor false , ese campo se omite del registro.

Se aplica la codificación UTF-8 para los campos de registro. Los caracteres que no son UTF-8 se reemplazan por signos de interrogación.

Ejemplo de entrada de registro

El siguiente ejemplo muestra el cambio del estado de salud de una instancia de VM de HEALTHY a UNHEALTHY :

  {
    "logName": "projects/my-project/logs/compute.googleapis.com%2Finstance_group_manager_events",
    "resource": {
      "type": "gce_instance_group_manager",
      "labels": {
        "instance_group_manager_id": "3138236342290985981",
        "instance_group_manager_name": "my-mig",
        "project_id": "my-project",
        "location": "europe-west3"
      }
    },
    "labels": {
      "compute.googleapis.com/instance_id": "6498902454451155884",
      "compute.googleapis.com/instance_location": "europe-west3-a",
      "compute.googleapis.com/instance_name": "my-mig-a"
    },
    "timestamp": "2019-11-19T15:47:57.127Z",
    "severity": "INFO",
    "jsonPayload": {
      "@type": "type.googleapis.com/compute.InstanceGroupManagerEvent",
      "instanceHealthStateChange": {
        "instance": "projects/my-project/zones/europe-west3-a/instances/my-mig-a",
        "instanceWithId": "projects/123456/zones/europe-west3-a/instances/6498902454451155884",
        "ipAddress": "10.0.0.4",
        "network": "projects/my-project/global/networks/net-1",
        "networkWithId": "projects/123456/global/networks/456",
        "healthCheck": "projects/my-project/global/healthChecks/my-mig-health-check",
        "previousDetailedHealthState": "HEALTHY",
        "detailedHealthState": "UNHEALTHY",
        "notificationTime": "2019-11-19T15:47:56.444Z"
      }
    },
    "receiveTimestamp": "2019-11-19T15:47:57.296439184Z"
  }
  

Casos de uso

Puede utilizar los registros de cambios de estado de salud en los siguientes escenarios de supervisión o depuración:

• Descubra con qué frecuencia una instancia de VM en particular cambió su estado de salud a lo largo del tiempo.
• Evaluar con qué frecuencia un MIG experimentó cambios en el estado de salud de sus instancias.
• Identifique instancias de VM problemáticas que con frecuencia no son UNHEALTHY .
• Descubra qué provocó un intento de autocuración.
• Descubra si un intento de reparación automática tuvo éxito para una instancia de VM específica.
• Ajuste la configuración de verificación de estado para una aplicación determinando un retraso inicial apropiado para la reparación automática.

Monitoreo de cambios en el estado de salud de una VM

Puede monitorear la frecuencia con la que cambia el estado de salud de una instancia de VM creando una métrica que rastree los cambios en el estado de salud de esa VM en particular.

Para crear la métrica y monitorear los cambios, haga lo siguiente:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el Generador de consultas , utilizando el ID de su proyecto y el nombre de la instancia.

   resource.type="gce_instance_group_manager" AND
   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
   jsonPayload.instanceHealthStateChange:* AND
   labels."compute.googleapis.com/instance_name"="INSTANCE_NAME"
   

3. En la sección Resultados de la consulta , haga clic en Acciones y luego haga clic en Crear métrica .

4. En la página Crear métrica de registros , haga lo siguiente:

   1. Establezca el tipo de métrica como contador .

   2. Introduzca un nombre de métrica de registro , por ejemplo health-mig-xyzq .

      La sección Filtro de compilación muestra la consulta de registro desde el Explorador de registros . También puede configurar el filtro de la métrica para que tenga en cuenta solo estados disruptivos, como UNHEALTHY y TIMEOUT , agregando severity>=WARNING al filtro.

   3. En Etiquetas , haga clic en Agregar etiqueta .

   4. Introduzca un nombre de etiqueta , por ejemplo health_state .

   5. Establezca el tipo de etiqueta como STRING .

   6. Establezca el nombre del campo en jsonPayload.instanceHealthStateChange.detailedHealthState . Esto le permitirá distinguir entre diferentes cambios en el estado de salud.

   7. Haga clic en Listo para agregar la etiqueta.

   8. Haga clic en Crear métrica .

5. Vaya a la página Métricas basadas en registros y busque la métrica recién creada.

6. Haga clic en el menú more_vert en la fila de la métrica y seleccione Ver en el Explorador de métricas . El explorador de métricas se abre y muestra el gráfico que representa los cambios en el estado de salud de la instancia de VM que especificó en la consulta.

Monitoreo de cambios en el estado de salud de todas las máquinas virtuales en un MIG

Puede monitorear los cambios en el estado de salud de todas las instancias administradas creando una métrica que rastree los cambios en el estado de salud de las instancias administradas.

Para crear la métrica y monitorear los cambios, haga lo siguiente:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el generador de consultas , utilizando el ID de su proyecto y el nombre del grupo de instancias administrado.

   resource.type="gce_instance_group_manager" AND
   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
   jsonPayload.instanceHealthStateChange:* AND
   resource.labels.instance_group_manager_name="MIG_NAME"
   

3. En la sección Resultados de la consulta , haga clic en Acciones y luego haga clic en Crear métrica .

4. En la página Crear métrica de registros , haga lo siguiente:

   1. Establezca el tipo de métrica como contador .
   2. Introduzca un nombre de métrica de registro , por ejemplo health-mig-xyzq .
   3. En Etiquetas , haga clic en Agregar etiqueta .
   4. Introduzca un nombre de etiqueta , por ejemplo health_state .
   5. Establezca el tipo de etiqueta como STRING .
   6. Establezca el nombre del campo en jsonPayload.instanceHealthStateChange.detailedHealthState . Esto le permitirá distinguir entre diferentes cambios en el estado de salud.
   7. Haga clic en Listo para agregar la etiqueta.
   8. Haga clic en Crear métrica .

5. Vaya a la página Métricas basadas en registros y busque la métrica recién creada.

6. Haga clic en el menú more_vert en la fila de la métrica y seleccione Ver en el Explorador de métricas . El explorador de métricas se abre y muestra el gráfico que representa los cambios en el estado de salud de todas las instancias de VM en el grupo de instancias administrado que especificó en la consulta.

Identificar máquinas virtuales que con frecuencia no funcionan correctamente

Puede identificar máquinas virtuales problemáticas que con frecuencia no están UNHEALTHY creando una métrica que rastree los cambios en el estado de salud de todas las instancias de VM en su MIG y agrupando la métrica por instancias.

Para crear la métrica y agrupar por instancias, haga lo siguiente:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el generador de consultas , utilizando el ID de su proyecto y el nombre del grupo de instancias administrado.

   resource.type="gce_instance_group_manager" AND
   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
   jsonPayload.instanceHealthStateChange:* AND
   resource.labels.instance_group_manager_name="MIG_NAME"
   

3. En la sección Resultados de la consulta , haga clic en Acciones y luego haga clic en Crear métrica .

4. En la página Crear métrica de registros , haga lo siguiente:

   1. Establezca el tipo de métrica como contador .
   2. Introduzca un nombre de métrica de registro , por ejemplo health-mig-xyzq .
   3. En Etiquetas , haga clic en Agregar etiqueta .
   4. Introduzca un nombre de etiqueta , por ejemplo health_state .
   5. Establezca el tipo de etiqueta como STRING .
   6. Establezca el nombre del campo en jsonPayload.instanceHealthStateChange.detailedHealthState . Esto le permitirá distinguir entre diferentes cambios en el estado de salud.
   7. Haga clic en Listo para agregar la etiqueta.
   8. De manera similar, agregue una segunda etiqueta, por ejemplo instance , con el nombre del campo establecido en jsonPayload.instanceHealthStateChange.instance .
   9. Haga clic en Crear métrica .

5. Vaya a la página Métricas basadas en registros y busque la métrica recién creada.

6. Haga clic en el menú more_vert en la fila de la métrica y seleccione Ver en el Explorador de métricas . El explorador de métricas se abre y muestra el gráfico que representa los cambios en el estado de salud de todas las instancias de VM en el grupo de instancias administrado que especificó en la consulta.

7. Configure Agrupar por instance para ver el número agregado de cambios de estado de salud para cada instancia.

Las instancias con la mayor cantidad de cambios en el estado de salud en conjunto son las que con mayor frecuencia no funcionan correctamente.

Comprobando qué causó un intento de autocuración

Puede descubrir qué causó un intento de reparación automática filtrando los registros de las operaciones repair para una instancia de VM determinada.

Para filtrar las operaciones de reparación, haga lo siguiente:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el Generador de consultas , utilizando el ID de su proyecto y el nombre de la instancia.

   resource.type="gce_instance" AND
   logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" AND
   protoPayload.methodName="compute.instances.repair.recreateInstance" AND
   protoPayload.resourceName=~"/INSTANCE_NAME$"
   

3. Haga clic en Ejecutar consulta . Los resultados de la consulta mostrarán todos los intentos de reparación automática en la máquina virtual con el motivo de la reparación automática en protoPayload.status.message .

Comprobar si la reparación automática tuvo éxito para una VM

Puede averiguar si un intento de reparación automática tuvo éxito para una instancia de VM filtrando los registros de operaciones repair y cambios de estado por nombre de instancia de VM. Si el estado de salud de la instancia cambió a HEALTHY después de una operación de reparación, verá el registro de cambios de estado de salud correspondiente. Sigue los pasos:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el Generador de consultas , utilizando el ID de su proyecto y el nombre de la instancia.

   (resource.type="gce_instance" AND
   logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Fsystem_event" AND
   protoPayload.methodName="compute.instances.repair.recreateInstance" AND
   protoPayload.resourceName=~"/INSTANCE_NAME$")
   OR
   (resource.type="gce_instance_group_manager" AND
   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
   jsonPayload.instanceHealthStateChange:* AND
   labels."compute.googleapis.com/instance_name"="INSTANCE_NAME")
   

   La primera parte de la consulta muestra las operaciones de reparación de la instancia, que indican que la recuperación automática de MIG activó la recreación para que la instancia vuelva a estar sana. La segunda parte de la consulta muestra todos los cambios en el estado de salud de la instancia de VM.

   En los resultados de la consulta , el evento de cambio de estado de salud con el estado de salud detailedHealthState establecido en HEALTHY poco después de una operación de reparación muestra que el intento de reparación automática fue exitoso.

Determinación del valor de retardo inicial de un MIG

Determinar un valor de retraso inicial apropiado para la reparación automática de MIG es más fácil con el registro del estado de salud de la instancia de VM. Puede utilizar registros para observar el tiempo entre el momento en que finalizó la operación instances.insert y el momento en que se recibió la primera señal saludable para un conjunto de instancias de un grupo. Este intervalo de tiempo revela cuánto tardan las instancias en iniciarse por completo. Como algunas máquinas virtuales pueden iniciarse más lentamente que otras, Google recomienda agregar algo de margen al tiempo de inicialización observado (desde la operación de inserción hasta el estado saludable) al especificar el retraso inicial en la política de reparación automática.

Para medir el tiempo entre la operación de inserción de la instancia y el estado de la instancia, ejecute una consulta para las operaciones insert y los registros de cambios de estado por nombre de instancia de VM. Utilice marcas de tiempo de ambas operaciones para calcular el tiempo de inicialización de la instancia. Sigue los pasos:

1. Vaya al Explorador de registros en la consola de Google Cloud.

   Ir al Explorador de registros

2. Ingrese la siguiente consulta en el Generador de consultas , utilizando el ID de su proyecto y el nombre de la instancia.

   (resource.type="gce_instance" AND
   logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity" AND
   protoPayload.request.@type="type.googleapis.com/compute.instances.insert" AND
   operation.last="true" AND
   protoPayload.resourceName=~"/INSTANCE_NAME$") OR
   (resource.type="gce_instance_group_manager" AND
   logName="projects/PROJECT_ID/logs/compute.googleapis.com%2Finstance_group_manager_events" AND
   jsonPayload.instanceHealthStateChange:* AND
   labels."compute.googleapis.com/instance_name"="INSTANCE_NAME")
   

   La primera parte de la consulta muestra la finalización de la operación de inserción de VM. La segunda parte muestra todos los cambios en el estado de salud de la VM.

   En los resultados de la consulta , la marca de tiempo del evento de cambio de estado de salud con el estado de salud detailedHealthState establecido en HEALTHY poco después de la operación de inserción revela el tiempo necesario para que se inicie esta máquina virtual.

3. Repita los pasos para algunas máquinas virtuales más para obtener un mejor valor aproximado del parámetro de retraso inicial.