Visualizzare 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 personalizzati basati su log utilizzando Cloud Logging per monitorare eventi come gli errori della pipeline.

Questa pagina descrive come puoi:

La creazione e la visualizzazione di metriche personalizzate in Cloud Logging comportano dei costi. Per ulteriori informazioni, consulta Prezzi di Cloud Logging.

Visualizzare le metriche standard di Vertex AI Pipelines in Metrics Explorer

In Metrics Explorer puoi visualizzare le seguenti metriche relative a Vertex AI Pipelines:

Visualizzare la durata di runtime dei job della pipeline

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

  1. Vai a Esplora metriche:

    Vai a Esplora metriche

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

  3. Fai clic su Applica.

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

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

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

    • Per visualizzare la durata di 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 queste istruzioni per visualizzare la metrica Location - Executing PipelineJobs nella Google Cloud console:

  1. Vai a Esplora metriche:

    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 Filtro. 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 queste istruzioni per visualizzare la metrica Vertex Pipelines Job - Completed PipelineTasks nella Google Cloud console:

  1. Vai a Esplora metriche:

    Vai a Esplora metriche

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

  3. Fai clic su Applica.

  4. (Facoltativo) Per filtrare la query, specifica uno o più criteri facendo clic su Filtro. 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 queste istruzioni per visualizzare la metrica Location - Executing PipelineTasks nella Google Cloud console:

  1. Vai a Esplora metriche:

    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 Filtro. 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 Google Cloud console per creare metriche personalizzate basate su log che monitorano e analizzano i pattern all'interno dei log della pipeline.

Esempi di metriche personalizzate

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

Creare una metrica personalizzata per i job della pipeline non riusciti

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

  1. Vai a Esplora log:

    Vai a Esplora log

  2. Seleziona il progettoappropriato Google Cloud .

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

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

  5. Nel menu a discesa Tutti i 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 Google Cloud progetto. Si applicano alcune limitazioni di denominazione. Per ulteriori informazioni, vedi Risoluzione dei problemi.
      • Descrizione: inserisci una descrizione per la metrica.
      • Unità: lascia vuoto questo campo o inserisci la cifra 1.

    3. Definisci il filtro della metrica nella sezione Selezione filtro. Crea un filtro che raccolga solo le voci di log che vuoi conteggiare nella tua 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 che corrispondono al filtro, fai clic su Visualizza log.

    4. (Facoltativo) Aggiungi un'etichetta nella sezione Etichette. Per istruzioni sulla creazione di etichette, vedi 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 progettoappropriato Google Cloud .

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

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

  5. Nel menu a discesa Tutti i 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 Google Cloud progetto. Si applicano alcune limitazioni di denominazione. Per ulteriori informazioni, vedi Risoluzione dei problemi.
      • Descrizione: inserisci una descrizione per la metrica.
      • Unità: lascia vuoto questo campo o inserisci la cifra 1.

    3. Definisci il filtro della metrica nella sezione Selezione filtro. Crea un filtro che raccolga solo le voci di log che vuoi conteggiare nella tua 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 che corrispondono al filtro, fai clic su Visualizza log.

    4. (Facoltativo) Aggiungi un'etichetta nella sezione Etichette. Per istruzioni sulla creazione di etichette, vedi Creare un'etichetta.

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

Visualizzare la percentuale di errori dei job della pipeline

La percentuale di errori dei job della pipeline viene calcolata 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 la percentuale di errori dei job della pipeline:

  1. Crea una metrica per monitorare i 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 non riuscito. Per ulteriori informazioni, vedi Creare una metrica personalizzata per i job della pipeline non riusciti.

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

    Vai alla Metrics Explorer metriche

  4. Nella scheda Configurazione, procedi nel seguente modo:

    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 nello stato finale.

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

      Per ulteriori informazioni su come aggiungere filtri o aggiornare i campi di raggruppamento e i parametri di allineamento, vedi Creare un grafico del rapporto tra le metriche.

    Dopo aver selezionato il numeratore e il denominatore, la percentuale di errori dei job della pipeline viene visualizzata nel grafico.

    • 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.