Evento di avvio attivitàTask start event

Questo evento viene generato una volta che un'attività è stata pianificata per l'avvio su un nodo di calcolo dall'utilità di pianificazione.This event is emitted once a task has been scheduled to start on a compute node by the scheduler. Se l'attività viene ritentata o reinserita nella coda, questo evento verrà generato nuovamente per la stessa attività, ma il numero di tentativi e la versione dell'attività di sistema verranno aggiornati di conseguenza.Note that if the task is retried or requeued this event will be emitted again for the same task, but the retry count and system task version will be updated accordingly.

L'esempio seguente illustra il corpo di un evento di avvio attività.The following example shows the body of a task start event.

{
    "jobId": "job-0000000001",
    "id": "task-5",
    "taskType": "User",
    "systemTaskVersion": 0,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "retryCount": 0
    }
}
Nome dell'elementoElement name typeType NoteNotes
jobIdjobId stringString ID del processo contenente l'attività.The id of the job containing the task.
idid stringString ID dell'attività.The id of the task.
taskTypetaskType stringString Tipo dell'attività.The type of the task. Il valore può essere "JobManager" per indicare che si tratta di un'attività del gestore di processi oppure 'User' per indicare che non si tratta di un'attività del gestore di processi.This can either be 'JobManager' indicating it is a job manager task or 'User' indicating it is not a job manager task.
systemTaskVersionsystemTaskVersion Int32Int32 Contatore dei tentativi interni di esecuzione di un'attività.This is the internal retry counter on a task. Il servizio Batch può ritentare internamente l'esecuzione di un'attività in funzione di problemi transitori.Internally the Batch service can retry a task to account for transient issues. Questi problemi possono includere errori interni di pianificazione o tentativi di ripristino a seguito di nodi di calcolo in uno stato non valido.These issues can include internal scheduling errors or attempts to recover from compute nodes in a bad state.
nodeInfonodeInfo Tipo complessoComplex Type Contiene informazioni sul nodo di calcolo in cui è stata eseguita l'attività.Contains information about the compute node on which the task ran.
multiInstanceSettingsmultiInstanceSettings Tipo complessoComplex Type Specifica che l'attività è un'attività con istanze multiple che richiede più nodi di calcolo.Specifies that the task is Multi-Instance Task requiring multiple compute nodes. Per informazioni dettagliate, vedere multiInstanceSettings.See multiInstanceSettings for details.
constraintsconstraints Tipo complessoComplex Type Vincoli di esecuzione che si applicano a questa attività.The execution constraints that apply to this task.
executionInfoexecutionInfo Tipo complessoComplex Type Contiene informazioni sull'esecuzione dell'attività.Contains information about the execution of the task.

nodeInfonodeInfo

Nome dell'elementoElement name typeType NoteNotes
poolIdpoolId stringString ID del pool in cui viene eseguita l'attività.The id of the pool on which the task ran.
nodeIdnodeId stringString ID del nodo in cui viene eseguita l'attività.The id of the node on which the task ran.

multiInstanceSettingsmultiInstanceSettings

Nome dell'elementoElement name typeType NoteNotes
numberOfInstancesnumberOfInstances intInt Numero di nodi di calcolo richiesti dall'attività.The number of compute nodes required by the task.

constraintsconstraints

Nome dell'elementoElement name typeType NoteNotes
maxTaskRetryCountmaxTaskRetryCount Int32Int32 Numero massimo di tentativi consentiti per l'attività.The maximum number of times the task may be retried. Il servizio Batch ripete un'attività se il relativo codice di uscita è diverso da zero.The Batch service retries a task if its exit code is nonzero.

Si noti che questo valore controlla specificamente il numero di tentativi.Note that this value specifically controls the number of retries. Il servizio Batch eseguirà l'attività una volta e quindi ripeterà l'esecuzione fino al limite di tentativi specificato.The Batch service will try the task once, and may then retry up to this limit. Ad esempio, se il numero massimo di tentativi è 3, il servizio Batch eseguirà l'attività 4 volte, ovvero una iniziale e 3 ulteriori tentativi.For example, if the maximum retry count is 3, Batch tries a task up to 4 times (one initial try and 3 retries).

Se il numero massimo di tentativi è 0, il servizio Batch non eseguirà ulteriori tentativi.If the maximum retry count is 0, the Batch service does not retry tasks.

Se il numero massimo di tentativi è -1, il servizio Batch continuerà a eseguire tentativi senza limiti.If the maximum retry count is -1, the Batch service retries tasks without limit.

Il valore predefinito è 0, ovvero nessun tentativo.The default value is 0 (no retries).

executionInfoexecutionInfo

Nome dell'elementoElement name typeType NoteNotes
retryCountretryCount Int32Int32 Numero di tentativi di esecuzione dell'attività da parte del servizio Batch.The number of times the task has been retried by the Batch service. L'attività viene ritentata se si conclude con un codice di uscita diverso da zero, fino al limite specificato in MaxTaskRetryCount.The task is retried if it exits with a nonzero exit code, up to the specified MaxTaskRetryCount