Veja as métricas do pipeline

Depois de definir, criar e executar um pipeline, pode ver métricas relacionadas com a tarefa do pipeline ou as tarefas do pipeline no explorador de métricas. Além disso, pode criar métricas e alertas personalizados baseados em registos através do Cloud Logging para monitorizar eventos, como falhas de pipelines.

Esta página descreve como pode fazer o seguinte:

• Veja métricas padrão do Vertex AI Pipelines no explorador de métricas

• Crie e veja métricas personalizadas no Explorador de registos (pré-visualização)

A criação e a visualização de métricas personalizadas no Cloud Logging têm custos associados. Para mais informações, consulte os preços do Cloud Logging.

Veja as métricas padrão do Vertex AI Pipelines no explorador de métricas

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Pode ver as seguintes métricas relacionadas com os Vertex AI Pipelines no Explorador de métricas:

• Métricas ao nível da tarefa do pipeline:

  • Use a métrica Vertex Pipelines Job - PipelineJob duration para ver a duração do tempo de execução das execuções de pipelines.

  • Use a métrica Location - Executing PipelineJobs para ver o número de execuções de pipelines.

• Métricas ao nível da tarefa do pipeline:

  • Use o ícone Vertex Pipelines Job - Completed PipelineTasks para ver o número de tarefas do pipeline concluídas.

  • Use o ícone Location - Executing PipelineTasks para ver o número de tarefas do pipeline executadas em execuções do pipeline.

Veja a duração do tempo de execução das tarefas de pipeline

Siga as instruções abaixo para ver a métrica Vertex Pipelines Job - PipelineJob duration na consola Google Cloud :

1. Navegue para o Explorador de métricas:

   Aceda ao Explorador de métricas

2. Na lista Métrica, selecione Tarefa de pipelines do Vertex > Pipelinejob > Duração do PipelineJob.

3. Clique em Aplicar.

4. Opcional: para filtrar a consulta, especifique um ou mais critérios clicando em Filtrar. Por exemplo:

   • Para ver a duração de execução de uma tarefa de pipeline específica, use o filtro pipeline_job_id.

   • Para ver a duração da execução de tarefas de pipeline para uma localização específica, use o filtro location.

   • Para ver a duração da execução de tarefas de pipeline no estado PIPELINE_STATE_CANCELLED,PIPELINE_STATE_CANCELLING, PIPELINE_STATE_FAILED, PIPELINE_STATE_PENDING, PIPELINE_STATE_RUNNING ou PIPELINE_STATE_SUCCEEDED, use o filtro run_state.

Veja o número de execuções de pipelines

Siga as instruções abaixo para ver a métrica Location - Executing PipelineJobs na consola Google Cloud :

1. Navegue para o Explorador de métricas:

   Aceda ao Explorador de métricas

2. Na lista Métrica, selecione Localização > Executing_vertexai_pipeline_jobs > Executing PipelineJobs.

3. Clique em Aplicar.

4. Opcional: para filtrar a consulta, especifique um ou mais critérios clicando em Filtrar. Por exemplo, para ver o número de empregos em pipeline para uma localização específica, use o filtro location.

Veja o número de tarefas de pipeline concluídas

Siga as instruções abaixo para ver a métrica Vertex Pipelines Job - Completed PipelineTasks na consola Google Cloud :

1. Navegue para o Explorador de métricas:

   Aceda ao Explorador de métricas

2. Na lista Métrica, selecione Tarefa de pipelines do Vertex > Pipelinejob > Completed PipelineTasks.

3. Clique em Aplicar.

4. Opcional: para filtrar a consulta, especifique um ou mais critérios clicando em Filtrar. Por exemplo:

   • Para ver o número de tarefas concluídas numa execução de pipeline específica, use o filtro pipeline_job_id.

   • Para ver o número de tarefas concluídas em execuções de pipelines para uma localização específica, use o filtro location.

Veja o número de tarefas de pipeline executadas

Siga as instruções abaixo para ver a métrica Location - Executing PipelineTasks na consola Google Cloud :

1. Navegue para o Explorador de métricas:

   Aceda ao Explorador de métricas

2. Na lista Métrica, selecione Localização > Executing_vertexai_pipeline_tasks > Executing PipelineTasks.

3. Clique em Aplicar.

4. Opcional: para filtrar a consulta, especifique um ou mais critérios clicando em Filtrar. Por exemplo, para ver o número de tarefas de pipeline executadas para uma localização específica, use o filtro location.

Crie e veja métricas personalizadas no Explorador de registos

Pode usar o Explorador de registos na Google Cloud consola para criar métricas baseadas em registos que monitorizam e analisam padrões nos registos do pipeline.

Exemplos de métricas personalizadas

Esta secção ilustra exemplos de métricas personalizadas que pode criar. Estas incluem o seguinte:

• Crie uma métrica personalizada para tarefas de pipeline com falhas

• Crie uma métrica personalizada para o estado final do pipeline

• Veja a taxa de falhas de tarefas de pipeline

Crie uma métrica personalizada para tarefas de pipeline com falhas

Para criar uma métrica de contador baseada em registos personalizada que monitorize trabalhos de pipeline com falhas, faça o seguinte:

1. Navegue para o Explorador de registos:

   Aceda ao Explorador de registos

2. Selecione o Google Cloud projeto adequado.

3. No menu pendente Recurso, selecione Tarefa de pipelines do Vertex AI.

4. No menu pendente Localização, selecione a localização do seu pipeline.

5. No menu pendente Todos os pipeline_job_id, selecione o ID da sua tarefa de pipeline.

6. Clique em Aplicar.

7. Clique em Criar métrica.

8. No ecrã Criar métrica de registos:

   1. Defina o Tipo de métrica: selecione Contador.

   2. Defina os seguintes campos na secção Detalhes:

      • Nome da métrica de registo: introduza um nome para a métrica de registo, por exemplo, pipelinejob_failed. Escolha um nome exclusivo entre as métricas baseadas em registos no seu Google Cloud projeto. Aplicam-se algumas restrições de nomenclatura. Para mais informações, consulte a secção Resolução de problemas.
      • Descrição: introduza uma descrição para a métrica.
      • Unidades: deixe este campo em branco ou introduza o dígito 1.

   3. Defina o filtro de métricas na secção Seleção de filtros. Crie um filtro que recolha apenas as entradas do registo que quer contabilizar na sua métrica através da linguagem de consulta de registo, por exemplo:

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

      Também pode usar expressões regulares para criar os filtros da sua métrica.

      Para abrir um painel que lhe mostra as entradas do registo que correspondem ao seu filtro, clique em Pré-visualizar registos.

   4. Opcional: adicione uma etiqueta na secção Etiquetas. Para ver instruções sobre como criar etiquetas, consulte o artigo Crie uma etiqueta.

   5. Para criar a métrica, clique em Criar métrica.

Crie uma métrica personalizada para o estado final do pipeline

Para criar uma métrica de contador baseada em registos personalizada que monitorize o estado final das tarefas da sua pipeline, faça o seguinte:

1. Navegue para o Explorador de registos:

   Aceda ao Explorador de registos

2. Selecione o Google Cloud projeto adequado.

3. No menu pendente Recurso, selecione Tarefa de pipelines do Vertex AI.

4. No menu pendente Localização, selecione a localização do seu pipeline.

5. No menu pendente Todos os pipeline_job_id, selecione o ID da sua tarefa de pipeline.

6. Clique em Aplicar.

7. Clique em Criar métrica.

8. No ecrã Criar métrica de registos:

   1. Defina o Tipo de métrica: selecione Contador.

   2. Defina os seguintes campos na secção Detalhes:

      • Nome da métrica de registo: introduza um nome para a métrica de registo, por exemplo, Pipeline_state_final. Escolha um nome exclusivo entre as métricas baseadas em registos no seu Google Cloud projeto. Aplicam-se algumas restrições de nomenclatura. Para mais informações, consulte a secção Resolução de problemas.
      • Descrição: introduza uma descrição para a métrica.
      • Unidades: deixe este campo em branco ou introduza o dígito 1.

   3. Defina o filtro de métricas na secção Seleção de filtros. Crie um filtro que recolha apenas as entradas do registo que quer contabilizar na sua métrica através da linguagem de consulta de registo, por exemplo:

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

      Também pode usar expressões regulares para criar os filtros da sua métrica.

      Para abrir um painel que lhe mostra as entradas do registo que correspondem ao seu filtro, clique em Pré-visualizar registos.

   4. Opcional: adicione uma etiqueta na secção Etiquetas. Para ver instruções sobre como criar etiquetas, consulte o artigo Crie uma etiqueta.

   5. Para criar a métrica, clique em Criar métrica.

Veja a taxa de falhas de tarefas de pipeline

A taxa de falhas de tarefas da pipeline é calculada como a proporção do número de tarefas da pipeline no estado final para o número de tarefas da pipeline com falhas. Para criar um painel de controlo para monitorizar a taxa de falhas de tarefas de pipeline, faça o seguinte:

1. Crie uma métrica para monitorizar as tarefas do pipeline no estado final. Para mais informações, consulte o artigo Crie uma métrica personalizada para o estado final do pipeline.

2. Crie uma métrica para monitorizar as tarefas do pipeline no estado de falha. Para mais informações, consulte o artigo Crie uma métrica personalizada para tarefas de pipeline com falhas.

3. Na secção Monitorização da Google Cloud consola, aceda à página Explorador de métricas.

   Aceda à página Explorador de métricas

4. No separador Configuração, faça o seguinte:

   1. Clique em Adicionar outra métrica.

   2. Selecione a opção Apresentar métricas como rácio. Quando seleciona esta opção:

      • O painel Intervalo temporal A é mudado para Numerador.

      • O painel Intervalos temporais B passa a chamar-se Denominador.

   3. No painel Numerador, clique em Selecionar uma métrica para selecionar a métrica criada para tarefas de pipeline com falhas.

   4. No painel Denominador, clique em Selecionar uma métrica para selecionar a métrica criada para tarefas de pipeline de estado final.

   5. (Opcional) Configure o numerador e o denominador adicionando filtros ou atualizando os campos de agrupamento e os parâmetros de alinhamento.

      Para mais informações sobre como adicionar filtros ou atualizar os campos de agrupamento e os parâmetros de alinhamento, consulte o artigo Represente graficamente uma proporção de métricas.

      Nota: as duas métricas selecionadas como numerador e denominador têm de ter o mesmo tipo de recurso. Se selecionar a mesma métrica como numerador e denominador, use filtros ou agrupamentos diferentes para distinguir o numerador do denominador.

   Depois de selecionar o numerador e o denominador, a taxa de falhas da tarefa da pipeline é apresentada no gráfico.

   • Depois de gerar o gráfico da taxa de falhas de tarefas de pipeline, pode adicioná-lo ao seu painel de controlo personalizado. Para mais informações, consulte o artigo Guarde um gráfico para referência futura.

   • Para copiar o URL que contém a configuração do gráfico, clique no ícone de reticências no canto superior direito do gráfico e, de seguida, clique em Partilhar por URL.