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. 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
Para visualizar os eventos de status de um trabalho no projeto atual usando o Console do Google Cloud, siga estas etapas:
No console do Google Cloud, acesse a página Lista de jobs.
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.
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 índices0
,1
,2
e3
.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 comogroup0
.
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 comogroup0
.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 índices0
,1
,2
e3
.
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.