Veja o histórico de uma tarefa através de eventos de estado

Este documento explica como ver eventos de estado para tarefas e trabalhos em lote. Os eventos de estado fornecem um histórico que pode usar para analisar tarefas e, muitas vezes, contêm mensagens de erro úteis que pode usar para resolver problemas.

Cada trabalho e cada uma das respetivas tarefas têm eventos de estado que são criados automaticamente pelo Batch enquanto o trabalho é executado. Cada um destes eventos de estado descreve uma alteração de estado e detalhes sobre o motivo pelo qual esse estado foi alcançado. Para saber mais sobre os estados de tarefas e trabalhos, consulte o artigo Ciclo de vida do trabalho. Opcionalmente, também pode configurar uma tarefa para ter eventos de estado personalizados, que descrevem o progresso dos executáveis. Para saber mais sobre eventos de estado personalizado, consulte o artigo Configure eventos de estado personalizado.

Antes de começar

  1. Se nunca usou o Batch, reveja o artigo Comece a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e utilizadores.

  2. Para receber as autorizações de que precisa para ver tarefas e trabalhos, peça ao seu administrador que lhe conceda a função do IAM Visualizador de trabalhos em lote (roles/batch.jobsViewer) ou Editor de trabalhos em lote (roles/batch.jobsEditor) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

    Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Veja eventos de estado

Podem aparecer diferentes eventos de estado ao nível da tarefa (campo statusEvents[] para a tarefa) e ao nível da tarefa (campo statusEvents[] para cada tarefa).

As instruções seguintes explicam como ver eventos de estado através da Google Cloud consola, da CLI gcloud e da API Batch. Para usar um idioma de biblioteca de cliente, siga os passos para ver os detalhes de um trabalho ou ver os detalhes de uma tarefa e, em seguida, consulte o campo statusEvents[] correspondente.

Veja os eventos de estado de um trabalho

Consola

Para ver os eventos de estado de uma tarefa no projeto atual através da Google Cloud consola, siga estes passos:

  1. Na Google Cloud consola, aceda à página Lista de tarefas.

    Aceda à lista de trabalhos

  2. Na coluna Nome da tarefa, clique no nome de uma tarefa.

    É apresentada a página Detalhes do trabalho.

    O separador Detalhes está aberto por predefinição.

  3. Clique no separador Eventos.

gcloud

Para ver os eventos de estado de uma tarefa através da CLI gcloud, use o comando gcloud batch jobs describe e, de seguida, consulte o campo statusEvents[].

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Substitua o seguinte:

  • JOB_NAME: o nome de uma tarefa existente.

  • LOCATION: a localização onde o trabalho existe.

API

Para ver os eventos de estado de uma tarefa através da API Batch, faça um pedido GET ao método jobs.get e, em seguida, consulte o campo statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto do projeto atual.

  • LOCATION: a localização onde o trabalho existe.

  • JOB_NAME: o nome de uma tarefa existente.

Veja os eventos de estado de uma tarefa

gcloud

Para ver os eventos de estado de uma tarefa através da CLI gcloud, use o comando gcloud batch tasks describe e, de seguida, consulte o campo statusEvents[].

gcloud batch tasks describe TASK_INDEX \
  --location=LOCATION \
  --job=JOB_NAME \
  --task_group=TASK_GROUP_NAME

Substitua o seguinte:

  • TASK_INDEX: o índice da tarefa cujos detalhes quer ver. Num grupo de tarefas, o índice da tarefa começa em 0 para a primeira tarefa e aumenta em 1 com cada tarefa adicional. Por exemplo, um grupo de tarefas que contém quatro tarefas tem os índices 0, 1, 2 e 3.

  • JOB_NAME: o nome de uma tarefa existente.

  • LOCATION: a localização onde o trabalho existe.

  • TASK_GROUP_NAME: o nome do grupo de tarefas que contém a tarefa cujos detalhes quer ver. O valor tem de ser definido como group0.

API

Para ver os eventos de estado de uma tarefa através da API Batch, faça um pedido GET ao método tasks.get e, em seguida, consulte o campo statusEvents[].

GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto do projeto atual.

  • LOCATION: a localização onde o trabalho existe.

  • JOB_NAME: o nome de uma tarefa existente.

  • TASK_GROUP_NAME: o nome do grupo de tarefas que contém a tarefa cujos detalhes quer ver. O valor tem de ser definido como group0.

  • TASK_INDEX: o índice da tarefa cujos detalhes quer ver. Num grupo de tarefas, o índice da tarefa começa em 0 para a primeira tarefa e aumenta em 1 com cada tarefa adicional. Por exemplo, um grupo de tarefas que contém quatro tarefas tem os índices 0, 1, 2 e 3.

O que se segue?