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

Neste documento, explicamos como acessar eventos de status do Batch trabalhos e tarefas. Os eventos de status fornecem um histórico que você pode usar para analisar jobs e geralmente contêm mensagens de erro úteis que podem ser usadas para e solução de problemas.

Cada job e cada tarefa tem eventos de status que são automaticamente criado pelo Batch durante a execução do job. Cada um desses eventos de status descreve um estado mudança 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. Também é possível configurar um job 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

• Se você nunca usou o Batch antes, revise Introdução ao Batch e ativar o Batch. Para isso, conclua pré-requisitos para projetos e usuários.

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

  Também é possível conseguir as permissões necessárias com papéis personalizados ou 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

Observação: o console do Google Cloud lista apenas eventos de status no nível do job.

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

• LOCATION: o local onde 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 do projeto atual.

• LOCATION: o local onde o job existe.

• JOB_NAME: o nome de um job atual.

Visualizar os eventos de status de uma tarefa

gcloud

Para visualizar os eventos de status de uma tarefa usando a CLI gcloud, use o comando gcloud batch tasks describe, e 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 que você quer visualizar. os detalhes. Em um grupo de tarefas, o índice da tarefa 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 deve ser Defina 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 do projeto atual.

• LOCATION: o local onde 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 com os detalhes que você quer conferir. O valor deve ser Defina como group0.

• TASK_INDEX: o índice da tarefa que você quer visualizar. os detalhes. Em um grupo de tarefas, o índice da tarefa 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.

A seguir

• Para entender os eventos de status do Batch que descrevem erros, consulte Solução de problemas.

• Se você quiser um histórico mais detalhado para sua tarefa, como eventos de status quando os executáveis começam e terminam, configurar eventos de status personalizados.

• Saiba como analisar um job usando registros.