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.
Affichage des résultats d’une tâche par minion
Pour afficher les résultats d’une tâche pour un minion spécifique :
- Accédez à l'espace de travail Minions et sélectionnez un ID de minion.
- 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.
- Sélectionnez le JID du retour de la tâche que vous souhaitez afficher.
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 :
- 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é.
- 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 :
- 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.
- 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.
Test.ping
Renvoie les résultats de l'exécution de test.ping
pour chaque nœud du groupe cible.
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.
Routes
Renvoie les routes actuellement configurées à partir de la table de routage.
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.
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.