Monitorizar el estado

Las instancias de cuadernos gestionados por usuarios ofrecen varios métodos para monitorizar el estado de tus cuadernos. En esta página se describe cómo usar cada método.

Métodos para monitorizar el estado de salud

Puedes monitorizar el estado de tus instancias de cuadernos gestionados por el usuario de varias formas. En esta página se describe cómo usar los siguientes métodos:

• Usar atributos de invitado para generar informes sobre el estado del sistema

• Enviar métricas personalizadas a Cloud Monitoring

• Informar de las métricas del sistema y de las aplicaciones a Monitoring instalando Monitoring en una instancia de cuadernos gestionados por usuarios

• Usar la herramienta de diagnóstico

Configurar gcloud CLI

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

gcloud init

Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

Usar atributos de invitado para informar sobre el estado del sistema

Puedes usar atributos de invitado para informar sobre el estado del sistema de los siguientes servicios principales:

• Servicio Docker
• Agente de proxy inverso de Docker
• Servicio de Jupyter
• API de Jupyter

Los atributos de invitado son un tipo específico de metadatos personalizados que las aplicaciones pueden escribir mientras se ejecutan en la instancia de notebooks gestionada por el usuario. Para obtener más información sobre los atributos de invitado, consulta Información sobre los metadatos de máquinas virtuales.

Cómo usan las instancias los atributos de invitado para informar sobre el estado del sistema

El servicio notebooks-collection-agent ejecuta un proceso de Python en segundo plano que verifica el estado de los servicios principales de la instancia de cuadernos gestionados por el usuario y actualiza los atributos de invitado como 1 si no se detectan problemas o como -1 si se detecta un fallo.

Para usar el servicio notebooks-collection-agent y generar informes sobre el estado de tu instancia de cuadernos gestionados por usuarios, debes habilitar los siguientes atributos de invitado al crear una instancia de cuadernos gestionados por usuarios:

• enable-guest-attributes=TRUE: de esta forma, se habilitan los atributos de invitado en tu instancia de cuadernos gestionados por usuarios. Todas las instancias nuevas habilitan este atributo de forma predeterminada.
• report-system-health=TRUE: registra los resultados de la comprobación del estado del sistema en los atributos de invitado.

El servicio notebooks-collection-agent no necesita ningún permiso especial para escribir en los atributos de invitado de la instancia.

Crear una instancia de cuadernos gestionados por usuarios con atributos de invitado de estado del sistema habilitados

Para usar los atributos de invitado de estado del sistema para informar sobre el estado de tu instancia de cuadernos gestionados por el usuario, debes seleccionar la casilla Habilitar informe de estado del sistema al crear una instancia de cuadernos gestionados por el usuario.

Puedes habilitar el informe de estado del sistema mediante la Google Cloud consola o la CLI de Google Cloud.

Antes de empezar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

1. Si tienes previsto usar GPUs con tu instancia de notebooks gestionados por el usuario, consulta la página de cuotas de la consola Google Cloud para asegurarte de que tienes suficientes GPUs disponibles en tu proyecto. Si las GPUs no aparecen en la página de cuotas o necesitas más cuota de GPU, puedes solicitar un aumento. Consulta la sección Solicitar un aumento de cuota de la página Cuotas de recursos de Compute Engine.

Roles obligatorios

Si has creado el proyecto, tienes el rol de gestión de identidades y accesos Propietario (roles/owner) en el proyecto, que incluye todos los permisos necesarios. Salta esta sección y empieza a crear tu instancia de cuadernos gestionados por usuarios. Si no has creado el proyecto tú mismo, sigue las instrucciones de esta sección.

Para obtener los permisos que necesitas para crear una instancia de notebooks administrados por el usuario de Vertex AI Workbench, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Administrador de cuadernos (roles/notebooks.admin)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear la instancia

Consola

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario. También puedes ir a notebook.new (https://notebook.new) y saltarte el siguiente paso.

   Ir a Cuadernos gestionados por usuarios

2. Haz clic en add_box Nuevo cuaderno y, a continuación, selecciona Personalizar.

3. En la página Crear un cuaderno gestionado por el usuario, en la sección Detalles, proporciona la siguiente información de tu nueva instancia:

   • Nombre: el nombre de la nueva instancia
   • Región y Zona: selecciona una región y una zona para la nueva instancia. Para obtener el mejor rendimiento de red, selecciona la región que esté geográficamente más cerca de ti. Consulta las ubicaciones de los cuadernos gestionados por usuarios disponibles.

4. Selecciona la sección Estado del sistema.

5. En la sección Estado e informes del sistema, marca la casilla Habilitar informe de estado del sistema.

6. Completa el resto del cuadro de diálogo de creación de la instancia y, a continuación, haz clic en Crear.

gcloud

1. En Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, introduce el siguiente comando de Google Cloud CLI:

   gcloud notebooks instances create INSTANCE_NAME \
       --vm-image-project=deeplearning-platform-release \
       --vm-image-family=IMAGE_FAMILY \
       --machine-type=MACHINE_TYPE \
       --location=ZONE \
       --metadata=enable-guest-attributes=TRUE,report-system-health=TRUE
   

   Haz los cambios siguientes:

   • INSTANCE_NAME: el nombre de tu nueva instancia
   • IMAGE_FAMILY: el nombre de la familia de imágenes que quieras usar para crear tu instancia
   • MACHINE_TYPE: el tipo de máquina de la VM de tu instancia; por ejemplo, n1-standard-4
   • ZONE: la zona en la que quieres que se encuentre tu nueva instancia, por ejemplo, us-west1-a.

2. Accede a tu instancia desde la consolaGoogle Cloud .

Monitorizar el estado del sistema mediante atributos de invitado

En las instancias de cuadernos gestionadas por el usuario que tienen habilitados los atributos de invitado relacionados, puedes recuperar los valores de los atributos de invitado de estado del sistema mediante la consola, la CLI de Google Cloud con comandos de Compute Engine o la CLI de Google Cloud con comandos de Vertex AI Workbench. Google Cloud

Consola

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

   Ir a Cuadernos gestionados por usuarios

2. Haga clic en el nombre de la instancia cuyo estado de salud del sistema quiera ver.

3. En la página Detalles del cuaderno, haz clic en la pestaña Estado. Consulta el estado de tu instancia y sus servicios principales.

gcloud con Compute Engine

gcloud compute instances get-guest-attributes INSTANCE_NAME \
    --zone ZONE

Haz los cambios siguientes:

• INSTANCE_NAME: el nombre de tu instancia
• ZONE: la zona en la que se encuentra tu instancia

Si sus servicios principales están en buen estado, los resultados serán similares a los siguientes. El valor 1 significa que no se ha detectado ningún fallo.

 NAMESPACE   KEY                         VALUE
 notebooks   docker_proxy_agent_status   1
 notebooks   docker_status               1
 notebooks   jupyterlab_api_status       1
 notebooks   jupyterlab_status           1
 notebooks   system-health               1
 notebooks   updated                     2020-10-01 17:00:00.12345

Si falla alguno de los cuatro servicios principales, el estado del sistema devuelve un valor -1 para indicar que el sistema ha fallado. En la mayoría de los casos, una avería del sistema significa que no se puede acceder a JupyterLab.

Un ejemplo de resultado de error podría ser el siguiente.

 NAMESPACE   KEY                         VALUE
 notebooks   docker_proxy_agent_status   -1
 notebooks   docker_status               -1
 notebooks   jupyterlab_api_status       1
 notebooks   jupyterlab_status           1
 notebooks   system-health               -1
 notebooks   updated                     2020-10-01 17:00:00.12345

gcloud con Vertex AI Workbench

Para monitorizar el estado de tu sistema, puedes usar el método getInstanceHealth para obtener los valores de tus atributos de invitado.

En el siguiente ejemplo se muestra cómo hacerlo con la CLI de gcloud.

gcloud notebooks instances is-healthy example-instance \
    --location=ZONE

Sustituye ZONE por la zona en la que se encuentra tu instancia (por ejemplo, us-west1-a).

Si sus servicios principales están en buen estado, los resultados serán similares a los siguientes. El valor 1 significa que no se ha detectado ningún fallo.

  {
          "health_state": HEALTHY,
          "docker-proxy-agent": 1,
          "docker-service": 1,
          "jupyter-service": 1,
          "jupyter-api": 1,
          "last-updated": "2020-10-01 17:00:30.12345"
  }

Un ejemplo de resultado de error podría ser el siguiente.

  {
          "healthy": UNHEALTHY,
          "docker-proxy-agent": 1,
          "docker-service": 1,
          "jupyter-service": -1,
          "jupyter-api": -1,
          "last-updated": "2020-10-01 17:00:30.12345"
  }

Registrar métricas personalizadas en Monitoring

Las instancias de cuadernos gestionados por el usuario te permiten recoger el estado del sistema y las métricas de JupyterLab, así como enviarlos a Cloud Monitoring. Estas métricas personalizadas son diferentes de las métricas estándar que se registran cuando instalas Monitoring en tu instancia de cuaderno gestionada por el usuario.

Las métricas personalizadas que se envían a Monitoring incluyen las siguientes:

• El estado del sistema de los servicios principales de estos cuadernos gestionados por usuarios:

  • Servicio Docker
  • Agente de proxy inverso de Docker
  • Servicio de Jupyter
  • API de Jupyter

• Las siguientes métricas de JupyterLab:

  • Número de kernels
  • Número de terminales
  • Número de conexiones
  • Número de sesiones
  • Memoria máxima
  • Memoria alta
  • Memoria actual

Cómo informan las instancias de métricas personalizadas a Monitoring

Para enviar métricas personalizadas a Monitoring, debes habilitar el ajuste de metadatos report-notebook-metrics al crear una instancia de notebooks gestionada por el usuario.

También debes asegurarte de que la cuenta de servicio de la instancia de notebooks gestionados por el usuario tenga permisos de escritura de métricas de Monitoring (roles/monitoring.metricWriter). Para obtener más información, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Crear una instancia de cuadernos gestionados por usuarios que registre métricas personalizadas en Monitoring

Para enviar métricas personalizadas a Monitoring, debes marcar la casilla Enviar métricas personalizadas a Cloud Monitoring cuando crees una instancia de cuadernos gestionados por usuarios.

Para habilitar la creación de informes de métricas personalizadas en Cloud Monitoring, puedes usar la Google Cloud consola o la CLI de Google Cloud.

Antes de empezar

Para crear una instancia de cuadernos gestionada por el usuario, debes tener un proyectoGoogle Cloud y habilitar la API Notebooks en ese proyecto.
Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

1. Si tienes previsto usar GPUs con tu instancia de notebooks gestionados por el usuario, consulta la página de cuotas de la consola Google Cloud para asegurarte de que tienes suficientes GPUs disponibles en tu proyecto. Si las GPUs no aparecen en la página de cuotas o necesitas más cuota de GPU, puedes solicitar un aumento. Consulta la sección Solicitar un aumento de cuota de la página Cuotas de recursos de Compute Engine.

Roles obligatorios

Si has creado el proyecto, tienes el rol de gestión de identidades y accesos Propietario (roles/owner) en el proyecto, que incluye todos los permisos necesarios. Salta esta sección y empieza a crear tu instancia de cuadernos gestionados por usuarios. Si no has creado el proyecto tú mismo, sigue las instrucciones de esta sección.

Para obtener los permisos que necesitas para crear una instancia de notebooks administrados por el usuario de Vertex AI Workbench, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Administrador de cuadernos (roles/notebooks.admin)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear la instancia

Consola

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario. También puedes ir a notebook.new (https://notebook.new) y saltarte el siguiente paso.

   Ir a Cuadernos gestionados por usuarios

2. Haz clic en add_box Nuevo cuaderno y, a continuación, selecciona Personalizar.

3. En la página Crear un cuaderno gestionado por el usuario, en la sección Detalles, proporciona la siguiente información de tu nueva instancia:

   • Nombre: el nombre de la nueva instancia
   • Región y Zona: selecciona una región y una zona para la nueva instancia. Para obtener el mejor rendimiento de red, selecciona la región que esté geográficamente más cerca de ti. Consulta las ubicaciones de los cuadernos gestionados por usuarios disponibles.

4. Selecciona la sección Estado del sistema.

5. En la sección Estado y generación de informes del sistema, marca la casilla Informar de métricas personalizadas a Cloud Monitoring.

6. Completa el resto del cuadro de diálogo de creación de la instancia y, a continuación, haz clic en Crear.

gcloud

1. En Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, introduce el siguiente comando de Google Cloud CLI:

   gcloud notebooks instances create INSTANCE_NAME \
       --vm-image-project=deeplearning-platform-release \
       --vm-image-family=IMAGE_FAMILY \
       --machine-type=MACHINE_TYPE \
       --location=ZONE \
       --metadata=report-notebook-metrics=TRUE
   

   Haz los cambios siguientes:

   • INSTANCE_NAME: el nombre de tu nueva instancia
   • IMAGE_FAMILY: el nombre de la familia de imágenes que quieras usar para crear tu instancia
   • MACHINE_TYPE: el tipo de máquina de la VM de tu instancia, por ejemplo, n1-standard-4
   • ZONE: la zona en la que quieres que se encuentre tu nueva instancia, por ejemplo, us-west1-a.

2. Accede a tu instancia desde la consolaGoogle Cloud .

Concede permisos de escritura de métricas de Monitoring a la cuenta de servicio

Una vez que hayas creado tu nueva instancia de cuadernos gestionados por el usuario, concede permisos de escritura de métricas de monitorización (roles/monitoring.metricWriter) a la cuenta de servicio de la instancia de cuadernos gestionados por el usuario. Para obtener más información, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Monitorizar métricas personalizadas a través de Monitoring

En las instancias de notebooks gestionadas por el usuario que tienen habilitada la creación de informes de métricas personalizadas, puede monitorizar sus métricas personalizadas mediante la consola de Google Cloud .

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

   Ir a Cuadernos gestionados por usuarios

2. Haga clic en el nombre de la instancia de la que quiera ver las métricas personalizadas.

3. En la página Detalles del cuaderno, haga clic en la pestaña Monitorización. Revisa las métricas personalizadas de tu instancia.

Instalar Monitoring en una instancia

Esta opción instala automáticamente la monitorización. La instalación requiere 256 MB de espacio en disco. Se necesita una conexión a Internet para que las métricas se envíen a Monitoring.

Cómo informan las instancias sobre las métricas del sistema y de las aplicaciones

Para registrar métricas del sistema y de las aplicaciones instalando Cloud Monitoring en tu instancia de cuadernos gestionados por usuarios, debes marcar la casilla Instalar el agente de Cloud Monitoring al crear una instancia de cuadernos gestionados por usuarios. Estas métricas son diferentes de las métricas personalizadas que se registran cuando habilita el ajuste de metadatos report-notebook-metrics.

Crear una instancia de cuadernos gestionados por usuarios que envíe métricas del sistema y de aplicaciones a Monitoring

Para instalar Monitoring en tu instancia de cuaderno gestionada por el usuario, puedes usar la Google Cloud consola o la CLI de Google Cloud.

Antes de empezar

Para crear una instancia de cuadernos gestionada por el usuario, debes tener un proyectoGoogle Cloud y habilitar la API Notebooks en ese proyecto.
Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Roles required to enable APIs

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.

Enable the API

1. Si tienes previsto usar GPUs con tu instancia de notebooks gestionados por el usuario, consulta la página de cuotas de la consola Google Cloud para asegurarte de que tienes suficientes GPUs disponibles en tu proyecto. Si las GPUs no aparecen en la página de cuotas o necesitas más cuota de GPU, puedes solicitar un aumento. Consulta la sección Solicitar un aumento de cuota de la página Cuotas de recursos de Compute Engine.

Roles obligatorios

Si has creado el proyecto, tienes el rol de gestión de identidades y accesos Propietario (roles/owner) en el proyecto, que incluye todos los permisos necesarios. Salta esta sección y empieza a crear tu instancia de cuadernos gestionados por usuarios. Si no has creado el proyecto tú mismo, sigue las instrucciones de esta sección.

Para obtener los permisos que necesitas para crear una instancia de notebooks administrados por el usuario de Vertex AI Workbench, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Administrador de cuadernos (roles/notebooks.admin)
• Usuario de cuenta de servicio (roles/iam.serviceAccountUser)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Crear la instancia

Consola

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario. También puedes ir a notebook.new (https://notebook.new) y saltarte el siguiente paso.

   Ir a Cuadernos gestionados por usuarios

2. Haz clic en add_box Nuevo cuaderno y, a continuación, selecciona Personalizar.

3. En la página Crear un cuaderno gestionado por el usuario, en la sección Detalles, proporciona la siguiente información de tu nueva instancia:

   • Nombre: el nombre de la nueva instancia
   • Región y Zona: selecciona una región y una zona para la nueva instancia. Para obtener el mejor rendimiento de red, selecciona la región que esté geográficamente más cerca de ti. Consulta las ubicaciones de los cuadernos gestionados por usuarios disponibles.

4. Selecciona la sección Estado del sistema.

5. En la sección Estado del sistema e informes, marca la casilla Instalar agente de Cloud Monitoring.

6. Completa el resto del cuadro de diálogo de creación de la instancia y, a continuación, haz clic en Crear.

gcloud

1. En Cloud Shell o en cualquier entorno en el que esté instalada Google Cloud CLI, introduce el siguiente comando de Google Cloud CLI:

   gcloud notebooks instances create INSTANCE_NAME \
       --vm-image-project=deeplearning-platform-release \
       --vm-image-family=IMAGE_FAMILY \
       --machine-type=MACHINE_TYPE \
       --location=ZONE \
       --metadata=install-monitoring-agent=TRUE
   

   Haz los cambios siguientes:

   • INSTANCE_NAME: el nombre de tu nueva instancia
   • IMAGE_FAMILY: el nombre de la familia de imágenes que quieras usar para crear tu instancia
   • MACHINE_TYPE: el tipo de máquina de la VM de tu instancia; por ejemplo, n1-standard-4
   • ZONE: la zona en la que quieres que se encuentre tu nueva instancia, por ejemplo, us-west1-a.

2. Accede a tu instancia desde la consolaGoogle Cloud .

Monitorizar métricas del sistema y de las aplicaciones con Monitoring

En las instancias de cuadernos gestionados por usuarios que tienen Monitoring instalado, puedes monitorizar las métricas del sistema y de las aplicaciones mediante la consola: Google Cloud

1. En la Google Cloud consola, ve a la página Notebooks gestionados por el usuario.

   Ir a Cuadernos gestionados por usuarios

2. Haga clic en el nombre de la instancia de la que quiera ver las métricas del sistema y de la aplicación.

3. En la página Detalles del cuaderno, haga clic en la pestaña Monitorización. Revisa las métricas del sistema y de las aplicaciones de tu instancia. Para saber cómo interpretar estas métricas, consulte Revisar métricas de recursos.

Usar la herramienta de diagnóstico para monitorizar el estado del sistema

Las instancias de notebooks gestionadas por el usuario incluyen una herramienta de diagnóstico integrada que puede ayudarte a monitorizar el estado del sistema de tus instancias.

Tareas que realiza la herramienta de diagnóstico

La herramienta de diagnóstico realiza las siguientes tareas:

• Verifica el estado de los siguientes servicios principales de cuadernos gestionados por el usuario:

  • Servicio Docker
  • Agente de proxy inverso de Docker
  • Servicio de Jupyter
  • API de Jupyter

• Comprueba si el espacio en disco de los discos de arranque y de datos se ha utilizado por encima del umbral del 85 %.

• Instala lsof (se requiere conexión a Internet).

• Recoge los siguientes registros de instancias:

  • Información de la red (ifconfig, netstat)
  • Registros de la carpeta /var/log/
  • Información sobre el estado de Docker
  • Datos lsof (archivos abiertos)
  • Estado del servicio Docker
  • Estado del agente de proxy inverso
  • Estado del servicio de Jupyter
  • Estado de la API de Jupyter
  • Archivo de configuración del agente proxy
  • Procesos de Python

• Ejecuta los siguientes comandos y recoge los resultados:

  • Congelar imagen en imagen
  • conda list
  • gcloud compute instances describe INSTANCE_NAME
  • gcloud config list

Ejecutar la herramienta de diagnóstico

Para ejecutar la herramienta de diagnóstico, sigue estos pasos:

1. Usa SSH para conectarte a tu instancia de cuadernos gestionados por usuarios.

2. En el terminal SSH, ejecuta los siguientes comandos:

   sudo -i
   cd /opt/deeplearning/bin/
   ./diagnostic_tool.sh

   La herramienta de diagnóstico recoge los registros, los comprime en un archivo .tar.gz y coloca el archivo en la carpeta /tmp/.

3. Extrae el archivo y evalúa su contenido. El contenido incluye lo siguiente:

   • Carpeta log: registros de la carpeta var/log/
   • report.log: salida de todos los comandos recogidos
   • proxy-agent-config.json: Información de configuración del proxy
   • Registro de Docker: un archivo -json.log que incluye registros de contenedores Docker.

Puedes usar las siguientes opciones con la herramienta de diagnóstico.

Opción	Descripción
-r	Opción de reparación que intenta restaurar el estado de los servicios principales de los cuadernos gestionados por usuarios que han fallado.
-s	Se ejecuta sin confirmación.
-b	Sube el archivo .tar.gz a un segmento de Cloud Storage.
-v	Una opción de depuración para solucionar problemas de la herramienta en caso de que falle
-c	Captura 30 segundos de tráfico de paquetes en tu instancia de cuadernos gestionados por usuarios y filtra SSH.
-d	Una carpeta de destino en la que guardar los registros
-h	Ayuda

Siguientes pasos

• Más información sobre los metadatos de máquinas virtuales

• Más información sobre la monitorización