Visualizza le metriche della pipeline

Dopo aver definito, creato ed eseguito una pipeline, puoi visualizzare le metriche relative al job o alle attività della pipeline in Metrics Explorer. Inoltre, puoi creare metriche e avvisi basati su log personalizzati utilizzando Cloud Logging per monitorare eventi come i guasti della pipeline.

Questa pagina descrive come eseguire le seguenti operazioni:

• Visualizzare le metriche standard di Vertex AI Pipelines in Esplora metriche

• Creare e visualizzare metriche personalizzate in Esplora log (anteprima)

La creazione e la visualizzazione di metriche personalizzate in Cloud Logging sono associate a costi. Per ulteriori informazioni, consulta Prezzi di Cloud Logging.

Visualizzare le metriche standard di Vertex AI Pipelines in Metrics Explorer

Anteprima

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Puoi visualizzare le seguenti metriche relative a Vertex AI Pipelines in Metrics Explorer:

• Metriche a livello di job della pipeline:

  • Utilizza la metrica Vertex Pipelines Job - PipelineJob duration per visualizzare la durata di esecuzione delle esecuzioni della pipeline.

  • Utilizza la metrica Location - Executing PipelineJobs per visualizzare il numero di esecuzioni della pipeline.

• Metriche a livello di attività della pipeline:

  • Utilizza Vertex Pipelines Job - Completed PipelineTasks per visualizzare il numero di attività della pipeline completate.

  • Utilizza Location - Executing PipelineTasks per visualizzare il numero di attività della pipeline eseguite nelle esecuzioni della pipeline.

Visualizzare la durata di runtime dei job della pipeline

Segui le istruzioni riportate di seguito per visualizzare la metrica Vertex Pipelines Job - PipelineJob duration nella console Google Cloud:

1. Vai a Metrics Explorer:

   Vai a Esplora metriche

2. Nell'elenco Metrica, seleziona Job Vertex Pipelines > Job pipeline > Durata job pipeline.

3. Fai clic su Applica.

4. (Facoltativo) Per filtrare la query, specifica uno o più criteri facendo clic su Filtra. Ad esempio:

   • Per visualizzare la durata di esecuzione di un job della pipeline specifico, utilizza il filtro pipeline_job_id.

   • Per visualizzare la durata di esecuzione dei job della pipeline per una località specifica, utilizza il filtro location.

   • Per visualizzare la durata del runtime dei job della pipeline nello stato PIPELINE_STATE_CANCELLED, PIPELINE_STATE_CANCELLING, PIPELINE_STATE_FAILED, PIPELINE_STATE_PENDING, PIPELINE_STATE_RUNNING o PIPELINE_STATE_SUCCEEDED, utilizza il filtro run_state.

Visualizzare il numero di esecuzioni della pipeline

Segui le istruzioni riportate di seguito per visualizzare la metrica Location - Executing PipelineJobs nella console Google Cloud:

1. Vai a Metrics Explorer:

   Vai a Esplora metriche

2. Nell'elenco Metrica, seleziona Località > Executing_vertexai_pipeline_jobs > Executing PipelineJobs.

3. Fai clic su Applica.

4. (Facoltativo) Per filtrare la query, specifica uno o più criteri facendo clic su Filtra. Ad esempio, per visualizzare il numero di job della pipeline per una località specifica, utilizza il filtro location.

Visualizzare il numero di attività della pipeline completate

Segui le istruzioni riportate di seguito per visualizzare la metrica Vertex Pipelines Job - Completed PipelineTasks nella console Google Cloud:

1. Vai a Metrics Explorer:

   Vai a Esplora metriche

2. Nell'elenco Metrica, seleziona Vertex Pipelines Job > Pipelinejob > PipelineTasks completate.

3. Fai clic su Applica.

4. (Facoltativo) Per filtrare la query, specifica uno o più criteri facendo clic su Filtra. Ad esempio:

   • Per visualizzare il numero di attività completate in un'esecuzione della pipeline specifica, utilizza il filtro pipeline_job_id.

   • Per visualizzare il numero di attività completate nelle esecuzioni della pipeline per una località specifica, utilizza il filtro location.

Visualizzare il numero di attività della pipeline eseguite

Segui le istruzioni riportate di seguito per visualizzare la metrica Location - Executing PipelineTasks nella console Google Cloud:

1. Vai a Metrics Explorer:

   Vai a Esplora metriche

2. Nell'elenco Metrica, seleziona Località > Executing_vertexai_pipeline_tasks > Executing PipelineTasks.

3. Fai clic su Applica.

4. (Facoltativo) Per filtrare la query, specifica uno o più criteri facendo clic su Filtra. Ad esempio, per visualizzare il numero di attività della pipeline eseguite per una località specifica, utilizza il filtro location.

Creare e visualizzare metriche personalizzate in Esplora log

Puoi utilizzare Esplora log nella console Google Cloud per creare metriche basate su log personalizzate che monitorano e analizzano i pattern all'interno dei log della pipeline.

Esempi di metriche personalizzate

Questa sezione illustra alcuni esempi di metriche personalizzate che puoi creare. Di seguito sono elencati alcuni esempi:

• Creare una metrica personalizzata per i job della pipeline non riusciti

• Creare una metrica personalizzata per lo stato finale della pipeline

• Visualizzare il tasso di errore dei job della pipeline

Creare una metrica personalizzata per i job di pipeline non riusciti

Per creare una metrica contatore basata su log personalizzata che monitora i job della pipeline non riusciti, segui questi passaggi:

1. Vai a Esplora log:

   Vai a Esplora log

2. Seleziona il progetto Google Cloud appropriato.

3. Nel menu a discesa Risorsa, seleziona Job Vertex Pipelines.

4. Nel menu a discesa Località, seleziona la località della pipeline.

5. Nel menu a discesa Tutti gli ID pipeline_job, seleziona l'ID del tuo job della pipeline.

6. Fai clic su Applica.

7. Fai clic su Crea metrica.

8. Nella schermata Crea metrica di log:

   1. Imposta il Tipo di metrica: seleziona Contatore.

   2. Imposta i seguenti campi nella sezione Dettagli:

      • Nome metrica di log: inserisci un nome per la metrica di log, ad esempio pipelinejob_failed. Scegli un nome univoco tra le metriche basate su log nel tuo progetto Google Cloud. Sono previste alcune limitazioni per i nomi. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi.
      • Descrizione: inserisci una descrizione per la metrica.
      • Unità: lascia vuoto questo campo o inserisci la cifra 1.

   3. Definisci il filtro delle metriche nella sezione Selezione filtro. Crea un filtro che raccolga solo le voci di log che vuoi conteggiare nella metrica utilizzando il linguaggio di query di logging, ad esempio:

      resource.type="aiplatform.googleapis.com/PipelineJob"
      jsonPayload.state="PIPELINE_STATE_FAILED"
      

      Puoi anche utilizzare le espressioni regolari per creare i filtri della metrica.

      Per aprire un riquadro che mostra le voci di log corrispondenti al filtro, fai clic su Anteprima log.

   4. (Facoltativo) Aggiungi un'etichetta nella sezione Etichette. Per istruzioni su come creare le etichette, consulta Creare un'etichetta.

   5. Per creare la metrica, fai clic su Crea metrica.

Creare una metrica personalizzata per lo stato finale della pipeline

Per creare una metrica contatore personalizzata basata su log che monitora lo stato finale dei job della pipeline:

1. Vai a Esplora log:

   Vai a Esplora log

2. Seleziona il progetto Google Cloud appropriato.

3. Nel menu a discesa Risorsa, seleziona Job Vertex Pipelines.

4. Nel menu a discesa Località, seleziona la località della pipeline.

5. Nel menu a discesa Tutti gli ID pipeline_job, seleziona l'ID del tuo job della pipeline.

6. Fai clic su Applica.

7. Fai clic su Crea metrica.

8. Nella schermata Crea metrica di log:

   1. Imposta il Tipo di metrica: seleziona Contatore.

   2. Imposta i seguenti campi nella sezione Dettagli:

      • Nome metrica di log: inserisci un nome per la metrica di log, ad esempio Pipeline_state_final. Scegli un nome univoco tra le metriche basate su log nel tuo progetto Google Cloud. Sono previste alcune limitazioni per i nomi. Per ulteriori informazioni, consulta la sezione Risoluzione dei problemi.
      • Descrizione: inserisci una descrizione per la metrica.
      • Unità: lascia vuoto questo campo o inserisci la cifra 1.

   3. Definisci il filtro delle metriche nella sezione Selezione filtro. Crea un filtro che raccolga solo le voci di log che vuoi conteggiare nella metrica utilizzando il linguaggio di query di logging, ad esempio:

      resource.type="aiplatform.googleapis.com/PipelineJob"
      jsonPayload.state="PIPELINE_STATE_SUCCEEDED" OR
      "PIPELINE_STATE_FAILED" OR "PIPELINE_STATE_CANCELLED"
      

      Puoi anche utilizzare le espressioni regolari per creare i filtri della metrica.

      Per aprire un riquadro che mostra le voci di log corrispondenti al filtro, fai clic su Anteprima log.

   4. (Facoltativo) Aggiungi un'etichetta nella sezione Etichette. Per istruzioni su come creare le etichette, consulta Creare un'etichetta.

   5. Per creare la metrica, fai clic su Crea metrica.

Visualizza la percentuale di errori dei job della pipeline

Il tasso di errori dei job della pipeline viene calcolato come il rapporto tra il numero di job della pipeline nello stato finale e il numero di job della pipeline non riusciti. Per creare una dashboard per monitorare il tasso di errore dei job della pipeline:

1. Crea una metrica per il monitoraggio dei job della pipeline nello stato finale. Per ulteriori informazioni, vedi Creare una metrica personalizzata per lo stato finale della pipeline.

2. Crea una metrica per monitorare i job della pipeline nello stato di errore. Per ulteriori informazioni, vedi Creare una metrica personalizzata per i job della pipeline non riusciti.

3. Nella sezione Monitoraggio della console Google Cloud, vai alla pagina Metrics Explorer.

   Vai alla Metrics Explorer metriche

4. Nella scheda Configurazione:

   1. Fai clic su Aggiungi un'altra metrica.

   2. Seleziona l'opzione Visualizza metriche come rapporto. Quando selezioni questa opzione:

      • Il riquadro Serie temporale A viene rinominato Numeratore.

      • Il riquadro Serie temporale B viene rinominato Denominatore.

   3. Nel riquadro Numeratore, fai clic su Seleziona una metrica per selezionare la metrica creata per i job della pipeline non riusciti.

   4. Nel riquadro Denominatore, fai clic su Seleziona una metrica per selezionare la metrica creata per i job della pipeline dello stato finale.

   5. (Facoltativo) Configura il numeratore e il denominatore aggiungendo filtri o aggiornando i campi di raggruppamento e i parametri di allineamento.

      Per saperne di più su come aggiungere filtri o aggiornare i campi di raggruppamento e i parametri di allineamento, consulta Graficare un rapporto tra metriche.

      Nota :le due metriche selezionate come numeratore e denominatore devono avere lo stesso tipo di risorsa. Se selezioni la stessa metrica per il numeratore e il denominatore, utilizza filtri o raggruppamenti diversi per distinguere il numeratore dal denominatore.

   Dopo aver selezionato il numeratore e il denominatore, il tasso di errore dei job della pipeline viene visualizzato nel grafico.

   • Dopo aver generato il grafico del tasso di errore dei job della pipeline, puoi aggiungerlo alla dashboard personalizzata. Per ulteriori informazioni, vedi Salvare un grafico per riferimento futuro.

   • Per copiare l'URL contenente la configurazione del grafico, fai clic sull'icona dei tre puntini nell'angolo in alto a destra del grafico e poi su Condividi tramite URL.