Runners

Ir para Runners

Os Runners são serviços iniciados em ambientes de execução que se conectam ao Orquestrador BotCity. Eles podem ser instalados em máquinas físicas, máquinas virtuais ou contêineres e têm a função de executar as tarefas de automação.

Ao acessar o menu lateral, você pode visualizar informações gerais sobre os ambientes de execução e acompanhar o processamento das tarefas.

Como funciona

O fluxo básico de um Runner, após o processo de instalação, é o seguinte:

1. Inicialização e autenticação com o Orquestrador BotCity
2. Identificação de tarefas pendentes
3. Download de robôs (na primeira execução ou quando há atualização)
4. Criação de ambientes isolados para cada automação (na primeira execução ou quando há atualização)
5. Instalação de dependências da automação (na primeira execução ou quando há atualização)
6. Execução da tarefa

Os Runners podem executar tarefas de diferentes tipos de automações, desde aquelas que exigem interação direta com a interface gráfica do usuário (como aplicações desktop, ERPs e sistemas operacionais), até automações que funcionam sem interface gráfica, como web headless, crawlers e integrações com APIs.

Paralelismo de execução

Cada Runner executa uma única tarefa por vez, mas você pode instalar diversos Runners no mesmo ambiente de execução, possibilitando o paralelismo de execução e maior vazão da fila de tarefas pendentes.

Alguns cuidados devem ser tomados ao alocar Runners em um mesmo ambiente:

• Automações que dependem de manipulação de recursos de tela não devem executar em paralelo, pois haverá concorrência pelos recursos, levando o processo à falha. O ideal é executar uma automação que utilize esse tipo de recurso em paralelo com automações em background.
• Não há limite de quantidade de Runners alocados em um único ambiente de execução, porém deve ser considerado o tipo de processo e os recursos disponíveis na máquina (RAM, CPU, etc.) para processar as tarefas em paralelo.

Criar Runner no Orquestrador

Ao acessar o menu lateral Runners, clique no botão + Novo Runner no canto superior direito e preencha as seguintes informações:

• Nome: Nome amigável para o Runner.
• Label: Identificador único do Runner.
• Acesso Remoto: opcional IP do ambiente onde foi instalado.

Finalize clicando no botão Criar no canto superior direito.

A próxima etapa é configurar o Runner no ambiente de execução.

Configurar Runner

A alocação e configuração do Runner deve ser feita diretamente nos ambientes de execução.

Veja mais em:

• Runner: Ambiente de execução

Iniciar Runner no Ambiente

Após a configuração ser concluída, você pode iniciar o serviço do Runner de diferentes formas:

• Interface gráfica
• Modo background
• Contêineres
• Session Manager

Visualização de Runners

Você pode organizar a visualização de Runners em dois formatos diferentes:

Cartões

Nesse formato, cada Runner é exibido em um cartão individual, mostrando informações essenciais como:

• Status:
  • Ativo
  • Inativo
• Label: Identificação do Runner como um link para acesso aos detalhes
• Previa de tela: Retorna a tela no ambiente onde foi instalado a cada 1 minuto (quando configurado e ativo)
• Botão de ações:
  • Info: Informações detalhadas sobre o Runner.
  • Logs: Rastreamento do log de execução das automações.
  • Screenshot: Baixa a captura de tela atual.
  • Editar: Atualiza as informações sobre esse Runner.
  • Deletar: Remove esta instância de Runner no Orquestrador BotCity.

Lista

Nesse formato, os Runners são exibidas em uma tabela, permitindo uma visão de informações por colunas:

• Screenshot: Retorna a tela no ambiente onde foi instalado a cada 1 minuto (quando configurado e ativo)
• Nome: Nome amigável de identificação do Runner como um link para acesso aos detalhes
• Label: Identificação única do Runner
• Status:
  • Ativo
  • Inativo
• Ultima atualização - Status: Data e hora da última comunicação do Runner com o Orquestrador.
• Botão de ações:
  • Info: Informações detalhadas sobre o Runner.
  • Logs: Rastreamento do log de execução das automações.
  • Screenshot: Baixa a captura de tela atual.
  • Editar: Atualiza as informações sobre esse Runner.
  • Deletar: Remove esta instância de Runner no Orquestrador BotCity.

Busca e filtros

É possível combinar vários filtros na parte superior do menu de Runners para fazer buscas conforme as suas necessidades.

Busca por:

• ID da máquina: Busca pelo identificador único do Runner.

Filtros disponíveis:

• Nome: Pesquisa e seleciona um ou mais Runners.
• Status: Seleciona o status do Runner Online | Offline

Ordenação:

• Ativos primeiro
• Inativos primeiro
• Mais recente primeiro
• Mais antigo primeiro

Detalhes do Runner

Você pode acessar detalhes do Runner separadas nas seguintes abas:

• Informações
• Tarefas Processadas
• Arquivo de Configuração
• Automações Associadas

Aba Informações

Informações Gerais do Runner

• Status: Indica o status atual do Runner, ou seja, se ele está online ou offline.
• Última Tarefa: ID da última tarefa executada.
• Tarefas Alocadas: Indica o número de automações alocadas neste Runner.
• CPU: Indica a utilização da CPU da máquina onde o Runner está alocado.
• Memória: Memória total da máquina em %.

Telemetria

Por padrão, as informações de telemetria não são coletadas pelo Runner. Caso você deseje que essas informações sejam enviadas para o Orquestrador, inclua uma configuração adicional.

No arquivo conf.bcf localizado na pasta conf do SDK, defina a configuração logTelemetry=true.

Você pode visualizar os parâmetros de configuração disponíveis em Personalizar a configuração do Runner.

Informações do Runner

• Label: Identificação do Runner.
• Nome: Nome do Runner.
• Acesso Remoto: Informação sobre o acesso remoto.
• Versão: Versão do Runner que está sendo utilizado.
• Versão do Java: Versão do Java instalada na máquina onde o Runner está alocado.
• Última Atualização de Telemetria: Data e hora da última atualização de telemetria.
• Tempo de Atividade do Runner: O tempo que o Runner ficou ou está ativo.

Informações do Sistema

• Nome do SO: Nome do sistema operacional da máquina onde o Runner está alocado.
• Versão do SO: Versão do sistema operacional da máquina onde o Runner está alocado.
• Arquitetura da CPU: Mostra a arquitetura da CPU.
• Uso da CPU: Indica a porcentagem de uso da CPU.
• Memória: Memória total do sistema.
• Memória Usada: Memória total em uso.
• Memória Livre: Memória total livre.

• Tempo de Atividade do Sistema: O tempo que o sistema está ativo.

• Gráfico - Tarefas por dia

Além de todas essas informações, você também pode acompanhar um gráfico das tarefas executadas pelo Runner em períodos específicos: última semana, últimos 15 dias e último mês.

Aba Tarefas Processadas

Mostra a lista de tarefas processadas apenas por esse Runner.

Aba Arquivo de Configuração

Mostra o conteúdo do arquivo conf.bcf, que define as configurações do Runner.

Aba Automações Associadas

Mostra a lista de todas as automações associadas a esse Runner.

Botão de Ações

Mostra as ações disponiveis para esse Runner.