La page Retours de tâche fournit des détails sur les résultats de chaque tâche terminée. Vous pouvez utiliser cette page pour afficher les détails de la tâche et lire la sortie d’une tâche. SaltStack Config inclut plusieurs sorties personnalisées pour formater les résultats des types de travail courants.

Les tâches servent à exécuter des tâches à distance, à appliquer des états et à démarrer des activités Salt. Pour plus d'informations, consultez Tâches.

Vous pouvez afficher la liste des tâches terminées pour un minion donné ou d'une période donnée. Vous pouvez également afficher un rapport détaillé de chaque retour de tâche. Pour plus d'informations sur les sorties personnalisées incluses dans les retours de tâche, consultez Émetteurs personnalisés.

Les minions sont des nœuds exécutant le service de minion, qui peut écouter les commandes d'un master Salt et effectuer les tâches demandées. Pour plus d'informations sur les minions, consultez Minions.

Note : Dans le cadre de l'initiative de VMware visant à supprimer la terminologie problématique, le terme master Salt sera remplacé par un meilleur terme dans SaltStack Config et les produits associés, ainsi que dans la documentation. Cette mise à jour terminologique peut s'étendre sur plusieurs cycles de publication.

Affichage des résultats d’une tâche par minion

Pour afficher les résultats d’une tâche pour un minion spécifique :

  1. Accédez à l'espace de travail Minions et sélectionnez un ID de minion.
  2. Sur la page Détails, sélectionnez l'onglet Activité.

    L'onglet Activité affiche une liste des 500 dernières tâches exécutées sur le minion sélectionné dans l'interface utilisateur.

  3. Sélectionnez le JID du retour de la tâche que vous souhaitez afficher.
Note : SaltStack Config renvoie des données via des masters Salt, puis à RaaS, par conséquent l'onglet Historique des tâche peut ne pas afficher immédiatement les données. Si vous affichez les résultats d'une tâche immédiatement après le démarrage de la tâche, l'onglet Résultats peut afficher des données incomplètes jusqu'à ce que les masters Salt aient traité les retours et les aient retransmis à RaaS.

Affichage des résultats des tâches par heure d'achèvement

Pour afficher les résultats d’une tâche pour une plage de dates spécifique :

  1. Accédez à Activité > Terminé.

    La section Terminé affiche la liste des tâches terminées. Vous pouvez afficher l'activité de plages de temps spécifiques en filtrant ou en triant la colonne Heure de début. Pour plus d'informations sur le filtrage des résultats par heure, consultez Filtrage par plage de temps. Pour plus d'informations sur l'espace de travail Activité, consultez Activité.

  2. Cliquez sur le JID du retour de la tâche que vous souhaitez afficher pour ouvrir les détails de la tâche.

Téléchargement des résultats de la tâche

Pour télécharger les résultats d’une tâche spécifique :

  1. Cliquez sur un JID, en suivant les étapes ci-après pour afficher les résultats d'une tâche par minion ou par heure d'achèvement, comme expliqué dans les sections précédentes.
  2. Cliquez sur Télécharger dans le coin supérieur droit de la tâche pour ouvrir un menu, puis sélectionnez JSON.

Le fichier .json démarre le téléchargement dans votre navigateur.

Champs d'informations de retour de tâche

La page de résultats de la tâche affiche les détails suivants sur l’exécuter de la tâche sélectionnée :

Titre
Le titre de la page de résultats de la tâche indique la fonction et l'ID de la tâche (JID).
Sous-titre

Le sous-titre varie en fonction du type de tâche qui a été exécutée. Le sous-titre affiche des informations spécifiques sur cette tâche, qui peuvent inclure :

  • Nom de la tâche
  • La cible (par exemple, Tous les minions)
  • Master Salt ou masters Salt qui ont émis la tâche
  • Nom de l'utilisateur qui a exécuté la tâche
  • Détails du retour
Vues des détails de la tâche

Modifiez le formatage des données de retour en sélectionnant parmi les options suivantes.

Résumé
Liste de sérions ciblés par la tâche. Chaque minion inclut des détails supplémentaires que vous pouvez afficher en ouvrant ou en fermant sa liste déroulante respective.
Émetteur personnalisé
Une représentation personnalisée des résultats de la tâche est conçue pour la fonction associée à la tâche. Consultez Émetteurs personnalisés pour plus d'informations.
Brut
Structure de données JSON brutes avec formatage minimal.
Infos sur la tâche
Présentation de la tâche de haut niveau, y compris les minions dont le retour était attendu ainsi que ceux qui ne sont pas revenus.

Émetteurs personnalisés

SaltStack Config inclut plusieurs sorties personnalisées pour formater les résultats des types de travail courants. Le nom de l'émetteur varie en fonction de la tâche ou de la fonction qui a été exécuté. Les titres d'émetteur possibles sont les suivants :

  • Tâches d'état
  • test.ping
  • disk.usage
  • status.cpuinfo
  • network.routes
  • network.ipaddrs
  • network.netstat
  • cmd.Run()
  • cmd.script
  • pkg.list_pkgs
  • Informations utilisateur

Exemples d'émetteurs personnalisés

Cette section inclut des exemples de sélection d'émetteurs de retour de tâche personnalisés.

Tâches d'état

Renvoie les résultats d'un module d'état donné lors de l'exécution d'une tâche d'état, notamment state.sls, state.highstate, state.apply. Une fonction d’état est une fonction contenue dans un module d’état qui peut gérer l’application d’un état particulier à un système . Les fonctions d’état appellent fréquemment un ou plusieurs modules d’exécution pour effectuer une tâche donnée. Pour plus d'informations sur les états Salt, consultez la Documentation Salt : Utilisation des états Salt. Pour plus d'informations sur les tâches, consultez Tâches.


state-outputter

Test.ping

Renvoie les résultats de l'exécution de test.ping pour chaque nœud du groupe cible.


ping-outputter

Utilisation du disque

Renvoie des informations d'utilisation des volumes montés sur des minions dans le groupe cible.

Informations sur le CPU

Cet émetteur inclut différentes vues que vous pouvez appliquer à l'aide de la colonne de gauche.


cpu-outputter

Routes

Renvoie les routes actuellement configurées à partir de la table de routage.


routes-outputter

Adresse IP

Renvoie la liste des adresses IPv4 attribuées à l'hôte.

Netstat

Un graphique interactif affiche les connexions entre les minions et les masters Salt.


netstat-outputter

Répertorier les modules

Affiche les packages actuellement installés sur chaque mini-on.

Informations utilisateur

Renvoie des informations pour les groupes d'utilisateurs définis par le système d'exploitation sur les minions ciblés.


getent-outputter