v.5.70 - Robôs

Para acessar a guia Robô você deverá acessar o Módulo Studio e seguir os passos abaixo:

Posicione o mouse sobre a aba Modelador e clique em Robô:

Por padrão da Plataforma Lecom, você será direcionado para a tela de Dashboard, na qual é possível visualizar várias informações sobre a execução dos robôs. Há ainda, mais duas opções de tela: Robôs e Histórico. Aqui também é possível iniciar o cadastro de um novo Robô. Veja a seguir o detalhamento de cada item:

No menu Dashboard é possível verificar a quantidade das seguintes informações obtidas nas últimas 24 horas geradas sobre os Executores e sobre os Robôs:

a. Executores:

I. Informações – Contemplam os seguintes status:

1) Consumo de memória normalizado

2) Consumo de disco normalizado

3) Iniciando com sucesso

4) Desligado com sucesso

II. Alertas: – Contemplam os seguintes status:

1) Alto consumo de CPU

2) Alto consumo de memória

3) Alto consumo de disco

4) Reinicialização do executor inesperada

5) Pausado

III. Falhas – Contemplam os seguintes status:

1) Erro inesperado

b. Robôs:

I. Execuções: Quantidade de robôs executados nas últimas 24 horas.

II. Alertas: Quantidade de robôs que dispararam os status: Abortado; Interrompido; Ignorado

III. Falhas: Quantidade de robôs que dispararam os status Erro; Falha no disparo

IV. Sucesso: Quantidade de robôs que dispararam os status Iniciado; Sucesso; Disparado

Essas informações remetem ao monitoramento das últimas 24 horas dos Executores e Robôs.

Abaixo, à esquerda, nosso Dashboard apresenta:

a. Executor: Nome do executor

b. Quantidade de robôs em execução

c. Capacidade de execução de robôs

E demonstra também em gráficos alguns desempenhos do executor:

a. Load averge: Medida que indica a quantidade média de trabalho sendo realizado pela máquina em um determinado período (informação não será exibida para ambientes Windows)

b. Consumo de memória

c. Consumo de disco

No canto superior à direita você encontra três funcionalidades: Parar/ Iniciar a execução do robô, Exibir tela cheia e Novo robô, para cadastrar um novo robô.

a. Parar/ Iniciar robô: Este botão serve para determinar se o sistema deve realizar ou não os agendamentos dos robôs, caso o botão esteja como "Parar", significa que o ambiente está realizando os agendamentos dos robôs, caso contrário, o ambiente está com os agendamentos de robôs pausados.

Para cadastrar um novo robô clique no botão + Novo robô e você terá acesso ao formulário com os campos que se referem a identificação do robô, a nível de log e tempo de execução. Observe na imagem abaixo a disposição desses campos:

Os campos com um asterisco vermelho (*) são campos obrigatórios e deverão receber um valor.

Agora vamos detalhar cada campo do formulário para que você possa cadastrar um novo robô:

a) Nome: Atribua um nome único para o robô. Após inserir o nome do robô, a Plataforma Lecom verifica se já existe algum robô com o nome inserido. Caso haja, será exibido a seguinte mensagem “o nome já está sendo usado” Poderíamos trocar para: o nome já está em uso e você poderá inserir um novo nome. Lembre-se este campo é obrigatório

Observe a mensagem exibida na imagem abaixo:

b) Identificador: Atribua um identificador para o robô, pode ser igual ao nome. Caso o identificador inserido já exista, será exibido a seguinte mensagem “o identificador já está sendo usado” Poderíamos trocar para: o nome já está em uso e você poderá inserir um novo identificador. Lembre-se este campo é obrigatório

Observe a mensagem exibida na imagem abaixo:

c) Repositório: Este campo é preenchido automaticamente de acordo com os cenários abaixo:

a. Caso o Identificador inserido exista e esteja vinculado a algum robô, será exibida a seguinte mensagem "O identificador já está sendo usado".

b. Caso o Identificador exista, mas no momento não está vinculado a nenhum robô, será exibida a seguinte mensagem “o repositório já existe e será vinculado”.

c. Caso não exista nenhum repositório vinculado ao Identificador será exibida a seguinte mensagem “O repositório não existe, será criado um novo”.

d) Descrição: Insira uma descrição que remeta ao funcionamento do robô. Lembre-se temos 250 caracteres disponíveis.

e) Nível de log: Neste campo, você poderá definir os níveis logs de acompanhamento durante a execução do robô. Vale lembrar que é uma escala crescente. Basta clicar sobre o item inicial e ir arrastando, conforme gif abaixo:

a. Error: utilizado para monitorar os logs de Errors

b. Warn: utilizado para monitorar os logs de Warn e Error

c. Info: utilizado para monitorar os logs de Info e anteriores

d. Debug: utilizado para monitorar os logs de Debug e anteriores

e. Trace: utilizado para monitorar os logs de Trace e anteriores

f) Tempo de execução: Define qual a periodicidade que o robô será executado, “de quanto, em quanto tempo”.

a. Simples: Selecione a frequência que deseja que o robô seja executado e a periodicidade. Abaixo apresentamos as possibilidades disponíveis na Plataforma Lecom:

Frequência	Periodicidade
1	Minuto
2	Hora
3	Dia
4	Semana
5	Mês
6	Ano
10	-
15	-
20	-
30	-

Após selecionar a opção desejada, será exibido em destaque a sua escolha:

b. Avançado: Nesta guia é possível criar cron (periodicidade de execução). A expressão Cron é usada para configurar instâncias específicas de um acionador. Principalmente para o acionamento repetitivo agendado. As seguintes possibilidades de cron estão disponíveis:

I. Minutos

II. Horas

III. Dias (mês)

IV. Meses

V. Dias (semana)

Cada caractere representa uma função e cada função tem caracteres específicos. Conforme exemplo abaixo, que aparece primeiramente por padrão da Plataforma Lecom:

* (asterisco) todos os valores
, (vírgula) separador de lista de valores
- (hífen) faixa de valor
/ (barra) valor da etapa

Veja o gif abaixo todas as demais opções:

Após criar a expressão desejada a Plataforma Lecom irá validar. Caso não seja válida o cabeçalho ficará em vermelho com a seguinte mensagem: “ A expressão cron é inválida”. Observe a imagem abaixo:

Observe que há uma Lista de exemplos disponíveis no lado esquerdo. Ao clicar nesta lista será exibida uma caixa, conforme imagem abaixo:

Caso deseje aplicar um exemplo basta clicar sobre a possibilidade de Simples ou Avançado e o formulário será preenchido automaticamente.

Após realizar todos os passos acima, clique em Salvar, será exibida a mensagem “Aguarde um momento, o repositório está sendo criado”. Caso o repositório já exista será rápido, caso contrário a ação de salvar exigirá mais tempo.

Quando o processamento for concluído será exibida uma mensagem no canto esquerdo da tela:

Ao salvar o nome do repositório será exibido as seguintes funcionalidades serão liberadas:

a) Forçar execução

b) Repositório: É possível verificar o Repositório

c) Pipelines: É possível acessar as Pipelines

d) Publicar: Publicar o robô.

Após clicar em publicar, será exibido a seguinte mensagem “Esta operação implicará na publicação de todos os recursos no servidor, eliminando os recursos já publicados no ambiente”. Após ler está mensagem, você poderá cancelar ou publicar o robô.

Após clicar em Publicar, será aberta a tela da Pipeline e o seguinte fluxo automático será realizado: gerar build, deploy e notify.

GERAR O BUILD

REALIZAR O DEPLOY

NOTIFY

(COMUNICAR A PLATAFORMA LECOM)

Para acompanhar o fluxo de publicação basta clicar nos botões abaixo:

A partir desses passos, a Plataforma Lecom retorna ao formulário do robô, no qual o botão de Publicar ficará no modo “loading” para que todas as modificações estejam prontas. Nesse momento, o status da publicação ficará como pendente:

Com o término da publicação do robô aparecerá uma mensagem no canto inferior esquerdo da tela “Publicado com sucesso”. Será alterado o status para Publicado com sucesso e aparecerão a data da publicação, bem como o login de quem o publicou.

Os campos Data da publicação e Status da publicação contam com item de ajuda:

Data da publicação: Data referente a última publicação efetuada com sucesso.
Status da publicação: Status referente a última tentativa de publicação. Para mais informações consulte a Pipeline.

Para iniciar a execução do robô, ele deverá ter sido publicado com sucesso ao menos uma vez. Observe o botão Ativo, que segue desativado e apresenta um botão de ajuda, com a seguinte mensagem: “O robô não poderá ser ativado, ao menos que tenha sido publicado com sucesso ao menos uma vez”.

Lembre-se o robô somente será executada na publicação que tenha atingido o status de sucesso. Caso ocorra uma alteração, mas a publicação não tenha tido sucesso, o robô operará somente na publicação anterior.

Com o robô publicado ao menos uma vez com sucesso, habilite o botão Ativo. Será exibida a seguinte mensagem: “Salvando as informações, aguarde um momento”

Em seguida aparecerá no canto inferior esquerdo da tela a mensagem “Salvo com sucesso”

Para verificar se o robô está operando, basta ir a guia Robô:

Será exibido um painel com a listagem de todos os robôs existentes e com as seguintes informações:

a) Barra de pesquisa

b) Atualizar

c) Modo de exibição

a. Ajustar janela

b. 1 card por linha

c. 2 cards por linha

d. 3 cards por linha

e. 4 cards por linha

d) Modo tela cheia

e) Selecionar todos os cards

f) Parar: Parar agendamento do robô) acho que ficou estranho de vez

Observe que no card do robô há um botão de reticências indicando um menu. Ao clicar nesse sinal serão exibidas as opções Editar e Download logs.

Você pode editar a qualquer momento o nome do robô, nível de log e tempo de execução. Atente-se que há campos que não podem ser editados, são eles:

Identificador
Repositório
Data de publicação
Publicado por
Status da publicação

Ao selecionar um card, novas funcionalidades serão exibidas:

a) Mostrar detalhes

b) Esconder detalhes

c) Ativar selecionados

d) Inativar selecionados

Os detalhes de cada card poderão ser exibidos ao clicar em Detalhes:

No painel Histórico você terá acesso há várias informações dos Robôs e dos Executores. Para selecionar o Robô ou Executor, clique na barra, conforme indicado na imagem abaixo:

Ao selecionar o item Executor, você terá acesso ao painel abaixo:

a) Filtrar por: Executor

b) Eventos:

I. Alto consumo de CPU

II. Alto consumo de disco

III. Alto consumo de memória

IV. Consumo de CPU normalizado

V. Consumo de memória normalizado

VI. Desligado com sucesso

VII. Desligando

VIII. Erro inesperado

IX. Iniciado com sucesso

X. Iniciando

XI. Pausado

XII. Reinicialização do executor inesperada

c) Período:

a. Ontem

b. Hoje

c. Semana atual

d. Semana anterior

e. Mês atual

f. Mês anterior

g. Últimos três meses

Há também o período específico, que ao selecionar abre uma janela para que seja indicado a data inicial e a data final da pesquisa desejada:

Depois basta selecionar a opção Filtrar e os resultados serão demonstrados no painel.

Ao selecionar o Robô, serão exibidas as informações abaixo:

a) Data e hora

b) Nome

c) Executor

d) Tempo de execução

e) Status

f) Nível de log:

a. Fatal

b. Error

c. Warn

d. Info

e. Debug

f. Trace

É possível aplicar os seguintes filtros para localizar um robô:

a) Filtrar por: Robô

b) Status:

a. Disparado

b. Erro

c. Falha no disparo

d. Ignorado

e. Iniciado

f. Interrompido

g. Sucesso