Windows
FlexxAgent suporta sistemas operacionais Windows de 64 bits, não é possível instalá-lo em sistemas de 32 bits. O binário de instalação está disponível com ou sem interface gráfica, tornando-o compatível tanto com métodos de implantação desatendida quanto com a instalação através de assistente.

Arquitetura do serviço
FlexxAgent é composto por um serviço do Windows chamado FlexxAgent Service, que coordena dois processos:
- FlexxAgent, executado ao nível do sistema
- FlexxAgent Analyzer, iniciado para cada sessão de usuário.
Essa arquitetura permite que o FlexxAgent gerencie dispositivos com múltiplas sessões (como servidores de terminal, Citrix ou AVD) e obtenha métricas detalhadas para melhorar as capacidades de diagnóstico.
Exemplo:
- Em um laptop, são executados FlexxAgent (ao nível do sistema) e FlexxAgent Analyzer (sob a identidade do usuário).
- Em um dispositivo com múltiplas sessões, além do FlexxAgent, será executado um processo FlexxAgent Analyzer por sessão.
Consumos
FlexxAgent está otimizado para minimizar o uso de recursos. Os valores aproximados são:
- Espaço em disco: < 200 MB
- CPU: < 0.5%
- RAM: 100-200 MB
Processo FlexxAgent (sistema)
- Recolha de informação de desempenho, hardware, sessões, perfis, discos, partições e serviços do Windows: a cada 60 segundos.
- Envio de eventos de erro do log de eventos: a cada 10 minutos.
- Atualização de informações de perfis de usuário: a cada 15 minutos.
Processo FlexxAgent Analyzer (usuário)
- Analisa o uso de aplicativos, dados de diagnóstico e experiência do usuário.
- Recolha local de dados: a cada 15 segundos.
- Envio de relatórios ao serviço: a cada 5 minutos (essa métrica pode mudar em funcionalidades específicas).
Versões suportadas
FlexxAgent é compatível com os sistemas operacionais Windows atualmente em ciclo de suporte pela Microsoft. Embora possa ser instalado em versões sem suporte, algumas funcionalidades podem não estar disponíveis.
Compatibilidade completa
- Microsoft Windows 10 ou posterior
- Microsoft Windows Server 2016 ou posterior
Compatibilidade limitada
- Windows 7 SP1
- Windows 8.1 SP1
- Windows Server 2008 R2 SP1
- Windows Server 2012
Requisitos de software
FlexxAgent requer os seguintes componentes:
- .NET Framework 4.6.2 ou posterior (recomendado: .NET Framework 4.8).
- Windows PowerShell 4.0 ou posterior (recomendado PowerShell 5.1).
- Nota: A política de execução do Azure PowerShell deve ser definida como Sem restrições.
Considerações para versões do Windows em EOL
Em sistemas fora de suporte (EOL), o FlexxAgent pode apresentar limitações ou falta de compatibilidade com determinadas funcionalidades.
Funcionalidades não suportadas
Ao usar o FlexxAgent em sistemas operacionais Windows antigos que estão fora de suporte, as seguintes funcionalidades não são admitidas:
- Coleta de métricas de consumo de GPU.
- Execução de fluxos.
- Execução de microsserviços pelo usuário final.
- Obtenção de informações das unidades de armazenamento.
- No caso de dispositivos virtuais, detecção de broker e hipervisor (limitada conforme o fornecedor).
- User Input Delay (UID) (disponível apenas a partir do Windows Server 2019 e Windows 10 versão 1809).
A detecção de intermediários pode não funcionar para todos. Não há dados de desempenho de atraso de entrada do usuário, já que este contador não existe no Windows 7 ou Windows Server 2008 R2.
Windows 7 e 2008 R2
FlexxAgent pode ser instalado em Windows 7 x64 ou Windows Server 2008 R2 SP1 sob as seguintes condições:
- Instalar a atualização KB4474419: (atualização de suporte à assinatura de código SHA-2 para Windows Server 2008 R2, Windows 7 e Windows Server 2008: 23 de setembro de 2019).
- Instalar a atualização KB3140245: (Atualização para habilitar TLS 1.1 e TLS 1.2 como protocolos seguros padrão no WinHTTP no Windows) e seguir as instruções da seção Como habilitar TLS 1.1 e TLS 1.2 como protocolos seguros padrão no WinHTTP no Windows na página de suporte da Microsoft.
- Requer pelo menos .NET Framework 4.6 (recomendado: 4.8).
- PowerShell 2.0 com Windows 7 não é compatível com TLS 1.2; instalar Windows Management Framework 5.1, que inclui PowerShell 5.1.
Windows 8 e 2012
A instalação do FlexxAgent suporta Windows 8 sob as seguintes condições:
- Requer .NET Framework 4.6.2 (A Microsoft bloqueia a instalação de versões posteriores no Windows 8.0).
- Todas as atualizações de segurança do Windows devem ser aplicadas para garantir a compatibilidade com TLS 1.2 e a assinatura de código SHA-2.
Descarga
O download do binário de instalação para FXXOne está disponível com interface gráfica e sem ela.
DOWNLOAD DO BINÁRIO DE INSTALAÇÃO COM INTERFACE GRÁFICA
BOTÃO PARA BAIXAR FLEXXAGENT
Em Portal -> Início, o botão Baixar o agente permitirá baixar o FlexxAgent no dispositivo. Esta opção está disponível para todos os usuários Administrador de organização de qualquer tipo de organização.
Se a organização tiver mais de um grupo de relatórios, ao clicar no botão Baixar o agente a interface mudará para a seção Grupos de relatórios para baixar o FlexxAgent no grupo de relatórios escolhido.

Alguns segundos após finalizar a instalação, o dispositivo ficará visível no módulo Workspaces. A partir desse momento, todas as funcionalidades para controlar, monitorar e automatizar tarefas em seus dispositivos serão ativadas.
BOTÃO PARA GERAR UM LINK MÁGICO
O botão Gerar link mágico otimiza o acesso ao download do FlexxAgent nos dispositivos. Permite aos usuários com o papel de Administrador da organização dentro de uma organização do tipo sócio gerar e enviar um link aos usuários para que possam baixar o agente em seus dispositivos sem estar logados.
Criar um link mágico
O botão Gerar um link mágico está localizado na página inicial do Portal dos usuários com função Administrador de organização dentro de uma organização de tipo parceiro.

Ao clicar no botão, um formulário se abre para indicar a qual grupo de relatório o link será atribuído e por quanto tempo estará ativo.

Em seguida, uma janela indicará que o link foi criado. E permitirá copiá-lo diretamente para poder compartilhá-lo.

Ao clicar em Aceitar, a console automaticamente irá para a visualização de detalhes do grupo de relatórios escolhido. A partir daí, será possível consultar o link mágico que acabou de ser criado, assim como outros que foram criados anteriormente.

Utilizar um link mágico
Para utilizar o link, basta copiá-lo e colá-lo na barra de endereço do navegador. Nesse momento, FlexxAgent mostrará a seguinte tela, indicando que foi baixado no dispositivo.

Revogar um link mágico
Você pode revogar um Link mágico em Portal -> Configurações -> Grupos de relatório. Na visualização da lista, clique no grupo de relatórios onde está o Link mágico que se deseja revogar. E, em seguida, na coluna Ação da tabela, escolha a opção Revogar.
Uma janela aparecerá para confirmar a ação.

Ao clicar em Aceitar, na tabela do grupo de relatórios aparecerá por alguns segundos uma mensagem informando sobre a ação: "O link mágico foi revogado com sucesso".
Não é possível reutilizar um Link mágico que foi revogado ou que expirou.
BINÁRIO SEM INTERFACE GRÁFICA
Passos para realizar o download:
-
Acessar
Workspaces->Nível 2->Grupos de relatórios. -
Em vista de lista, selecionar o grupo de relatório sobre o qual deseja baixar o agente e clicar em
Baixar FlexxAgent.

- Uma janela será aberta com a opção
Gerar instalador autônomo (offline), para baixar o instalador do FlexxAgent:

-
Se a opção for selecionada: durante a instalação, o binário não exigirá acesso à internet para a verificação ou download de binários.
-
Se não for selecionada: será baixado o pacote de instalação mínimo, que acessará a internet para obter os binários mais recentes.
Implantação autônoma
FlexxAgent suporta implantação desatendida via GPOs, Intune, SCCM, ou outras ferramentas de distribuição.
Instalação
A instalação do FlexxAgent de forma desatendida é realizada através do PowerShell.
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "<agregar parámetro>" -WindowStyle Hidden -Wait
Parâmetros compatíveis
| Parâmetro | Cara | Descrição | |
|---|---|---|---|
| proxyAbsoluteUri | [string] | URL e porta do proxy. | |
| proxyUser | [string] | Usuário para proxy autenticado. | |
| proxyPass | [string] | Senha para proxy autenticado. | |
| proxyPersistConfig | [switch] | Se especificado, a configuração é mantida no registro. | |
| configFilePath | [string] | Diretório alternativo para o arquivo FlexxAgent-Configuration.conf. | |
| DebugMode | [switch] | Quando especificado, ele cria um arquivo de texto na mesma pasta com a transcrição da execução do script. | |
| RepairAgent | [bool] | Remove a configuração pré-existente do FlexxAgent quando reinstalado em um dispositivo. | |
| Help | [switch] | Lista os parâmetros suportados, com tipo e descrição. |
Desinstalar
Para desinstalar o FlexxAgent de forma desatendida:
"C:\Program Files\Flexxible\FlexxAgent\VDIServiceUpdater.exe" /Uninstall "C:\Program Files\Flexxible\FlexxAgent\FlexxAgent.exe" /quiet
O instalador do Windows não remove todos os arquivos, pastas, chaves ou valores de registro criados durante a instalação. Para uma imagem limpa do sistema, você pode remover manualmente:
Arquivos
C:\Windows\Prefetch\FLEXXAGENT.EXE-XXXXXXXX.pf– onde XXXXXXXX é uma sequência de letras e númerosC:\Windows\Temp\FlexxAgentInstallation.log
Pastas
C:\Program Files\FlexxibleC:\ProgramData\Flexxible
Reinstalação
Para reinstalar o FlexxAgent em um dispositivo removendo sua configuração prévia, deve-se executar:
FlexxAgent-Installer.exe -repairAgent
Por exemplo:
Start-Process "<ruta>\FlexxAgent-Installer.exe" -ArgumentList "-repairAgent true" -WindowStyle Hidden -Wait
Proteção contra a desinstalação
Esta funcionalidade impede que um usuário desinstale o FlexxAgent. A configuração pode ser aplicada a nível de Produto ou Grupo de relatório.
Requisitos
- A configuração somente pode ser feita por um usuário com o papel de Administrador de organização.
- Versão mínima do FlexxAgent: 25.4.2.
Esta funcionalidade está desativada por padrão.
Configuração a nível de Produto
- Acessar
Portal->Configuração->Organização. - No menu, selecionar a aba
Produtos. - Na tabela, escolher o ambiente sobre o qual se deseja executar a funcionalidade, e no campo
Açãoclicar emConfiguração do agente. - No formulário, habilitar ou desabilitar o botão
Proteção de desinstalação. - Clicar em
Salvar.
Configuração a nível de Grupos de relatório
A execução da funcionalidade pode ser feita sobre um ou vários grupos de relatório.
Habilitar a proteção a um grupo de relatório
- Acessar
Portal->Configuração->Grupos de relatório. - Na tabela, escolher o grupo de relatório sobre o qual se deseja executar a funcionalidade, e no campo
Açãoclicar emConfiguração do agente. - No formulário, edite a funcionalidade
Proteção de desinstalação(botão em forma de lápis) para poder escolher entre habilitá-la ou desabilitá-la. - Clicar em
Salvar.
Os grupos de relatório herdam a configuração feita a nível de Produto; no entanto, podem sobrescrever sua própria configuração.

Habilitar a proteção a vários grupos de relatório
- Acessar
Portal->Configuração->Grupos de relatório. - Na tabela, selecionar os grupos de relatório sobre os quais se deseja executar a funcionalidade.
- Clicar em
Editar proteção de desinstalação. Serão apresentadas três opções:
- Habilitar proteção de desinstalação. Protege os grupos de relatório contra a desinstalação do FlexxAgent (esta opção não estará disponível se a funcionalidade já estiver habilitada no Produto).
- Desabilitar proteção de desinstalação. Permite aos usuários desinstalar o FlexxAgent (esta opção não estará disponível se a funcionalidade já estiver desabilitada no Produto).
- Restabelecer proteção de desinstalação. Aplica a configuração que o Produto ao qual o grupo de relatório pertence, seja habilitada ou desabilitada.

Um dispositivo terá a Proteção contra a desinstalação do FlexxAgent habilitada nos seguintes casos:
- A funcionalidade está habilitada no grupo de relatório ao qual pertence.
- A funcionalidade está desativada no grupo de relatório (não está habilitada nem desabilitada), mas está habilitada a nível Produto.
Formas de desinstalar o FlexxAgent com a proteção habilitada
Se um usuário tiver a funcionalidade habilitada, mas precisar desinstalar o FlexxAgent, terá duas opções:
- Mover o dispositivo para um grupo de relatório que não tenha a proteção habilitada.
- Através de um token:
- Ir para
Portal->Workspacese selecionar o dispositivo. - Execute a ação
Reveal uninstall tokenque mostrará um token único para esse dispositivo, válido até as 23:59:59 UTC do dia seguinte. - Vá para o Painel de Controle do Windows e desinstale o FlexxAgent inserindo o token.

Antes de gerenciar a desinstalação do FlexxAgent através de ferramentas como Intune ou scripts próprios, os dispositivos desejados devem ser movidos para um grupo de relatório que não tenha proteção habilitada.
A Flexxible recomenda ter um grupo de relatório com a Proteção contra desinstalação desabilitada para facilitar tarefas de desinstalação do FlexxAgent nos dispositivos.
Problemas conhecidos
Instalação do FlexxAgent
Problema 1 - Instrumentação de Gerenciamento do Windows (WMI)
Se o dispositivo tiver problemas gerados pelo serviço Windows Management Instrumentation (WMI) durante a instalação ou reinstalação, é possível que o processo relate esses erros na janela do CMD:

Solução
Executar os seguintes comandos:
Stop-Service winmgmt -Force
winmgmt /resetrepository
Start-Service winmgmt
Problema 2 - Restrição de processos PowerShell
Algumas soluções de segurança não permitem que a instalação e/ou autoatualização do FlexxAgent seja realizada de forma eficaz. O instalador pode devolver a mensagem:
O processo foi terminado com erros. Uma instalação corrompida foi detectada devido a processos externos. Isso geralmente é causado pela atividade do antivírus. Por favor, verifique as configurações do seu antivírus.
Solução
Excluir os seguintes arquivos:
C:\Windows\Temp\FlexxibleIT
C:\Windows\Temp\UpdateFlexxAgent.ps1
Desinstalação do FlexxAgent
Problema - FlexxAgent continua na lista de serviços
Pode acontecer que o FlexxAgent continue aparecendo na lista de serviços, mesmo que tenha sido desinstalado e todos os arquivos tenham sido apagados. Isso provocaria a impossibilidade de reinstalação.
Solução
Executar como administrador o seguinte comando na janela de CMD:
sc delete "FlexxAgent service"
Em seguida, reiniciar o dispositivo.
Configuração de proxy
FlexxAgent suporta proxies configurados de forma transparente a nível do sistema, com ou sem autenticação. A configuração do proxy pode ser realizada por linha de comando ou mediante a modificação de chaves de registro.
Configuração de proxy mediante linha de comando
Instalação com parâmetros:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyPersistConfig:$True
Onde ip.ad.dre.ss:port corresponde ao IP ou DNS e a porta do proxy.
Ou incluindo credenciais:
FlexxAgent-Installer.exe -proxyAbsoluteUri ip.ad.dre.ss:port -proxyUser ProxyUserName -proxyPass ProxyUserPassword -proxyPersistConfig:$True
Pode ser que o FlexxAgent não tenha acesso ao proxy configurado se estiver fora da rede corporativa. Para determinar a acessibilidade, o FlexxAgent tenta resolver o registro DNS e faz uma solicitação TCP para a porta correspondente. Se o proxy não for acessível, o FlexxAgent reportará diretamente (sem proxy).
Configuração de proxy mediante chaves de registro
As chaves de registro que armazenam a configuração do proxy estão em:
'Equipe\HKEY_LOCAL_MACHINE\SOFTWARE\Políticas\Flexxible\FlexxAgent\Comunicações'
Chaves do Registro relacionadas às configurações de proxy:
Chave Proxy_URL
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_URL
- Tipo: REG_SZ
- Valores suportados: a URL e a porta; por exemplo, 'http://192.168.1.1:3128' ou 'https://192.168.1.1:3128'
Chave Proxy_User
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_User
- Tipo: REG_SZ
- Valores suportados: o nome de usuário para autenticar no proxy; por exemplo, 'Administrador'. Ele pode ser ignorado para proxies não autenticados.
Chave Proxy_Pwd
- Caminho:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Flexxible\FlexxAgent\Communications - Nome: Chave Proxy_Pwd
- Tipo: REG_SZ
- Valores suportados: A senha para autenticar no proxy. Ele pode ser ignorado para proxies não autenticados.
O valor da chave Proxy_Pwd pode ser definido como texto sem formatação (não recomendado) ou codificado em base64 e delimitado por "&&&".
Por exemplo: '&&&VGhpc0lzTjArQCQzY3VyZVBAJCR3MHJk&&&' para o valor "Proxy_Pwd".
Em qualquer dos casos, o FlexxAgent cifra o valor assim que é iniciado ou tenta transmitir informações. Você pode gerar uma cadeia codificada em Base64 a partir de https://www.base64encode.org/.
Como o FlexxAgent desencadeia um processo a nível do sistema (FlexxAgent.exe) e outro a nível de sessão (FlexxAgent Analyzer.exe), pode ser necessário definir tipos de proxy diferentes para cada um, dependendo de como o proxy atua em um nível ou outro.
Isso pode ser feito nas Configurações do FlexxAgent, em Produtos.
Atualização manual
Para atualizar o FlexxAgent manualmente:
- Acesse
Workspaces->Nível 1->Workspaces->Operações->FlexxAgent->Atualizar FlexxAgent.

-
As versões instaladas podem ser consultadas em
Meus filtros->Filtros predefinidos->Resumo de versões do FlexxAgent. Isso mostrará uma visão de todos os dispositivos agrupados por versão. -
Uma vez executada a operação de atualização, será gerado um trabalho com todos os detalhes da operação.
Logs
Os logs fornecem informações e permitem diagnosticar problemas durante a instalação.
Logs de instalação e atualização
Localização:
%LOCALAPPDATA%\Flexxible
Contém informações sobre o processo de instalação ou atualização, dependências e detalhes do processo.
Logs de FlexxAgent Analyzer
Localização:
%LOCALAPPDATA%\FAAgent\Logs
Podem ser configurados para incluir ou não informações por níveis de criticidade.
Do Workspaces, o nível de log pode ser modificado para um ou vários dispositivos através das opções disponíveis no botão Operações.

Logs de serviço do FlexxAgent
Disponíveis no Visor de eventos do Windows, no ramo Aplicação.

Status de Saúde do FlexxAgent
O processo de Status de Saúde do FlexxAgent é executado periodicamente (a cada hora) com o objetivo de avaliar se o FlexxAgent funciona corretamente. Para isso, realiza a verificação do seu heartbeat e analisa várias métricas internas que permitem determinar se opera de maneira adequada ou se é necessário iniciar um processo de recuperação.
Durante essa avaliação, não são considerados fatores externos que possam afetar a comunicação do agente, como:
- A conectividade do dispositivo nesse momento (pode ter ou não conexão WiFi ou Ethernet).
- A interferência de um firewall ou proxy na comunicação.
Por outro lado, são considerados os seguintes aspectos:
- Que o serviço esteja iniciado.
- Que o serviço não esteja desativado; se estiver, interpreta-se que um administrador decidiu realizar essa ação.
Verificação do processo de autorreparo do FlexxAgent
A autorreparo do FlexxAgent pode ser confirmada das seguintes maneiras:
-
Através da coluna
Último autorreparo:- Acessar o módulo
Workspaces->Nível 1->Workspaces. - Na tabela, consultar a coluna
Último autorreparo. Se não for visível, utilizar o Seletor de colunas para adicioná-la.

- Acessar o módulo
-
FlexxAgent deixa rastros no log de eventos com as seguintes entradas:
- Fonte: Serviço FlexxAgent
- Nome do log: Aplicação
- Evento 1001 Verificando saúde do FlexxAgent /
<servicename>está em execução. Nenhuma ação necessária- Evento 1002 Serviço desabilitado. Nenhuma ação necessária / Backup não encontrado.
<serviceName>não recuperável- Evento 1003 Serviço
<serviceName>restaurado do backup anterior / Erro<message>encontrado ao iniciar<serviceName>com backup restaurado- Evento 1004 Serviço falhou ao iniciar e será reparado
- Evento 1005 Serviço não relatou por um longo tempo e será reparado
- Evento 1006 Serviço foi iniciado
- Evento 1007 Erro encontrado ao reiniciar o serviço após não relatar por muito tempo