Retornos de trabalhos

A página Retornos de trabalhos fornece detalhes sobre os resultados de cada trabalho cuja execução foi finalizada. Você pode usar essa página para visualizar detalhes dos trabalhos e ler a saída de um trabalho. O SaltStack Config inclui vários outputters personalizados para formatar resultados de tipos de trabalho comuns.

Trabalhos são usados para executar tarefas de execução remota, aplicar estados e iniciar executores Salt. Consulte Trabalhos para obter mais informações.

Você pode exibir uma lista de trabalhos concluídos para um determinado subordinado ou de um determinado período. Também pode exibir um relatório detalhado de cada retorno de trabalho. Para obter mais informações sobre os outputters personalizados incluídos nos retornos de trabalho, consulte Outputters Personalizados.

Subordinados são nós que executam o serviço de subordinados e que podem ouvir comandos de um mestre Salt e executar as tarefas solicitadas. Consulte Subordinados para obter mais informações sobre subordinados.

Observação: Como parte da iniciativa da VMware de remover entradas de terminologia problemáticas, o termo mestre Salt será substituído por um termo melhor no SaltStack Config e em produtos e tópicos de documentação relacionados. Essa atualização de terminologia pode demorar alguns ciclos de lançamento antes de ser totalmente concluída.

Visualizando resultados de trabalho por subordinado

Para visualizar os resultados de trabalho de um subordinado específico:

Acesse o espaço de trabalho Subordinados e selecione um ID de subordinado.
Na página Detalhes, selecione a guia Atividade.
A guia Atividade mostra uma lista de até os últimos 500 trabalhos executados com base no subordinado selecionado na interface do usuário.
Selecione o JID do retorno de trabalho que você deseja visualizar.

Observação: O SaltStack Config retorna dados por meio dos mestres Salt e, em seguida, ao RaaS. Portanto, é possível que a guia Histórico de trabalhos não mostre dados imediatamente. Se você estiver visualizando resultados de trabalho para uma única execução de trabalho logo depois de iniciar esse trabalho, a guia de resultados poderá mostrar dados incompletos até que os mestres Salt tenham processado os retornos e os enviado de volta ao RaaS.

Visualizando resultados de trabalhos por hora de conclusão

Para visualizar resultados de trabalho de um intervalo de datas específico:

Acesse Atividade > Concluídos.
A seção Concluídos mostra uma lista de trabalhos concluídos. Você pode exibir a atividade para intervalos de tempo específicos filtrando ou classificando a coluna Hora de início. Para obter mais informações sobre como filtrar resultados por tempo, consulte Filtrando por intervalo de tempo. Para obter mais informações sobre o espaço de trabalho Atividade, consulte Atividade.
Clique no JID do retorno de trabalho que você deseja visualizar para abrir os detalhes desse trabalho.

Baixando resultados de trabalhos

Para baixar os resultados de um trabalho específico:

Clique em um JID, seguindo as etapas para visualizar resultados de trabalho por subordinado ou hora de conclusão, conforme explicado nas seções anteriores.
Clique em Baixar no canto superior direito do retorno de trabalho para abrir um menu e selecione JSON.

O arquivo .json começa a ser baixado no navegador.

Campos de informações sobre retornos de trabalho

A página de resultados do trabalho exibe os seguintes detalhes sobre a execução de trabalho selecionada:

Título

O título da página de resultados do trabalho indica a função e o ID do trabalho (JID).

Subtítulo

O subtítulo variará dependendo do tipo de trabalho que foi executado. A legenda exibe informações específicas sobre essa execução de trabalho, que podem incluir:

O nome do trabalho
O destino (como Todos os Subordinados)
Um ou mais mestres Salt que emitiram o trabalho
O nome do usuário que executou o trabalho
Detalhes do retorno

Exibições de detalhes do trabalho

Altere a formatação de dados dos retornos selecionando entre as seguintes opções.

Resumo: Uma lista de subordinados visados pelo trabalho. Cada subordinado inclui detalhes adicionais que você pode visualizar abrindo ou fechando sua respectiva lista suspensa.
Outputter personalizado: Uma representação personalizada dos resultados do trabalho projetada para a função associada ao trabalho. Consulte Outputters Personalizados para obter mais informações.
Bruto: Estrutura de dados JSON bruta com formatação mínima.
Informações do trabalho: Visão geral abrangente do trabalho, incluindo subordinados esperados para retorno, bem como aqueles que não retornaram.

Outputters Personalizados

O SaltStack Config inclui vários outputters personalizados para formatar resultados de tipos de trabalho comuns. O nome do outputter varia dependendo de qual trabalho ou função foi executado. Os possíveis títulos de outputters incluem:

Trabalhos de estado
test.ping
disk.usage
status.cpuinfo
network.routes
network.ipaddrs
network.netstat
cmd.run
cmd.script
pkg.list_pkgs
Informações do Usuário

Exemplos de outputters personalizados

Esta seção inclui exemplos de uma seleção de outputters personalizados para retornos de trabalhos.

Trabalhos de Estado

Retorna os resultados de um determinado módulo de estado ao executar um trabalho de estado, incluindo state.sls, state.highstate e state.apply. Uma função de estado é uma função contida dentro de um módulo de estado que pode gerenciar a aplicação de um determinado estado a um sistema. Funções de estado frequentemente exigem um ou mais módulos de execução para realizar uma determinada tarefa. Para obter mais informações sobre Estados Salt, consulte a documentação do Salt: Como usar Estados Salt?. Para obter mais informações sobre trabalhos, consulte Trabalhos.