Utilisation de CloudWatch métriques avec AWS Batch

AWS Batch publie des statistiques sur les tâches sur Amazon afin CloudWatch de surveiller les transitions d'état et la durée des tâches tout au long de leur cycle de vie. AWS Batch publie ces métriques sous l'AWS/Batchespace de noms sans frais supplémentaires.

Les métriques sont émises au fur et à mesure que les tâches passent d'un État à l'autre et que les tentatives de travail sont terminées. Les mesures de transition d'État suivent le nombre d'emplois entrés dans un État donné, et les mesures de durée suivent la durée pendant laquelle les emplois ou les tentatives d'emploi ont été passés à se déplacer entre les États. Utilisez ces indicateurs pour créer des CloudWatch tableaux de bord, définir des CloudWatch alarmes et établir des niveaux de performance de référence pour vos charges de travail. Pour plus d'informations, consultez les sections Utilisation CloudWatch des métriques et Utilisation CloudWatch des alarmes dans le Guide de CloudWatch l'utilisateur Amazon.

Le comportement de reporting pour les tâches à nœud unique Emplois chez Array et Multi-node emplois parallèles diffère de celui-ci. La colonne Comportement des rapports du tableau suivant répertorie ces cas et Métriques pour les tâches de baie et les tâches parallèles à plusieurs nœuds décrit en détail le comportement du tableau et du MNP.

Note

AWS Batch émet ces mesures pour les tâches soumises à une file d'attente de tâches. Toutes les métriques sont publiées avec la JobQueueName dimension. Vous pouvez utiliser cette dimension pour regrouper et filtrer les données métriques en fonction de la file d'attente à laquelle une tâche a été soumise.

Important

Ces mesures sont fournies dans la mesure du possible et sont destinées à la surveillance et à l'observabilité plutôt qu'à la facturation, à l'audit ou au rapprochement. Étant donné que les transitions d'état des tâches sont déclenchées par des événements, une métrique peut parfois être omise. Par exemple, si une tâche commence à s'exécuter puis réussit ou échoue presque immédiatement, la transition vers RUNNING cet état peut ne pas être observée avant que la tâche n'atteigne son état terminal. Dans ce cas, AWS Batch n'émet pas les métriques associées à la RUNNING transition pour cette tâche. Concevez des alarmes ou des tableaux de bord de manière à tolérer des écarts occasionnels, et ne vous fiez pas aux chiffres exacts dérivés de ces indicateurs.

AWS Batch CloudWatch métriques

AWS Batch envoie les indicateurs de tâches suivants à CloudWatch. Les métriques de transition d'état utilisent l'Countunité et les métriques de durée utilisent l'Millisecondsunité.

Les indicateurs suivants s'appliquent aux AWS Batch tâches, quel que soit leur type.

Métrique	Description	Uunités	Comportement des rapports
JobsSubmitted	Le nombre de tâches qui ont été soumises à la file d'attente des tâches.	Nombre	Émis lorsqu'une tâche est soumise pour la première fois (entre dans l'SUBMITTEDétat). Pour une tâche de tableau, la valeur est la taille du tableau.
JobsMovedToPending	Le nombre d'emplois qui ont été transférés dans l'PENDINGÉtat.	Nombre	Émis lorsqu'une tâche est déplacée versPENDING. Un emploi est généralement PENDING en attente d'une dépendance à l'égard de l'emploi.
JobsMovedToRunnable	Le nombre d'emplois qui ont été transférés dans l'RUNNABLEÉtat.	Nombre	Émis lorsqu'une tâche est déplacée versRUNNABLE, soit pour la première fois, soit à la suite d'une nouvelle tentative.
JobsMovedToStarting	Le nombre d'emplois qui ont été transférés dans l'STARTINGÉtat.	Nombre	Émis lorsqu'une tâche est déplacée versSTARTING.
JobsMovedToRunning	Le nombre d'emplois qui ont été transférés dans l'RUNNINGÉtat.	Nombre	Émis lorsqu'une tâche est déplacée versRUNNING.
JobsMovedToSucceeded	Le nombre de tâches qui ont été achevées avec succès.	Nombre	Émis lorsqu'une tâche est déplacée versSUCCEEDED.
JobsMovedToFailed	Le nombre d'emplois qui ont été transférés dans l'FAILEDÉtat.	Nombre	Émis lorsqu'une tâche entre dans FAILED cet état. Inclut les tâches qui ont été annulées ou résiliées.
JobsCancelled	Le nombre de jobs qui ont été annulés.	Nombre	Émis lorsqu'une tâche entre dans FAILED cet état à la suite d'une demande d'annulation (avant que la tâche ne commence à s'exécuter).
JobsTerminated	Le nombre d'emplois qui ont été supprimés.	Nombre	Émis lorsqu'une tâche entre dans FAILED cet état à la suite d'une demande de fin.
JobsRetried	Le nombre de tentatives d'emploi qui ont été retentées.	Nombre	Émis lorsqu'une tentative de tâche échoue et que la tâche est renvoyée RUNNABLE pour être réessayée.
JobSubmittedToRunnableDuration	Le temps qu'il a fallu pour passer d'un travail SUBMITTED àRUNNABLE.	Millisecondes	Émis lors de l'entrée de la tâcheRUNNABLE. Pour un travail d'enfant matriciel, cela mesure le délai entre le moment où l'emploi du parent a été soumis et celui où l'emploi de l'enfant est devenuRUNNABLE.
JobAttemptStartingToRunningDuration	Le temps qu'une tentative de travail a passé STARTING avant qu'elle ne commence à fonctionner.	Millisecondes	Émis par tentative lors de la saisie de la tâcheRUNNING. Une tâche réessayée émet un point de données par tentative atteinte. RUNNING
JobAttemptExecutionDuration	Temps d'exécution d'une tentative de tâche, mesuré entre le début de la tentative et son arrêt.	Millisecondes	Émis lorsqu'une tentative de tâche est terminée, mesuré entre le moment où la tentative a commencé à s'exécuter et le moment où elle s'est arrêtée.
JobAttemptDuration	Durée totale d'une tentative de tâche, mesurée entre le moment où elle est entrée et la STARTING fin de la tentative.	Millisecondes	Émis à la fin d'une tentative. La tentative se termine soit lorsque la tâche atteint l'état terminal (SUCCEEDEDouFAILED), soit lorsqu'elle revient RUNNABLE pour être réessayée.

Les mesures suivantes s'appliquent uniquement aux tâches AWS Batch de calcul.

Métrique	Description	Uunités	Comportement des rapports
JobSubmittedToFirstStartingDuration	Le temps qu'il a fallu pour passer d'un travail SUBMITTED à sa première utilisationSTARTING.	Millisecondes	Émis lors de la première tentative, lorsque la tâche entre pour la première foisSTARTING.
JobAttemptRunnableToStartingDuration	Le temps qu'une tentative d'emploi a passé RUNNABLE avant qu'elle ne commence.	Millisecondes	Émis lors de l'entrée de la tâcheSTARTING.

Les mesures suivantes s'appliquent uniquement àEmplois dans le secteur des services en AWS Batch.

Métrique	Description	Uunités	Comportement des rapports
JobsMovedToScheduled	Le nombre d'emplois qui ont été transférés dans l'SCHEDULEDÉtat.	Nombre	Émis pour les tâches de service lorsque la tâche est transférée pour la première foisSCHEDULED, et de nouveau chaque fois que la tâche est déplacée SCHEDULED après une préemption.
JobSubmittedToFirstScheduledDuration	Le temps qu'il a fallu pour passer d'un travail dans le secteur des services SUBMITTED à sa première utilisationSCHEDULED.	Millisecondes	Émis pour les tâches de service lorsque la tâche est transférée pour la première fois àSCHEDULED.
JobAttemptRunnableToScheduledDuration	Le temps qu'une tentative d'emploi a passé RUNNABLE avant de passer àSCHEDULED.	Millisecondes	Émis par tentative lorsqu'une tâche de service est déplacée versSCHEDULED, à la fois lors du premier déplacement de la tâche SCHEDULED et à chaque fois qu'elle est déplacée SCHEDULED après une préemption.
JobAttemptScheduledToStartingDuration	Le temps qu'une tentative d'emploi dans le secteur des services a passé entre le premier déménagement SCHEDULED et le déménagementSTARTING.	Millisecondes	Émis pour les tâches de service lorsque la tâche passe de SCHEDULED àSTARTING.
JobsPreempted	Le nombre d'emplois qui ont été préemptés.	Nombre	Émis pour les tâches de gestion des quotas chaque fois que la tâche est préemptée.

Métriques pour les tâches de baie et les tâches parallèles à plusieurs nœuds

AWS Batch représente Emplois chez Array et Multi-node emplois parallèles en tant que parent un travail qui permet de suivre un ou plusieurs emplois pour enfants. Pour qu'une seule tâche logique ne soit pas comptabilisée deux fois, AWS Batch émet des métriques à partir d'un seul de ces deux enregistrements, en fonction du type de tâche.

Emplois chez Array

La tâche parent du tableau n'émet pas de métriques, à l'exception deJobsSubmitted. Au lieu de cela, chaque tâche enfant du tableau émet ces mesures indépendamment au cours de son cycle de vie, de sorte que le nombre de métriques reflète le nombre de tâches enfants plutôt que le nombre de tâches du tableau soumises.

La JobsSubmitted métrique est émise une fois pour la tâche parent du tableau lors de la soumission, et sa valeur est la taille du tableau (le nombre de tâches enfants). Par exemple, la soumission d'une tâche de tableau avec 1 000 enfants publie un point de JobsSubmitted données unique d'une valeur de1000.

Les métriques de durée qui mesurent le temps écoulé depuis la soumission, par exemple, sont émises par tâche enfant du tableau et mesurent entre le moment où le parent du tableau a été soumis et le moment où cet enfant a atteint l'état en question. JobSubmittedToRunnableDuration

Multi-node emplois parallèles (MNP)

Les métriques MNP sont émises par la tâche mère MNP, qui représente la tâche dans son ensemble. Les tâches enfants (nœuds) MNP individuelles n'émettent pas ces métriques. Par conséquent, une tâche MNP est comptabilisée une seule fois, quel que soit le nombre de nœuds qu'elle utilise.

Dimensions pour AWS Batch CloudWatch métriques

AWS Batch les indicateurs de l'emploi CloudWatch utilisent une seule dimension :JobQueueName. Toutes les données métriques sont regroupées et filtrées en fonction du nom de la file d'attente à laquelle une tâche a été soumise.

Afficher AWS Batch CloudWatch métriques

Vous pouvez consulter les statistiques des AWS Batch tâches dans la AWS Batch console ou dans la CloudWatch console sous l'AWS/Batchespace de noms.

Important

L'affichage des métriques dans la console entraîne des CloudWatch frais standard. Vous pouvez désactiver l'affichage des métriques à tout moment pour arrêter les frais. Pour plus d'informations, consultez la page CloudWatch Tarification Amazon.

Pour afficher les statistiques sur le tableau de bord des mesures par lots

1. Ouvrez la console AWS Batch.

2. Dans le volet de navigation, choisissez Tableau de bord, puis choisissez l'onglet Batch metrics.

3. Activez Afficher CloudWatch les statistiques.

4. Sous Filtrer les mesures, sélectionnez jusqu'à cinq files d'attente de tâches et les mesures que vous souhaitez représenter graphiquement.

5. Choisissez Appliquer les filtres. La console affiche un graphique par métrique, avec une ligne par file d'attente de tâches.

6. Pour recommencer, choisissez Effacer les filtres pour supprimer vos sélections ou Réinitialiser les filtres pour rétablir les paramètres par défaut.

7. (Facultatif) Pour réutiliser une combinaison de files d'attente de tâches et de mesures, utilisez un ensemble de filtres enregistré. Les ensembles de filtres sont enregistrés selon vos préférences AWS utilisateur, de sorte qu'ils persistent d'une session à l'autre. Vous pouvez en enregistrer jusqu'à cinq. Gérez-les à partir de la liste déroulante Ensembles de filtres enregistrés et du menu fléché du bouton Effacer les filtres, puis choisissez l'une des options suivantes :

   • Enregistrer  : sélectionnez vos files d'attente de tâches et vos indicateurs, puis choisissez Enregistrer en tant que nouvel ensemble de filtres. Entrez un nom unique et marquez-le éventuellement comme nom par défaut.

   • Appliquer  : choisissez un ensemble dans la liste déroulante Ensembles de filtres enregistrés, puis choisissez Appliquer les filtres.

   • Mettre à jour  : une fois qu'un ensemble est sélectionné, modifiez vos sélections et choisissez Mettre à jour le jeu de filtres actuel.

   • Définir par défaut - Une fois qu'un ensemble est sélectionné, choisissez Paramètres, puis Définir par défaut. L'ensemble par défaut se charge automatiquement lorsque vous ouvrez l'onglet.

   • Supprimer - Une fois un ensemble sélectionné, choisissez Supprimer le jeu de filtres actuel.

Pour afficher les statistiques d'une seule file d'attente de tâches

1. Dans le volet de navigation, choisissez Files d'attente de tâches, puis choisissez une file d'attente de tâches.

2. Sélectionnez l'onglet Monitoring (Surveillance).

3. Activez Afficher CloudWatch les statistiques.

4. Dans les sections Mesures de transition d'état , Mesures des événements du cycle de vie et Mesures de durée, utilisez chaque sélecteur de mesures pour choisir les mesures à représenter graphiquement.

Les mesures affichées sont limitées à cette file d'attente de tâches. Vos sélections sont enregistrées par file d'attente de tâches et persistent d'une session à l'autre.

Pour utiliser ces métriques directement dans CloudWatch , par exemple, pour créer des tableaux de bord ou définir des alarmes, ouvrez la CloudWatch console et choisissez l'espace de AWS/Batch noms.