Partilhar via


Evento de conclusão de tarefa

Este evento é emitido assim que uma tarefa é concluída, independentemente do código de saída. Este evento pode ser utilizado para determinar a duração de uma tarefa, onde a tarefa foi executada e se foi repetida novamente.

O exemplo seguinte mostra o corpo de um evento de conclusão da tarefa.

{
    "jobId": "myJob",
    "id": "myTask",
    "taskType": "User",
    "systemTaskVersion": 0,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "startTime": "2016-09-08T16:32:23.799Z",
        "endTime": "2016-09-08T16:34:00.666Z",
        "exitCode": 0,
        "retryCount": 0,
        "requeueCount": 0
    }
}
Nome do elemento Tipo Notas
jobId String O ID da tarefa que contém a tarefa.
id String O ID da tarefa.
taskType String O tipo da tarefa. Pode ser "JobManager" a indicar que é uma tarefa do gestor de tarefas ou "Utilizador" que indica que não é uma tarefa do gestor de tarefas. Este evento não é emitido para tarefas de preparação de tarefas, tarefas de lançamento de tarefas ou tarefas de início.
systemTaskVersion Int32 Este é o contador de repetição interno de uma tarefa. Internamente, o serviço Batch pode repetir uma tarefa para ter em conta os problemas transitórios. Estes problemas podem incluir erros de agendamento internos ou tentativas de recuperação de nós de computação num estado incorreto.
requiredSlots Int32 Os blocos necessários para executar a tarefa.
nodeInfo Tipo Complexo Contém informações sobre o nó de computação no qual a tarefa foi executada.
multiInstanceSettings Tipo Complexo Especifica que a tarefa é uma Tarefa de Várias Instâncias que requer vários nós de computação. Veja multiInstanceSettings para obter detalhes.
constraints Tipo Complexo As restrições de execução que se aplicam a esta tarefa.
executionInfo Tipo Complexo Contém informações sobre a execução da tarefa.

nodeInfo

Nome do elemento Tipo Notas
poolId String O ID do conjunto no qual a tarefa foi executada.
nodeId String O ID do nó no qual a tarefa foi executada.

multiInstanceSettings

Nome do elemento Tipo Notas
numberOfInstances Int32 O número de nós de computação necessários para a tarefa.

restrições

Nome do elemento Tipo Notas
maxTaskRetryCount Int32 O número máximo de vezes que a tarefa pode ser repetida. O serviço Batch repetirá uma tarefa se o código de saída não forzero.

Tenha em atenção que este valor controla especificamente o número de tentativas. O serviço Batch tentará a tarefa uma vez e, em seguida, poderá repetir até este limite. Por exemplo, se a contagem máxima de repetições for 3, o Batch tentará uma tarefa até 4 vezes (uma tentativa inicial e três repetições).

Se a contagem máxima de repetições for 0, o serviço Batch não repetirá tarefas.

Se a contagem máxima de repetições for -1, o serviço Batch repetirá tarefas sem limite.

O valor predefinido é 0 (sem repetições).

executionInfo

Nome do elemento Tipo Notas
startTime DateTime O momento em que a tarefa começou a ser executada. "Em execução" corresponde ao estado de execução , por isso, se a tarefa especificar ficheiros de recursos ou pacotes de aplicações, a hora de início reflete o momento em que a tarefa começou a transferi-los ou a implementá-los. Se a tarefa tiver sido reiniciada ou repetida, esta é a hora mais recente em que a tarefa começou a ser executada.
endTime DateTime O momento em que a tarefa foi concluída.
exitCode Int32 O código de saída da tarefa.
retryCount Int32 O número de vezes que a tarefa foi repetida pelo serviço Batch. A tarefa é repetida se sair com um código de saída nãozero, até ao MaxTaskRetryCount especificado.
requeueCount Int32 O número de vezes que a tarefa foi recoduída pelo serviço Batch como resultado de um pedido de utilizador.

Quando o utilizador remove os nós de um conjunto (redimensionando ou reduzindo o conjunto) ou quando a tarefa está a ser desativada, o utilizador pode especificar que as tarefas em execução nos nós são recoduídas para execução. Esta contagem regista o número de vezes que a tarefa foi recoduída por estes motivos.