De pagina Opdrachtresultaten (Job returns) bevat details over de resultaten van elke opdracht die is voltooid. U kunt deze pagina gebruiken om opdrachtdetails weer te geven en de uitvoer van een opdracht te lezen. SaltStack Config bevat verschillende aangepaste uitvoerders om resultaten voor algemene opdrachttypen op te maken.
Opdrachten worden gebruikt om externe uitvoeringstaken uit te voeren, om staten toe te passen en om Salt-runners te starten. Zie Opdrachten voor meer informatie.
U kunt een lijst met voltooide opdrachten bekijken voor een bepaalde minion of een bepaalde tijdsperiode. U kunt ook een gedetailleerd rapport van elk opdrachtresultaat bekijken. Zie Aangepaste uitvoerders voor meer informatie over aangepaste uitvoerders die zijn opgenomen in opdrachtresultaten.
Minions zijn knooppunten die gebruikmaken van de minionservice, waarmee wordt geluisterd naar commando's van een Salt-master en de gevraagde taken worden uitgevoerd. Zie Minions voor meer informatie over minions.
Opdrachtresultaten per minion weergeven
De opdrachtresultaten voor een specifieke minion weergeven:
- Ga naar de werkplek Minions en selecteer een minion-id.
- Selecteer het tabblad Activiteit (Activity) op de pagina Details.
Op het tabblad Activiteit (Activity) ziet u een lijst met de laatste 500 opdrachten die zijn uitgevoerd voor de geselecteerde minion in de gebruikersinterface.
- Selecteer de JID van het opdrachtresultaat dat u wilt weergeven.
Opdrachtresultaten op voltooiingstijd weergeven
Opdrachtresultaten voor een specifiek tijd- en datumbereik weergeven:
- Ga naar Activiteit > Voltooid (Activity > Completed).
Het gedeelte Voltooid (Completed) bevat een lijst met voltooide opdrachten. U kunt activiteiten voor specifieke tijdsbereiken weergeven door de kolom Begintijd (Start time) te filteren of te sorteren. Zie Filteren op tijdsbereik voor meer informatie over het filteren van resultaten op tijd. Zie Activiteit voor meer informatie over de werkplek Activiteit (Activity).
- Klik op de JID van het opdrachtresultaat dat u wilt weergeven om de opdrachtdetails te openen.
Opdrachtresultaten downloaden
De opdrachtresultaten voor een specifieke opdracht downloaden:
- Klik op een JID en volg de volgende stappen om de opdrachtresultaten per minion of op voltooiingstijd te bekijken zoals uitgelegd in de vorige gedeelten.
- Klik op Downloaden (Download) rechtsboven in het opdrachtresultaat om een menu te openen en selecteer vervolgens JSON.
Het bestand .json
wordt gedownload naar uw browser.
Informatievelden voor opdrachtresultaten
Op de pagina met opdrachtresultaten worden de volgende details over de geselecteerde opdrachtuitvoeringen weergegeven:
- Titel (Title)
- De titel van de pagina met opdrachtresultaten geeft de functie en de opdracht-id (JID) van de opdracht aan.
- Ondertitel (Subtitle)
-
De ondertitel zal variëren afhankelijk van het type opdracht dat is uitgevoerd. De ondertitel bevat specifieke informatie over deze opdrachtuitvoering, waaronder:
- De opdrachtnaam
- Het doel (zoals Alle minions (All Minions))
- De Salt-master of Salt-masters waardoor de opdracht is uitgegeven
- De naam van de gebruiker die de opdracht heeft uitgevoerd
- Resultaatdetails
- Weergaven van opdrachtdetails (Job detail views)
-
Wijzig de opmaak van de resultaatgegevens door een selectie te maken uit de volgende opties.
- Samenvatting
- Een lijst met minions die het doel zijn van de opdracht. Elke minion bevat aanvullende details die u kunt bekijken door de respectieve vervolgkeuzelijst te openen of te sluiten.
- Aangepaste uitvoerder (Custom outputter)
- Een aangepaste weergave van de opdrachtresultaten die zijn ontworpen voor de functie die is gekoppeld aan de opdracht. Zie Aangepaste uitvoerders voor meer informatie.
- Onbewerkt (Raw)
- Onbewerkte JSON-gegevensstructuur met minimale opmaak.
- Opdrachtinfo (Job info)
- Opdrachtoverzicht op hoog niveau, met inbegrip van minions waarvan retournering wordt verwacht, evenals minions die niet zijn geretourneerd.
Aangepaste uitvoerders
SaltStack Config bevat verschillende aangepaste uitvoerders om resultaten voor algemene opdrachttypen op te maken. De naam van de uitvoerder varieert afhankelijk van de opdracht of functie die is uitgevoerd. De mogelijke uitvoerdertitels omvatten het volgende:
- Statusopdrachten
- test.ping
- disk.usage
- status.cpuinfo
- network.routes
- network.ipaddrs
- network.netstat
- cmd.run
- cmd.script
- pkg.list_pkgs
- Gebruikersinformatie
Voorbeelden van aangepaste uitvoerders
Dit gedeelte bevat voorbeelden van een selectie van uitvoerders voor aangepaste opdrachtresultaten.
Statusopdrachten (State Jobs)
Retourneert resultaten van een bepaalde statusmodule wanneer een statusopdracht wordt uitgevoerd, inclusief state.sls
, state.highstate
, state.apply
. Een statusfunctie is een functie in een statusmodule die de toepassing van een bepaalde status op een systeem kan beheren. Statusfuncties roepen regelmatig een of meer uitvoeringsmodulen aan om een bepaalde taak uit te voeren. Zie Salt-documentatie: Hoe gebruik ik Salt-statussen? voor meer informatie over Salt-statussen. Zie Opdrachten voor meer informatie over opdrachten.
Test.ping
Retourneert resultaten van het uitvoeren van test.ping
voor elk knooppunt in de doelgroep.
Schijfgebruik (Data Usage)
Retourneert gebruiksinformatie voor volumes die zijn gekoppeld aan minions in de doelgroep.
CPU-informatie (CPU Info)
Deze uitvoerder bevat verschillende weergaven die u kunt toepassen met behulp van de linkerkolom.
Routes
Retourneert momenteel geconfigureerde routes uit de routeringstabel.
IP-adres (IP Address)
Retourneert een lijst met IPv4-adressen die aan de host zijn toegewezen.
Netstat
In een interactieve grafiek worden verbindingen tussen minions en Salt-masters weergegeven.
Lijstpakketten (List packages)
Toont pakketten die momenteel op elke minion zijn geïnstalleerd.
Gebruikersinformatie (User Information)
Retourneert informatie voor door het besturingssysteem gedefinieerde gebruikersgroepen op de getargete minions.