Monitoraggio dello stato di integrità

Le istanze di blocchi note gestiti dall'utente offrono diversi metodi per monitorare l'integrità dei blocchi note. In questa pagina viene descritto come utilizzare ciascun metodo.

Metodi per il monitoraggio dello stato di integrità

Puoi monitorare l'integrità delle istanze dei blocchi note gestiti dall'utente in diversi modi. In questa pagina viene descritto come utilizzare i seguenti metodi:

• Usare gli attributi guest per segnalare lo integrità del sistema

• Segnalare metriche personalizzate a Cloud Monitoring

• Segnala le metriche di sistema e delle applicazioni a Monitoring installando Monitoring su un'istanza di blocchi note gestiti dall'utente

• Utilizzare lo strumento di diagnostica

configura gcloud CLI

Installa Google Cloud CLI, quindi initialize eseguendo questo comando:

gcloud init

Utilizzare gli attributi guest per generare report sullo stato del sistema

Puoi utilizzare gli attributi guest per segnalare l'integrità del sistema dei seguenti servizi principali:

• Servizio Docker
• Agente proxy inverso Docker
• Servizio Jupyter
• API Jupyter

Gli attributi guest sono un tipo specifico di metadati personalizzati su cui le applicazioni possono scrivere durante l'esecuzione nell'istanza di blocchi note gestiti dall'utente. Per saperne di più sugli attributi guest, consulta Informazioni sui metadati della VM.

In che modo le istanze utilizzano gli attributi guest per generare report sull'integrità del sistema

Il servizio notebooks-collection-agent esegue un processo Python in background che verifica lo stato dei servizi principali dell'istanza di blocchi note gestiti dall'utente e aggiorna gli attributi guest come 1 se non vengono rilevati problemi o -1 se viene rilevato un errore.

Per utilizzare il servizio notebooks-collection-agent per generare report sull'integrità dell'istanza di blocchi note gestiti dall'utente, devi abilitare i seguenti attributi guest durante la creazione di un'istanza di blocchi note gestiti dall'utente:

• enable-guest-attributes=TRUE: abilita gli attributi guest sulla tua istanza di blocchi note gestiti dall'utente. Tutte le nuove istanze abilitano questo attributo per impostazione predefinita.
• report-system-health=TRUE: registra i risultati del controllo di integrità del sistema negli attributi guest.

Il servizio notebooks-collection-agent non richiede autorizzazioni speciali per scrivere negli attributi guest dell'istanza.

Crea un'istanza di blocchi note gestiti dall'utente con gli attributi guest di integrità del sistema abilitati

Per utilizzare gli attributi guest di integrità del sistema per generare report sull'integrità dell'istanza di blocchi note gestiti dall'utente, devi selezionare la casella di controllo Abilita report di integrità del sistema quando crei un'istanza di blocchi note gestiti dall'utente.

Puoi abilitare il report di integrità del sistema utilizzando la console Google Cloud o Google Cloud CLI.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API Notebooks.

   Abilita l'API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API Notebooks.

   Abilita l'API

8. Se prevedi di utilizzare GPU con la tua istanza di blocchi note gestiti dall'utente, controlla la pagina delle quote nella console Google Cloud per assicurarti di disporre di un numero sufficiente di GPU nel progetto. Se le GPU non sono elencate nella pagina delle quote o se hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta Richiesta di un aumento della quota nella pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato tu il progetto, disponi del ruolo IAM Proprietario (roles/owner) per il progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e inizia a creare la tua istanza di blocchi note gestiti dall'utente. Se non hai creato tu il progetto, continua in questa sezione.

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente i seguenti ruoli IAM sul progetto:

• Amministratore blocchi note (roles/notebooks.admin)
• Utente account di servizio (roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di concedere al tuo account utente le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea l'istanza

Monitora lo stato del sistema tramite attributi guest

Per le istanze di blocchi note gestiti dall'utente in cui sono abilitati gli attributi guest correlati, puoi recuperare i valori degli attributi guest di integrità del sistema utilizzando la console Google Cloud, Google Cloud CLI con i comandi di Compute Engine o Google Cloud CLI con i comandi Vertex AI Workbench.

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

 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

 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 notebooks instances is-healthy example-instance \
    --location=ZONE

  {
          "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"
  }

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

Segnala metriche personalizzate a Monitoring

Le istanze di blocchi note gestiti dall'utente ti consentono di raccogliere metriche sullo stato del sistema e JupyterLab e di segnalarle a Cloud Monitoring. Queste metriche personalizzate sono diverse da quelle standard registrate quando installi Monitoring sulla tua istanza di blocchi note gestiti dall'utente.

Le metriche personalizzate segnalate a Monitoring includono:

• Integrità del sistema di questi servizi principali di blocchi note gestiti dall'utente:

  • Servizio Docker
  • Agente proxy inverso Docker
  • Servizio Jupyter
  • API Jupyter

• Le seguenti metriche JupyterLab:

  • Numero di kernel
  • Numero di terminal
  • Numero di connessioni
  • Numero di sessioni
  • Memoria massima
  • Con memoria elevata
  • Memoria attuale

In che modo le istanze segnalano le metriche personalizzate a Monitoring

Per segnalare metriche personalizzate a Monitoring, devi abilitare l'impostazione dei metadati report-notebook-metrics durante la creazione di un'istanza di blocchi note gestiti dall'utente.

Devi inoltre assicurarti che l'account di servizio dell'istanza di blocchi note gestiti dall'utente disponga delle autorizzazioni di Monitoring Metric Writer (roles/monitoring.metricWriter). Per maggiori informazioni, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Crea un'istanza di blocchi note gestiti dall'utente che invii le metriche personalizzate a Monitoring

Per segnalare metriche personalizzate a Monitoring, devi selezionare la casella di controllo Segnala metriche personalizzate a Cloud Monitoring quando crei un'istanza di blocchi note gestiti dall'utente.

Puoi abilitare la generazione di report di metriche personalizzate in Cloud Monitoring utilizzando la console Google Cloud o Google Cloud CLI.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API Notebooks.

   Abilita l'API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API Notebooks.

   Abilita l'API

8. Se prevedi di utilizzare GPU con la tua istanza di blocchi note gestiti dall'utente, controlla la pagina delle quote nella console Google Cloud per assicurarti di disporre di un numero sufficiente di GPU nel progetto. Se le GPU non sono elencate nella pagina delle quote o se hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta Richiesta di un aumento della quota nella pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato tu il progetto, disponi del ruolo IAM Proprietario (roles/owner) per il progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e inizia a creare la tua istanza di blocchi note gestiti dall'utente. Se non hai creato tu il progetto, continua in questa sezione.

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente i seguenti ruoli IAM sul progetto:

• Amministratore blocchi note (roles/notebooks.admin)
• Utente account di servizio (roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di concedere al tuo account utente le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea l'istanza

Concedi le autorizzazioni Writer metriche di Monitoring all'account di servizio

Dopo aver creato la nuova istanza di blocchi note gestiti dall'utente, concedi le autorizzazioni di Monitoring Metric Writer (roles/monitoring.metricWriter) all'account di servizio per l'istanza di blocchi note gestiti dall'utente. Per maggiori informazioni, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Monitora le metriche personalizzate tramite Monitoring

Per le istanze di blocchi note gestiti dall'utente in cui sono abilitate le metriche personalizzate per la generazione di report, puoi monitorare le metriche personalizzate utilizzando la console Google Cloud.

1. Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente.

   Vai ai blocchi note gestiti dall'utente

2. Fai clic sul nome dell'istanza di cui vuoi visualizzare le metriche personalizzate.

3. Nella pagina Dettagli blocco note, fai clic sulla scheda Monitoring. Esamina le metriche personalizzate per la tua istanza.

Installa Monitoring su un'istanza

Questa opzione installa automaticamente Monitoring. L'installazione richiede 256 MB di spazio su disco. Per segnalare le metriche a Monitoring è necessaria una connessione a internet.

In che modo le istanze segnalano le metriche del sistema e delle applicazioni

Per generare report sulle metriche di sistema e delle applicazioni installando Cloud Monitoring sull'istanza di blocchi note gestiti dall'utente, devi selezionare la casella di controllo Installa agente Cloud Monitoring quando crei un'istanza di blocchi note gestiti dall'utente. Queste metriche sono diverse da quelle personalizzate che vengono segnalate quando attivi l'impostazione dei metadati report-notebook-metrics.

Crea un'istanza di blocchi note gestiti dall'utente che segnali le metriche del sistema e delle applicazioni a Monitoring

Per installare Monitoring sulla tua istanza di blocchi note gestiti dall'utente, puoi utilizzare la console Google Cloud o Google Cloud CLI.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API Notebooks.

   Abilita l'API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API Notebooks.

   Abilita l'API

8. Se prevedi di utilizzare GPU con la tua istanza di blocchi note gestiti dall'utente, controlla la pagina delle quote nella console Google Cloud per assicurarti di disporre di un numero sufficiente di GPU nel progetto. Se le GPU non sono elencate nella pagina delle quote o se hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta Richiesta di un aumento della quota nella pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato tu il progetto, disponi del ruolo IAM Proprietario (roles/owner) per il progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e inizia a creare la tua istanza di blocchi note gestiti dall'utente. Se non hai creato tu il progetto, continua in questa sezione.

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente i seguenti ruoli IAM sul progetto:

• Amministratore blocchi note (roles/notebooks.admin)
• Utente account di servizio (roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di concedere al tuo account utente le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea l'istanza

Monitoraggio delle metriche di sistema e delle applicazioni tramite Monitoring

Per le istanze di blocchi note gestiti dall'utente in cui è installato Monitoring, puoi monitorare le metriche del sistema e delle applicazioni utilizzando la console Google Cloud:

1. Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente.

   Vai ai blocchi note gestiti dall'utente

2. Fai clic sul nome dell'istanza di cui vuoi visualizzare le metriche di sistema e delle applicazioni.

3. Nella pagina Dettagli blocco note, fai clic sulla scheda Monitoring. Esamina le metriche di sistema e delle applicazioni per l'istanza. Per scoprire come interpretare queste metriche, consulta Esaminare le metriche delle risorse.

Utilizzare lo strumento di diagnostica per monitorare lo stato di integrità del sistema

Le istanze di blocchi note gestiti dall'utente includono uno strumento di diagnostica integrato che consente di monitorare l'integrità del sistema delle istanze.

Attività eseguite dallo strumento di diagnostica

Lo strumento di diagnostica esegue le seguenti attività:

• Verifica lo stato dei seguenti servizi principali di blocchi note gestiti dall'utente:

  • Servizio Docker
  • Agente proxy inverso Docker
  • Servizio Jupyter
  • API Jupyter

• Controlla se lo spazio su disco per l'avvio e i dischi dati viene utilizzato oltre una soglia dell'85%.

• Installazioni lsof (è richiesta una connessione a internet).

• Raccoglie i seguenti log di istanza:

  • Informazioni sulla rete (ifconfig, netstat)
  • Log nella cartella /var/log/
  • Informazioni sullo stato Docker
  • Dati di lsof (file aperti)
  • Stato del servizio Docker
  • Stato dell'agente inverso del proxy
  • Stato del servizio Jupyter
  • Stato dell'API Jupyter
  • File di configurazione dell'agente proxy
  • Processi Python

• Esegue i comandi seguenti e raccoglie i risultati:

  • blocco pip
  • elenco conda
  • Le istanze gcloud compute descrivono INSTANCE_NAME
  • elenco di configurazione gcloud

Esegui lo strumento di diagnostica

Per eseguire lo strumento di diagnostica, completa i seguenti passaggi:

1. Utilizza SSH per connetterti all'istanza dei blocchi note gestiti dall'utente.

2. Nel terminale SSH, esegui questi comandi:

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

   Lo strumento di diagnostica raccoglie i log, li comprime in un file .tar.gz e li inserisce nella cartella /tmp/.

3. Estrai il file e valuta i contenuti. I contenuti includono:

   • Cartella log: log dalla cartella var/log/
   • report.log: output per tutti i comandi raccolti
   • proxy-agent-config.json: informazioni sulla configurazione proxy
   • Log Docker: un file -json.log che include i log del container Docker

Puoi utilizzare le seguenti opzioni con lo strumento di diagnostica.

Passaggi successivi

• Scopri di più sui metadati della VM.

• Scopri di più su Monitoring.