Visualizza metriche pipeline

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

In questa pagina viene spiegato come svolgere le seguenti operazioni:

La creazione e la visualizzazione di metriche personalizzate in Cloud Logging hanno costi associati. Per ulteriori informazioni, consulta i prezzi di Cloud Logging.

Visualizza le metriche standard di Vertex AI Pipelines in Metrics Explorer

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

Visualizza la durata del runtime dei job della pipeline

Segui queste istruzioni per visualizzare la metrica Vertex Pipelines Job - PipelineJob duration nella console Google Cloud:

  1. Vai a Metrics Explorer:

    Vai a Metrics Explorer

  2. Nell'elenco Metrica, seleziona Job Vertex Pipelines > Pipelinejob > Durata PipelineJob.

  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 del runtime di uno specifico job della pipeline, utilizza il filtro pipeline_job_id.

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

    • Per visualizzare la durata del runtime dei job di pipeline nello stato PIPELINE_JOB_RUNNING, PIPELINE_JOB_CANCELLED o PIPELINE_JOB_PENDING, utilizza il filtro run_state.

Visualizza il numero di esecuzioni pipeline

Segui queste istruzioni per visualizzare la metrica Location - Executing PipelineJobs nella console Google Cloud:

  1. Vai a Metrics Explorer:

    Vai a Metrics Explorer

  2. Nell'elenco Metrica, seleziona Posizione > Executing_vertexai_pipeline_jobs > Esecuzione di PipelineJob.

  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 di pipeline per una località specifica, utilizza il filtro location.

Visualizza il numero di attività della pipeline completate

Segui queste istruzioni per visualizzare la metrica Vertex Pipelines Job - Completed PipelineTasks nella console Google Cloud:

  1. Vai a Metrics Explorer:

    Vai a Metrics Explorer

  2. Nell'elenco Metrica, seleziona Job Vertex Pipelines > Pipelinejob > Completato 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à completate in una specifica esecuzione della pipeline, 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.

Visualizza il numero di attività della pipeline eseguite

Segui queste istruzioni per visualizzare la metrica Location - Executing PipelineTasks nella console Google Cloud:

  1. Vai a Metrics Explorer:

    Vai a Metrics Explorer

  2. Nell'elenco Metrica, seleziona Posizione > 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 pattern all'interno dei tuoi log della pipeline.

Esempi di metriche personalizzate

Questa sezione illustra alcuni esempi di metriche personalizzate che puoi creare. Sono incluse le seguenti app:

Crea una metrica personalizzata per i job di pipeline non riusciti

Per creare una metrica del contatore basata su log personalizzata che monitori i job della pipeline non riusciti:

  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 All pipeline_job_id, seleziona l'ID del 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. Si applicano alcune restrizioni di denominazione. 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 espressioni regolari per creare 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 sulla creazione delle etichette, vedi Creare un'etichetta.

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

Crea una metrica personalizzata per lo stato finale della pipeline

Per creare una metrica del contatore basata su log personalizzata che monitori 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 All pipeline_job_id, seleziona l'ID del 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. Si applicano alcune restrizioni di denominazione. 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 espressioni regolari per creare 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 sulla creazione delle etichette, vedi Creare un'etichetta.

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

Visualizza la percentuale di errori dei job della pipeline

La percentuale di errori dei job di pipeline viene calcolata come rapporto tra il numero di job di pipeline nello stato finale e il numero di job di pipeline non riusciti. Per creare una dashboard per monitorare la percentuale di errori del job della pipeline:

  1. Crea una metrica per monitorare i job della pipeline nello stato finale. Per saperne di più, consulta Creare una metrica personalizzata per lo stato finale della pipeline.

  2. Crea una metrica per il monitoraggio dei job di pipeline in stato non riuscito. Per maggiori informazioni, consulta Creare una metrica personalizzata per i job di pipeline non riusciti.

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

    Vai alla pagina Metrics Explorer

  4. Nella scheda Configurazione, procedi nel seguente modo:

    1. Fai clic su Aggiungi un'altra metrica.

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

      • Il riquadro Serie temporali A è rinominato Numeratore.

      • Il riquadro Serie temporali B è rinominato Denominatore.

    3. Nel riquadro Numeratore, fai clic su Seleziona una metrica per selezionare la metrica creata per i job di 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 Tracciare un grafico del rapporto tra le metriche.

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

    • Dopo aver generato il grafico della percentuale di errori 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 con i puntini di sospensione nell'angolo in alto a destra del grafico, quindi fai clic su Condividi tramite URL.