Partager via


Événement d’échec de planification de tâches

Cet événement est émis lorsqu’une tâche n’a pas pu être planifiée et qu’elle est retentée ultérieurement. Il s’agit d’un échec temporaire au moment de la planification des tâches en raison de la limitation des ressources, par exemple, des emplacements insuffisants disponibles sur les nœuds pour exécuter une tâche avec requiredSlots spécifiée.

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

{
    "jobId": "job-01",
    "id": "task-01",
    "taskType": "User",
    "systemTaskVersion": 665378862,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-01",
        "nodeId": " "
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 0
    },
    "schedulingError": {
        "category": "UserError",
        "code": "JobPreparationTaskFailed",
        "message": "Task cannot run because the job preparation task failed on node"
    }
}
Nom de l’élément Catégorie Remarques
jobId Chaîne ID du travail contenant la tâche.
id Chaîne ID de la tâche.
taskType Chaîne Type de la tâche. Il s’agit de « JobManager » indiquant qu’il s’agit d’une tâche de gestionnaire de travaux ou d’un « utilisateur » indiquant qu’il ne s’agit pas d’une tâche de gestionnaire de travaux. Cet événement n’est pas émis pour les tâches de préparation du travail, les tâches de mise en production du travail ou les tâches de démarrage.
systemTaskVersion Int32 Compteur de nouvelles tentatives interne sur une tâche. En interne, le service Batch peut réessayer une tâche pour prendre en compte les problèmes temporaires. Ces problèmes peuvent inclure des erreurs de planification internes ou des tentatives de récupération à partir de nœuds de calcul dans un état incorrect.
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 s’est 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.
schedulingError Type complexe Contient des informations sur l’erreur de planification de la tâche.

nodeInfo

Nom de l’élément Catégorie Remarques
poolId Chaîne ID du pool sur lequel la tâche s’est exécutée.
nodeId Chaîne ID du nœud sur lequel la tâche s’est exécutée.

multiInstanceSettings

Nom de l’élément Catégorie Remarques
numberOfInstances Int32 Nombre de nœuds de calcul requis par la tâche.

Contraintes

Nom de l’élément Catégorie Remarques
maxTaskRetryCount Int32 Nombre maximal de fois où la tâche peut être retentée. Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro.

Cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch tente la tâche une seule fois, puis peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est de 3, Batch tente une tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives).

Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch n’effectue pas de nouvelles tentatives.

Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente des tâches sans limite.

La valeur par défaut est 0 (aucune nouvelle tentative).

schedulingError

Nom de l’élément Catégorie Remarques
category Chaîne Catégorie de l’erreur.
code Chaîne Identificateur de l’erreur de planification des tâches. Les codes sont invariants et sont destinés à être consommés par programme.
message Chaîne Message décrivant l’erreur de planification des tâches, destiné à être adapté à l’affichage dans une interface utilisateur.