Événement d’échec de tâche

Cet événement est émis quand une tâche se termine avec une erreur. Actuellement, tous les codes de sortie autres que zéro sont considérés comme des échecs. Cet événement est émis n plus d’un événement de fin de tâche et peut être utilisé pour détecter si une tâche a échoué.

L’exemple suivant montre le corps d’un événement d’échec de tâche.

{
    "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": 1,
        "retryCount": 2,
        "requeueCount": 0
    }
}

Nom de l'élément	Type	Notes
jobId	String	ID du travail contenant la tâche.
id	String	ID de la tâche.
taskType	String	Type de la tâche. Ce peut être « JobManager », indiquant qu’il s’agit une tâche du gestionnaire, ou « User », indiquant qu’il ne s’agit pas d’une tâche du gestionnaire. Cet événement n’est pas émis pour des tâches de préparation du travail, des tâches de fin de travail ou des tâches de démarrage.
systemTaskVersion	Int32	Compteur de tentatives internes d’exécution d’une tâche. En interne, le service Batch peut recommencer une tâche pour prendre en compte des problèmes temporaires. Ces problèmes peuvent être des erreurs de planification internes ou des tentatives de récupération à partir de nœuds de calcul en mauvais état.
requiredSlots	Int32	Emplacements requis pour exécuter la tâche.
nodeInfo	Type complexe	Contient des informations sur le nœud de calcul sur lequel la tâche a été exécutée.
multiInstanceSettings	Type complexe	Spécifie que la tâche est une tâche multi-instance nécessitant plusieurs nœuds de calcul. Pour plus d'informations, consultez multiInstanceSettings.
constraints	Type complexe	Contraintes d’exécution qui s’appliquent à cette tâche.
executionInfo	Type complexe	Contient des informations sur l’exécution de la tâche.

nodeInfo

Nom de l'élément	Type	Notes
poolId	String	ID du pool sur lequel la tâche a été exécutée.
nodeId	String	ID du nœud sur lequel la tâche a été exécutée.

multiInstanceSettings

Nom de l'élément	Type	Notes
numberOfInstances	Int32	Nombre de nœuds de calcul requis pour la tâche.

constraints

Nom de l'élément	Type	Notes
maxTaskRetryCount	Int32	Nombre maximal de fois que la tâche peut être retentée. Le service Batch retente une tâche si le code de sortie de celle-ci diffère de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une fois et peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est 3, le service Batch peut tenter d’exécuter la tâche jusqu’à 4 fois (tentative initiale + 3 tentatives supplémentaires). Si le nombre maximal de tentatives est 0, le service Batch ne réessaye pas d’exécuter des tâches. Si le nombre maximal de nouvelles tentatives est -1, le service Batch réessaie d’exécuter les tâches sans limite. La valeur par défaut est 0 (aucune nouvelle tentative).

executionInfo

Nom de l'élément	Type	Notes
startTime	DateTime	Heure à laquelle l’exécution de la tâche a commencé. « Running » correspond à l’état en cours d’exécution. Ainsi, si la tâche spécifie des fichiers de ressources ou des packages d’applications, l’heure de début est l’heure à laquelle la tâche a commencé à télécharger et à déployer ces éléments. Si la tâche a été redémarrée ou retentée, il s’agit de la dernière heure à laquelle l’exécution de la tâche a commencé.
endTime	DateTime	Heure à laquelle la tâche s’est terminée.
exitCode	Int32	Code de sortie de la tâche.
retryCount	Int32	Nombre de fois que le service Batch a réessayé d’exécuter la tâche. Si la tâche se termine avec un code de sortie autre que zéro, elle est retentée le nombre de fois spécifié par la valeur MaxTaskRetryCount.
requeueCount	Int32	Nombre de fois que la tâche a été replacée en file d’attente par le service Batch à la suite d’une demande de l’utilisateur. Lorsque l’utilisateur supprime des nœuds d’un pool (en redimensionnant ou en réduisant le pool), ou quand le travail est désactivé, l’utilisateur peut spécifier que les tâches en cours d’exécution sur les nœuds doivent être replacée en file d’attente pour exécution. Ce nombre reflète le nombre de fois que la tâche a été replacée en file d’attente pour ces raisons.