Ver o histórico de uma tarefa por meio de eventos de status

Este documento explica como visualizar eventos de status para trabalhos e tarefas em lote. Os eventos de status fornecem um histórico que pode ser usado para analisar jobs e, geralmente, contêm mensagens de erro úteis que podem ser usadas para resolver problemas.

Cada job e cada uma das tarefas têm eventos de status que são criados automaticamente pelo lote enquanto o job é executado. Cada um desses eventos descreve uma mudança de status e detalhes sobre por que esse estado foi alcançado. Para saber mais sobre estados de jobs e tarefas, consulte Ciclo de vida do job. Opcionalmente, você também pode configurar um trabalho para ter eventos de status personalizados, o que descrevem o progresso dos executáveis. Para saber mais sobre os eventos de status personalizados, consulte Configure eventos de status personalizados.

Antes de começar

  1. Se você nunca usou o Batch, consulte Começar a usar o Batch e ative o Batch concluindo os pré-requisitos para projetos e usuários.

  2. Para receber as permissões necessárias para visualizar jobs e tarefas, peça ao administrador para conceder a você o papel do IAM de Leitor de jobs em lote (roles/batch.jobsViewer) ou Editor de jobs em lote (roles/batch.jobsEditor) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

    Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.

Ver eventos de status

Eventos de status diferentes podem aparecer no nível da tarefa (campo statusEvents[] para a vaga) e no nível da tarefa (campo statusEvents[] para cada tarefa).

As instruções a seguir explicam como exibir eventos de status usando o console do Google Cloud, CLI gcloud e API Batch. Para usar uma linguagem de biblioteca de cliente, siga as etapas para ver os detalhes de uma tarefa ou ver os detalhes de uma tarefa em seguida, confira o campo statusEvents[] correspondente.

Visualizar os eventos de status de um job

Console

Para visualizar os eventos de status de um trabalho no projeto atual usando o Console do Google Cloud, siga estas etapas:

  1. No console do Google Cloud, acesse a página Lista de jobs.

    Acessar a lista de jobs

  2. Na coluna Nome do job, clique no nome de um job.

    A página Detalhes do job será aberta.

    A guia Detalhes fica aberta por padrão.

  3. Clique na guia Eventos.

gcloud

Para visualizar os eventos de status de uma tarefa usando o CLI gcloud, use o comando gcloud batch jobs describe, e o campo statusEvents[].

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Substitua:

  • JOB_NAME: o nome de um job existente.

  • LOCATION: o local em que o job existe.

API

Para visualizar os eventos de status de uma tarefa usando o Batch API, faça uma solicitação GET ao método jobs.get, em seguida, confira o campo statusEvents[].

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

Substitua:

  • PROJECT_ID: o ID do projeto atual.

  • LOCATION: o local onde o job existe.

  • JOB_NAME: o nome de um job existente.

Conferir os eventos de status de uma tarefa

gcloud

Para conferir os eventos de status de uma tarefa usando a CLI gcloud, use o comando gcloud batch tasks describe e confira o campo statusEvents[].

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

Substitua:

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

  • JOB_NAME: o nome de um job atual.

  • LOCATION: o local em que o job existe.

  • TASK_GROUP_NAME: o nome do grupo de tarefas que contém a tarefa com os detalhes que você quer conferir. O valor precisa ser definido como group0.

API

Para visualizar os eventos de status de uma tarefa usando a API Batch, faça uma solicitação GET ao método tasks.get, em seguida, confira 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:

  • PROJECT_ID: o ID do projeto atual.

  • LOCATION: o local em que o job existe.

  • JOB_NAME: o nome de um job atual.

  • TASK_GROUP_NAME: o nome do grupo de tarefas que contém a tarefa que você quer consultar os detalhes. O valor precisa ser definido como group0.

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

A seguir