Monitora il cluster Ray su Gemini Enterprise Agent Platform

Questa pagina spiega come visualizzare i log di monitoraggio associati ai tuoi cluster Ray e monitorare le metriche di Ray on Agent Platform. Vengono inoltre fornite indicazioni per il debug dei cluster Ray.

Visualizza i log

Quando esegui attività con il cluster Ray su Gemini Enterprise Agent Platform, i log di monitoraggio vengono generati e archiviati automaticamente sia in Cloud Logging sia nella dashboard Ray open source. Questa sezione descrive come accedere ai log generati tramite la console Google Cloud .

Prima di iniziare, assicurati di leggere la panoramica di Ray on Agent Platform e di configurare tutti gli strumenti prerequisiti necessari.

Dashboard Ray OSS

Puoi visualizzare i file di log di Ray open source tramite la dashboard Ray OSS:

1. Nella console Google Cloud , vai alla pagina Ray on Agent Platform.

   Vai alla pagina Ray on Agent Platform

2. Nella riga del cluster che hai creato, seleziona il menu Altre azioni.

3. Seleziona il link alla dashboard Ray OSS. La dashboard si apre in un'altra scheda.

4. Vai alla visualizzazione Log nell'angolo in alto a destra del menu:

   

5. Fai clic su ogni nodo per visualizzare i file di log associati.

Console Cloud Logging

1. Nella console Google Cloud , vai alla pagina segmento Esplora log:

   Vai a Esplora log

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Logging.

2. Seleziona un progetto, una cartella o un'organizzazione Google Cloud esistente.

3. Per visualizzare tutti i log Ray, inserisci la seguente query nel campo dell'editor query, quindi fai clic su Esegui query:

   resource.labels.task_name="ray-cluster-logs"

4. Per restringere i log a un cluster Ray specifico, aggiungi la seguente riga alla query e poi fai clic su Esegui query:

   labels."ml.googleapis.com/ray_cluster_id"=CLUSTER_NAME

   Sostituisci CLUSTER_NAME con il nome del tuo cluster Ray. Nella console Google Cloud vai a Gemini Enterprise Agent Platform > Ray on Agent Platform dove vedrai un elenco dei nomi dei cluster in ogni regione.

5. Per restringere ulteriormente i log a un file di log specifico come raylet.out, fai clic sul nome del log in Campi log -> Nome log.

6. Puoi raggruppare le voci di log simili:

   1. In Risultati delle query, fai clic su una voce di log per espanderla.

   2. Nel jsonPayload, fai clic sul valore tailed_path. Viene visualizzato un menu a discesa.

   3. Fai clic su Mostra voci corrispondenti.

Disattiva log

Per impostazione predefinita, Ray on Vertex AI Cloud Logging è abilitato.

• Per disattivare l'esportazione dei log di Ray in Cloud Logging, utilizza il seguente comando dell'SDK Agent Platform per Python:

  vertex_ray.create_ray_cluster(..., enable_logging=False, ...)
  

Puoi visualizzare i file di log di Ray nella dashboard di Ray anche se la funzionalità Ray on Agent Platform Cloud Logging è disattivata.

Monitora le metriche

Puoi visualizzare le metriche di Ray on Agent Platform in diversi modi utilizzando Google Cloud Monitoring (GCM). In alternativa, puoi esportare le metriche da GCM al tuo server Grafana.

Nota :consulta Google Cloud Managed Service per Prometheus (GMP) per informazioni su prezzi e archiviazione dei dati.

Monitorare le metriche in GCM

Esistono due modi per visualizzare le metriche di Ray on Agent Platform in GCM.

• Utilizza la visualizzazione diretta in Esplora metriche.

• Importa la dashboard Grafana.

Esplora metriche

Per utilizzare la visualizzazione diretta in Esplora metriche, segui questi passaggi:

1. Vai alla console Google Cloud Monitoring.
2. Nella sezione Esplora, seleziona Esplora metriche.
3. In Risorse attive, seleziona Destinazione Prometheus. Viene visualizzato Categorie di metriche attive.

4. Seleziona Ray.

   Viene visualizzato un elenco di metriche:

   
5. Seleziona le metriche che vuoi monitorare. Ad esempio:
   1. Scegli la percentuale di utilizzo della CPU come metrica monitorata:
      
      
   2. Seleziona un filtro. Ad esempio, seleziona il cluster:
      Utilizza l'ID cluster per monitorare solo le metriche precedenti per un cluster specifico. Per trovare l'ID cluster, segui questi passaggi:

      1. Nella console Google Cloud , vai alla pagina Ray.

         Vai a Ray

      2. Assicurati di essere nel progetto in cui vuoi creare l'esperimento.
         
      3. Sotto Nome viene visualizzato un elenco di ID cluster.
      
   3. Seleziona il metodo di aggregazione per visualizzare le metriche. ovvero puoi scegliere di visualizzare le metriche non aggregate, che mostrano l'utilizzo della CPU di ogni processo Ray:
      

Dashboard GCM

Per importare una dashboard Grafana per Ray su Agent Platform, segui le linee guida riportate nella dashboard di Cloud Monitoring, Importa la tua dashboard Grafana.

Tutto ciò che ti serve è un file JSON della dashboard Grafana. OSS Ray supporta questa configurazione manuale fornendo il file JSON della dashboard Grafana predefinita.

Monitora le metriche

da Grafana di proprietà dell'utente

Se hai già un server Grafana in esecuzione, esiste anche un modo per esportare tutte le metriche Prometheus del cluster Ray su Gemini Enterprise Agent Platform nel server Grafana esistente. Per farlo, segui le indicazioni Query utilizzando Grafana di GMP. In questo modo puoi aggiungere una nuova origine dati Grafana al server Grafana esistente e utilizzare lo strumento di sincronizzazione delle origini dati per sincronizzare la nuova origine dati Grafana Prometheus con le metriche di Ray on Agent Platform.

È importante configurare e autenticare l'origine dati Grafana appena aggiunta utilizzando lo strumento di sincronizzazione delle origini dati. Segui i passaggi descritti in Configurare e autenticare l'origine dati Grafana.

Una volta sincronizzati, puoi creare e aggiungere qualsiasi dashboard ti serva in base alle metriche di Ray su Agent Platform.

Per impostazione predefinita, le raccolte di metriche Ray on Agent Platform sono abilitate. Ecco come disattivarli utilizzando l'SDK Agent Platform per Python:

vertex_ray.create_ray_cluster(..., enable_metrics_collection=False, ...)

Esegui il debug dei cluster Ray

Per eseguire il debug dei cluster Ray, utilizza la shell interattiva del nodo head:

Nota: utilizza la shell interattiva solo per il debug o altre operazioni avanzate non supportate in altri modi. Non è consigliato per le normali operazioni come l'esecuzione dei workload.

Console Google Cloud

Per accedere alla shell interattiva del nodo head:

1. Nella console Google Cloud , vai alla pagina Ray on Agent Platform.
   Vai a Ray on Agent Platform
2. Assicurati di trovarti nel progetto corretto.
   
3. Seleziona il cluster da esaminare. Viene visualizzata la sezione Informazioni di base.
4. Nella sezione Link di accesso, fai clic sul link per Shell interattiva del nodo head. Viene visualizzata la shell interattiva del nodo head.
5. Segui le istruzioni descritte in Monitoraggio e debug dell'addestramento con una shell interattiva.

Passaggi successivi

• Eliminare un cluster Ray