Ir para o conteúdo

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.

Captura de tela do Orquestrador da BotCity, no menu Runners, apresentando uma visão geral dos ambientes de execução registrados no workspace.

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.

Diagrama ilustrando o fluxo de execução de um Runner no Orquestrador BotCity, desde a inicialização e autenticação até a execução da tarefa.

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:

Captura de tela do Orquestrador da BotCity, no menu Runners, apresentando o formulário de criação de um novo Runner com os campos Nome, Label e Acesso Remoto.

Iniciar Runner no Ambiente

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

Visualização de Runners

Nessa tela, você visualiza o resumo dos Runners nos seguintes cartões:

  • Total de Runners: quantidade total de Runners criados.
  • Runners Online: quantidade de Runners disponiveis para execução.
  • Runners Offline: quantidade de Runners indisponiveis para execução.

Você pode organizar a visualização dos Runners no formato de cartões ou lista.

Captura de tela do Orquestrador da BotCity, apresentando o menu Runners. A página tem o título 'Runners' e a descrição 'Configure Runners no seu ambiente de execução para executar as tarefas de automação', com o botão '+ Novo Runner' no canto superior direito. Abaixo, o campo de busca por Machine ID, os campos de filtro e ordenação, os botões de visualização em cartões ou lista e o botão Refresh. Em seguida, os cartões de resumo: Total de Runners, Runners Online e Runners Offline.

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.

Captura de tela do Orquestrador da BotCity, no menu Runners, apresentando um cartão de Runner com seu identificador, status de conexão indicado por um círculo colorido e a miniatura da captura de tela do ambiente de execução.

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.

Captura de tela do Orquestrador da BotCity, no menu Runners, apresentando o menu de opções do cartão de um Runner com as opções disponíveis: Info, Logs, Screenshot, Editar e Deletar.

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

Animação demonstrando o uso dos filtros disponíveis no menu Runners do Orquestrador BotCity, incluindo busca por ID do Runner, filtros por nome e status e Ordenação de itens.

Detalhes do Runner

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

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.

Captura de tela do Orquestrador da BotCity, na página de informações de um Runner específico, apresentando as seções de Informações Gerais, Informações do Runner, Informações do Sistema e o gráfico de tarefas executadas por período.

Aba Tarefas Processadas

Mostra a lista de tarefas processadas apenas por esse Runner.

Captura de tela do Orquestrador da BotCity, na página de informações de um Runner específico, apresentando a aba Tarefas Processadas com a lista de tarefas executadas pelo Runner.

Aba Arquivo de Configuração

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

Captura de tela do Orquestrador da BotCity, na página de informações de um Runner específico, apresentando a aba Arquivo de Configuração com o conteúdo do arquivo conf.bcf exibido.

Aba Automações Associadas

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

Captura de tela do Orquestrador da BotCity, na página de informações de um Runner específico, apresentando a aba Automações Associadas com a lista de automações vinculadas ao Runner.

Botão de Ações

Você pode acessar as ações disponiveis através do menu de ações na tela de Runners ou acessando os detalhes de um Runner e clicando no botão Ações.

As ações disponíveis são:

  • Info: Informações detalhadas sobre o Runner.
  • Logs: Acesso ao log detalhado de execução do Runner.
  • Screenshot: Baixa a captura de tela atual.
  • Editar: Atualiza as informações de Nome e Acesso remoto do Runner.
  • Excluir: Remove esta instância de Runner no Orquestrador BotCity.

Animação demonstrando o uso do botão de ações disponível na página de informações de um Runner no Orquestrador BotCity, com as opções: Info, Logs, Screenshot, Editar e Deletar.