Trabalhos
Cada ação realizada em Workspaces gera um trabalho, os trabalhos permitem analisar o resultado das execuções realizadas, por exemplo consultando o output da execução de um microsserviço, ao mesmo tempo em que a seção Trabalhos
reúne todos os trabalhos realizados na organização, fornecendo também registros históricos de execuções, o que permite utilizá-lo como registro de auditoria.
Vista de lista
A vista de trabalhos é composta pelos seguintes elementos:
- Opções na parte superior da interface.
- Vista de lista de trabalhos.
Opções da parte superior
- Atualizar a lista de Trabalhos e mostrar os valores atualizados.
- Restabelecer todas as configurações feitas para a vista "trabalhos".
- Filtrar os trabalhos por antiguidade:
- Hoje (filtro padrão)
- Esta semana.
- Este mês.
- Este trimestre.
- Este ano.
- O botão
Cancelar
permite cancelar os Trabalhos em estado Pendente. - O botão
Notificar
permite inscrever-se em um Trabalho específico para receber uma notificação por e-mail quando o trabalho for concluído. - O botão
Exportar para
permite exportar no tipo selecionado. - O botão
Meus filtros
permite acessar Filtros pré-definidos ou criados pelo usuário. - É possível filtrar os trabalhos por qualquer parâmetro da lista de Trabalhos no campo
Buscar
.
Lista de trabalhos
A lista de trabalhos, como todas as vistas de lista de Workspaces, permite múltiplas opções de filtragem e personalização, definidas em Opções de filtragem nas listas
Vista de detalhes
A vista de detalhe inclui uma barra de progresso que indica a porcentagem que já foi executada.
Estados
Um trabalho pode ter quatro estados:
- Pendente: a tarefa está pendente de início.
- Em curso: a tarefa começou e ainda está em processo.
- Concluído: a tarefa foi finalizada.
- Erro: a tarefa não foi finalizada corretamente ou foi finalizada com erros.
- Cancelado pelo Usuário: quando um usuário cancela a tarefa.
- Concluído com erros: Quando a tarefa foi concluída, mas pelo menos um passo falhou com erros não críticos.
Suponha que um Trabalho demore muito tempo no estado "em andamento" sem registrar nenhuma informação. Nesse caso, seu estado mudará automaticamente para Erro. No entanto, isso não significa que o trabalho não será concluído com sucesso. Significa que há um timeout devido a um bloqueio de atividade durante a execução da tarefa.
Informação disponível
Em todos os casos, os trabalhos incluem as seguintes informações:
- A mudança a ser realizada (INFO)
- O estado
- A data de criação
- A data de início
- A data de finalização
- O usuário que realizou a mudança (OWNER)
Na parte inferior da tela, dependendo do tipo de trabalho, podem aparecer as seguintes abas:
Registros
A aba de registros permite consultar os dados de cada passo na execução, por exemplo, quando um microsserviço é executado em um dispositivo e deseja-se verificar o output da execução do script, essa informação é guardada no passo correspondente (linha de registros na lista).
Para melhorar a visibilidade do output de scripts, recomenda-se, no caso de scripts PowerShell o uso do comando "Write-Output" em vez de "Write-Host", mais informações em considerações-sobre-o-código-a-utilizar
Workspaces
A aba Workspaces
permite ver de forma simples a informação dos dispositivos que executaram o trabalho, no caso de execuções múltiplas.
Inscrição em Jobs
Esta função permite inscrever-se em trabalhos específicos, o que significa que o sistema lhe notifica por e-mail quando forem concluídos.
Só é possível inscrever-se em trabalhos que ainda não começaram ou que estão em andamento.
Para se inscrever, é necessário selecionar o(s) trabalho(s) da lista e ativar o botão de Enviar notificação
.