Conferir o histórico de um job por eventos de status

Este documento explica como visualizar eventos de status para jobs e tarefas do Batch. 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 a solução de problemas.

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

Antes de começar

  1. Se você nunca usou o Batch, consulte Introdução ao 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 usando personalizados papéis ou outros predefinidos papéis.

Visualizar eventos de status

Diferentes eventos de status podem aparecer no nível do job (statusEvents[] campo do job) e no nível da tarefa (statusEvents[] campo de cada tarefa).

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

Visualizar os eventos de status de um job

Console

Para visualizar os eventos de status de um job no projeto atual usando o Google Cloud console, siga estas etapas:

  1. No Google Cloud console, 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 é aberta por padrão.

  3. Clique na guia Eventos.

gcloud

Para visualizar os eventos de status de um job usando a CLI gcloud, use o gcloud batch jobs describe comando, e consulte o statusEvents[] campo.

gcloud batch jobs describe JOB_NAME \
    --location=LOCATION

Substitua:

  • JOB_NAME: o nome de um job atual.

  • LOCATION: o local em que o job existe.

API

Para visualizar os eventos de status de um job usando a API Batch, faça uma solicitação GET para o jobs.get método, e consulte 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 em que 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 gcloud batch tasks describe comando, e consulte 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, um grupo de tarefas que contém quatro tarefas tem os índices 0, 1, 2 e 3.

  • JOB_NAME: o nome de um job atual.

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

  • TASK_GROUP_NAME: o nome do grupo de tarefas que contém a tarefa que você quer visualizar os detalhes. 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 para o tasks.get método, e 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:

  • 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 visualizar os detalhes. O valor precisa ser definido 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, um grupo de tarefas que contém quatro tarefas tem os índices 0, 1, 2 e 3.

A seguir