Ir para conteúdo principal

Resultados de Comandos

Saiba mais sobre os resultados da execução de Comandos.

A seção Resultados de Comandos no Trio fornece uma interface centralizada e em tempo real para monitorar o resultado das execuções de Comandos em todos os dispositivos registrados. Depois que os Comandos são enviados, seja manualmente, em um cronograma ou por meio de gatilhos de automação, seu status, saída e metadados de execução são capturados e exibidos nesta visualização.

Essa capacidade é fundamental para os administradores de TI responsáveis por verificar a conclusão da tarefa, diagnosticar falhas de Comando, validar configurações e realizar revisões de auditoria. Ele permite visibilidade granular na execução no nível do dispositivo, incluindo códigos de saída, logs, erros de tempo de execução e saída específica do Comando.

Pré-requisitos

Apenas usuários com permissões para executar ou gerenciar Comandos, como Super Admin, IT Admin ou funções personalizadas com “Acesso ao Log de Execução de Comando” habilitado, podem visualizar esta seção.

Para que os resultados do Comando sejam gerados, as seguintes condições devem ser atendidas:

  • O dispositivo de destino deve ter o agente Trio instalado e ativo.

  • Comando

  • Os dispositivos devem ser capazes de se comunicar com o servidor no momento da transmissão do resultado.

  • O comando não deve ter sido interrompido por erros de rede, tempos limite ou cancelamentos manuais antes do registro.

Caminho de Acesso

Frota → Comando → Resultados

Visão geral da interface de resultados

Quando os Comandos são executados, o Trio coleta e apresenta registros de resultados em uma tabela estruturada. A parte superior da visualização inclui uma barra de pesquisa e filtros multidimensionais para refinar a visibilidade com base em:

  • Status – Filtre por resultado (por exemplo, Sucesso, Tempo limite, Erro)

  • SO/Ambiente – Windows (CMD/PowerShell) ou macOS (bash/zsh)

  • Código de saída – Códigos de saída personalizados ou padrão (por exemplo, 0 para sucesso)

  • Dispositivo – Nome do dispositivo que executou os Comandos

  • Comandos

Cada entrada de resultado inclui o seguinte:

  • Nome do Comando – O nome conforme definido durante a criação

  • SO (Ambiente) – O sistema operacional e o ambiente de execução (por exemplo, PowerShell)

  • Dispositivo – O endpoint específico que executou o Comando

  • Código de saída – Saída numérica indicando o resultado da execução

  • Status – Sucesso, Tempo limite ou Erro

  • Concluído em – Timestamp de conclusão

Visualizando detalhes do resultado do comando

Clicar em qualquer linha de resultado expande a visualização Detalhes do resultado do comando. Este modal contém uma análise abrangente da execução, incluindo:

  • Dispositivo – O nome completo do endpoint

  • Nome do Grupo – Grupo organizacional ao qual o dispositivo pertence

  • Executar como – Privilégios de execução (Sistema/Root)

  • Código de saída – O valor de saída retornado (por exemplo, 1 = erro geral, 0 = sucesso)

  • Sincronização de tempo do servidor e do agente – Útil para discrepâncias de tempo

  • Timestamps de início/término – Horários exatos de início e parada

  • Arquivos – Se algum foi anexado ou baixado

  • Comando bruto – O conteúdo completo do Comando conforme executado no dispositivo

  • Saída do log de comando – Saída padrão ou logs retornados pelo agente, incluindo mensagens de tempo de execução, rastreamentos de erro ou valores de eco

Exportando resultados de comandos

Na visualização de detalhes do resultado, um botão Exportar está disponível. Isso permite que os administradores baixem os detalhes do resultado (normalmente em JSON ou CSV) para conformidade, revisão offline ou escalonamento de tickets.

Esta exportação inclui todo o contexto de execução: metadados do dispositivo, logs, conteúdo do Comando e timestamps. É especialmente valioso ao investigar configurações incorretas do sistema ou implantações com falha.

Notas sobre o comportamento do sistema

  • Tempos limite ocorrem quando um Comando excede seu limite de tempo de execução definido. Estes são marcados claramente em vermelho com um status de “Tempo limite” e código de saída 1.

  • Erros podem resultar de problemas de sintaxe, caminhos inválidos, problemas de permissão ou dependências ausentes. Estes retornam o status “Erro” e o código de saída 1 (a menos que substituído pelo Comando.

  • Sucesso é indicado pelo código de saída 0 e rótulos verdes de “Sucesso”.

  • Atrasos ou falhas do lado do agente na transmissão de resultados podem causar logs ausentes ou parciais.

  • Dispositivo offline no horário de término? Se o Comando for executado, mas o resultado não for sincronizado, ele poderá não aparecer. Garanta uma conectividade de rede confiável.

Solução de problemas

  • Resultados ausentes? Confirme se o Comando foi atribuído corretamente e se o dispositivo estava online durante e após a execução.

  • Código de saída inesperado? Consulte a lógica do seu Comando e certifique-se de que os valores de retorno estejam definidos corretamente.

  • Saída de log ausente? Certifique-se de que o Comando grava a saída em STDOUT ou STDERR, que o Trio captura.

  • O status mostra Tempo limite, mas terminou? Isso pode indicar uma incompatibilidade entre a configuração de tempo limite e o tempo de execução real. Revise a configuração de “Tempo limite” na definição do Comando.

Isto respondeu à sua pergunta?