Surveiller les solutions Batch en comptant les tâches et les nœuds par état

  • Article

Pour surveiller et gérer des solutions Azure Batch à grande échelle, vous devrez peut-être déterminer le nombre de ressources dans les différents états. Azure Batch fournit des opérations efficaces pour obtenir ces nombres pour les tâches et les nœuds de calcul Batch. Vous pouvez utiliser ces opérations à la place des requêtes de liste potentiellement longues pour retourner des informations détaillées sur les grandes collections de tâches ou de nœuds.

  • Obtenir le nombre de tâches obtient un comptage agrégé des tâches actives, en cours d’exécution et terminées dans un travail, ainsi que des tâches ayant réussi ou échoué. En comptant les tâches dans chaque état, vous pouvez plus facilement afficher la progression du travail à un utilisateur, ou détecter des retards ou échecs inattendus susceptibles d’affecter le travail.

  • Répertorier le nombre de nœuds des pools permet d’obtenir le nombre de nœuds de calcul dédiés et de nœuds de calcul spot de chaque pool et de connaître leur état : en cours de création, inactif, hors connexion, préempté, en cours de redémarrage, réinitialisation, démarrage, etc. En comptant les nœuds dans chaque état, vous pouvez déterminer quand vous avez des ressources de calcul suffisantes pour exécuter vos travaux, et identifier les problèmes potentiels avec vos pools.

Notez que dans certains cas, les nombres retournés par ces opérations peuvent ne pas être à jour. Si vous devez vous assurer qu’un nombre est exact, utilisez une requête de liste pour compter ces ressources. Les requêtes de liste vous permettent également d’obtenir des informations sur d’autres ressources Batch, comme les applications. Pour plus d’informations sur l’application de filtres aux requêtes de liste, consultez Créer des requêtes pour répertorier les ressources Batch efficacement.

Nombre d’états des tâches

L’opération Obtenir le nombre de tâches compte les tâches selon les états suivants :

  • Actif : tâche qui est en file d’attente et en mesure de s’exécuter, mais qui n’est actuellement pas affectée à un nœud de calcul. Une tâche est également active si elle est dépendante d’une tâche parente qui n’est pas encore terminée.
  • En cours d’exécution : tâche qui a été affectée à un nœud de calcul, mais qui n’est pas encore terminée. Une tâche est comptée comme running quand son état est preparing ou running, comme indiqué par l’opération Obtenir des informations sur une tâche.
  • Terminé : tâche qui n’est plus éligible pour s’exécuter, car elle s’est terminée correctement, ou bien elle a échoué et a épuisé son nombre maximal de nouvelles tentatives.
  • Réussite : tâche dont le résultat de l’exécution est success. Le service Batch détermine si une tâche a réussi ou échoué en vérifiant la propriété TaskExecutionResult de la propriété executionInfo.
  • Échec : tâche dont le résultat de l’exécution est failure.

L’exemple de code .NET suivant montre comment récupérer le nombre de tâches par état.

var taskCounts = await batchClient.JobOperations.GetJobTaskCountsAsync("job-1");

Console.WriteLine("Task count in active state: {0}", taskCounts.Active);
Console.WriteLine("Task count in preparing or running state: {0}", taskCounts.Running);
Console.WriteLine("Task count in completed state: {0}", taskCounts.Completed);
Console.WriteLine("Succeeded task count: {0}", taskCounts.Succeeded);
Console.WriteLine("Failed task count: {0}", taskCounts.Failed);

Pour obtenir le nombre de tâches pour un travail, vous pouvez utiliser un modèle semblable pour REST et d’autres langages pris en charge.

Nombre d’états des nœuds

L’opération Répertorier le nombre de nœuds des pools compte les nœuds selon les états suivants dans chaque pool. Des comptages agrégés distincts sont fournis pour les nœuds dédiés et pour les nœuds spot de chaque pool.

  • Création : machine virtuelle allouée par Azure qui n’a pas encore commencé à rejoindre un pool.
  • Inactif : nœud de calcul disponible qui n’exécute actuellement pas une tâche.
  • LeavingPool : nœud qui quitte le pool parce que l’utilisateur l’a explicitement supprimé ou parce que le pool est redimensionné ou mis automatiquement à une plus basse échelle.
  • Hors connexion : nœud que le service Batch ne peut pas utiliser pour planifier de nouvelles tâches.
  • Préempté : nœud spot qui a été supprimé du pool parce qu’Azure a souhaité récupérer la machine virtuelle. Un nœud preempted peut être réinitialisé quand la capacité de la machine virtuelle spot de remplacement est disponible.
  • En cours de redémarrage : nœud qui redémarre.
  • Réimageage : nœud sur lequel le système d’exploitation est en cours de réinstallation.
  • En cours d’exécution : nœud qui exécute une ou plusieurs tâches (autre que la tâche de démarrage).
  • En cours de démarrage : nœud sur lequel le service Batch démarre.
  • StartTaskFailed : nœud sur lequel la tâche de démarrage a échoué et a épuisé toutes les nouvelles tentatives, et sur lequel waitForSuccess est défini sur la tâche de démarrage. Le nœud n’est pas utilisable pour exécuter des tâches.
  • Inconnu : nœud qui a perdu le contact avec le service Batch et dont l’état n’est pas connu.
  • Inutilisable : nœud qui ne peut pas être utilisé pour l’exécution de tâches en raison d’erreurs.
  • WaitingForStartTask : nœud sur lequel la tâche de démarrage a démarré, mais sur lequel waitForSuccess est défini et où la tâche de démarrage n’est pas terminée.

L’extrait de code C# suivant montre comment répertorier le nombre de nœuds pour tous les pools du compte actif :

foreach (var nodeCounts in batchClient.PoolOperations.ListPoolNodeCounts())
{
    Console.WriteLine("Pool Id: {0}", nodeCounts.PoolId);

    Console.WriteLine("Total dedicated node count: {0}", nodeCounts.Dedicated.Total);

    // Get dedicated node counts in Idle and Offline states; you can get additional states.
    Console.WriteLine("Dedicated node count in Idle state: {0}", nodeCounts.Dedicated.Idle);
    Console.WriteLine("Dedicated node count in Offline state: {0}", nodeCounts.Dedicated.Offline);

    Console.WriteLine("Total Spot node count: {0}", nodeCounts.LowPriority.Total);

    // Get Spot node counts in Running and Preempted states; you can get additional states.
    Console.WriteLine("Spot node count in Running state: {0}", nodeCounts.LowPriority.Running);
    Console.WriteLine("Spot node count in Preempted state: {0}", nodeCounts.LowPriority.Preempted);
}

L’extrait de code C# suivant montre comment répertorier le nombre de nœuds pour un pool donné dans le compte actuel.

foreach (var nodeCounts in batchClient.PoolOperations.ListPoolNodeCounts(new ODATADetailLevel(filterClause: "poolId eq 'testpool'")))
{
    Console.WriteLine("Pool Id: {0}", nodeCounts.PoolId);

    Console.WriteLine("Total dedicated node count: {0}", nodeCounts.Dedicated.Total);

    // Get dedicated node counts in Idle and Offline states; you can get additional states.
    Console.WriteLine("Dedicated node count in Idle state: {0}", nodeCounts.Dedicated.Idle);
    Console.WriteLine("Dedicated node count in Offline state: {0}", nodeCounts.Dedicated.Offline);

    Console.WriteLine("Total Spot node count: {0}", nodeCounts.LowPriority.Total);

    // Get Spot node counts in Running and Preempted states; you can get additional states.
    Console.WriteLine("Spot node count in Running state: {0}", nodeCounts.LowPriority.Running);
    Console.WriteLine("Spot node count in Preempted state: {0}", nodeCounts.LowPriority.Preempted);
}

Pour obtenir le nombre de nœuds pour des pools, vous pouvez utiliser un modèle similaire pour REST et pour les autres langages pris en charge.

Étapes suivantes