KCS - Caminho Logs do Agente

Caminho Logs do Agente e Soluções Comuns

🕒 Tempo aproximado para leitura: 00:02:30 min

---

❓ Dúvida:

Como acessar os logs do agente TiFlux em diferentes sistemas operacionais? E quais são as soluções para problemas comuns como “Socket Error”, “Tela Preta”, “Instalação VNC pendente”, “Instalação Splashtop pendente” e “Print Screen recebido”?

---

🔎 Causa:

Os logs do agente são essenciais para diagnóstico de falhas no funcionamento do agente remoto. Problemas como bloqueio de rede, conflitos de drivers gráficos, serviços não iniciados ou instalações pendentes são causas frequentes de erros reportados pelos usuários.

---

✅ Solução:

📍 Caminhos dos Logs por Sistema Operacional

• Windows: C:\ProgramData\tiflux

Ou baixe o arquivo zipado, descompacte e execute como administrador em seu ambiente, ele ira salvar os logs e abrira a pasta onde ficara o arquivo compactado para nos enviar.

@echo off
title Backup TiFlux + TiPeerToPeer
color 07

set "DEST=C:\temp"
set "ZIP_FILE=%DEST%\Backup_Agente_e_P2P_%date:~-4%-%date:~3,2%-%date:~0,2%.zip"

:: Cria a pasta C:\temp se não existir
if not exist "%DEST%" mkdir "%DEST%"

:: Define os caminhos das pastas a serem copiadas
set "PASTA1=%ProgramData%\TiFlux"
set "PASTA2=%AppData%\TiPeerToPeer"

:: Cria uma pasta temporária para juntar os conteúdos
set "TEMP_DIR=%TEMP%\Backup_TiFlux_P2P_Temp"

if exist "%TEMP_DIR%" rd /s /q "%TEMP_DIR%"
mkdir "%TEMP_DIR%"

:: Copia as pastas (se existirem)
if exist "%PASTA1%" (
    echo Copiando %PASTA1%...
    xcopy "%PASTA1%" "%TEMP_DIR%\TiFlux\" /E /I /Q /Y >nul
)

if exist "%PASTA2%" (
    echo Copiando %PASTA2%...
    xcopy "%PASTA2%" "%TEMP_DIR%\TiPeerToPeer\" /E /I /Q /Y >nul
)

:: Verifica se há algo para compactar
if not exist "%TEMP_DIR%\*" (
    echo Nenhuma das pastas foi encontrada para backup.
    timeout /t 3 >nul
    goto :cleanup
)

:: Compacta usando PowerShell
echo Compactando arquivos...
powershell -Command "Compress-Archive -Path '%TEMP_DIR%\*' -DestinationPath '%ZIP_FILE%' -Force"

if exist "%ZIP_FILE%" (
    echo Backup criado com sucesso: %ZIP_FILE%
) else (
    echo ERRO: Nao foi possivel criar o arquivo ZIP.
    timeout /t 3 >nul
    goto :cleanup
)

:: Abre a pasta C:\temp
explorer "%DEST%"

:cleanup
:: Limpa pasta temporária
if exist "%TEMP_DIR%" rd /s /q "%TEMP_DIR%"

:: Fecha o console

846B

Coleta Logs Windows.zip

archive

Abrir

• Linux: /opt/tiflux/logs/tiflux-agent.log

• Mac: /Users/Shared/tiflux/logs/tiflux-agent.log

💡 Verifique sempre os logs após um erro para identificar mensagens específicas que ajudem no diagnóstico.

---

⚠️ [LOG] SOCKET ERROR

Causa: Geralmente causado por bloqueios de rede — proxy, firewall do antivírus ou firewall do Windows.

Solução:

1. Verifique se o proxy está configurado corretamente.

2. Desative temporariamente o firewall do antivírus e do Windows para testar.

3. Adicione exceções para o processo tiflux-agent.exe (Windows) ou tiflux-agent (Linux/Mac).

4. Adicione exceções para o diretorio C:\Programs Files (x86)\Tiflux

Para mais Liberações, verifique neste Guia de Uso "Pré-requisitos para a instalação"

⚠️ [Tela Preta]

Causa: Ocorre quando o computador possui duas placas de vídeo e o sistema não consegue espelhar a tela corretamente.

Solução:

• Instale o Mirror Driver do VNC, disponível no diretório: dependencies/vnc (dentro da pasta de instalação do agente).

✅ Isso permite que o agente capture a tela corretamente mesmo em configurações multiplaca.

---

⚠️ [Instalação VNC pendente]

➤ Windows

• O serviço uvnc_service é iniciado apenas durante a conexão remota.

• Passos:

  1. Verifique se já existe outro VNC instalado no sistema.

  2. Confira se o serviço uvnc_service está presente (via Gerenciador de Serviços).

  3. No painel TiFlux → Dashboard do equipamento → Inventário → Forçar atualização.

  4. Caminho do executável: C:\Arquivos de Programas (x86)\tiflux\dependencies

➤ Mac / Linux

• Execute no terminal:

  sudo apt install x11vnc

• Depois, no painel TiFlux → Dashboard → Inventário → Forçar atualização.

---

⚠️ [Instalação Splashtop pendente]

Causa: O agente inicia a instalação em segundo plano ao clicar em “Acesso remoto Splashtop”, mesmo que apareça erro inicial.

Solução:

1. Clique em “Acesso remoto Splashtop” no dashboard do equipamento.

2. Aguarde até 5 minutos (geralmente conclui em 2 minutos).

3. Atualize a página para verificar disponibilidade.

🔍 Para confirmar conectividade, verifique as portas do Splashtop:

• Acesse: https://www.splashtop.com/check

Check Connectivity to Splashtop ServersSplashtop Inc.

---

⚠️ [SOCKET] RECEBIDO print_screen

Funcionalidade: O sistema captura automaticamente uma imagem da tela do computador toda vez que você acessa Recursos → Dashboard. A imagem é atualizada a cada 5 minutos ou ao clicar na miniatura.

Personalização:

• Para desativar essa função: Vá em Configurações do Agente Remoto → Desativar "Captura de Tela".

🖼️ As imagens são úteis para visualizar o estado do equipamento sem conectar remotamente.

---

⚠️ Se o problema persistir após seguir os passos acima, colete os logs do agente e envie para o suporte técnico com descrição detalhada do erro.