Importante: Esse procedimento deve ser realizado apenas para diagnóstico. Após habilitar a trace, mantenha-a ativa por aproximadamente 1 dia (ou até que o problema ocorra novamente), envie os arquivos de log para análise e, em seguida, desative a configuração, pois o nível de detalhamento dos logs pode impactar o uso de espaço em disco.

Pré-requisito

Verifique se o ambiente está utilizando a versão:
ComunicadorDispositivos_V_27_0_0_1 (ou superior).

Observação:
 
A versão deve ser verificada diretamente no nome da pasta do ComunicadorDispositivos, conforme o exemplo abaixo:


 

1. Localize o arquivo de configuração

Localize o arquivo:
 

ComunicadorDispositivos.exe.config

Normalmente ele está na mesma pasta do executável do Comunicador, por exemplo:
 

C:\Program Files\NomeDoSistema\ComunicadorDispositivos\

2. Adicione a seção do log4net

Abra o arquivo .config e localize a seção:
 

<configSections>

Dentro dela, adicione a seguinte linha:
 

<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />

Importante: Essa configuração deve ficar dentro da tag <configSections> e antes da seção <log4net>.

3. Adicione a configuração da Trace

Logo após a seção <configSections>, insira o seguinte bloco:
 

<log4net><appender name="FrequenciaFileLog" type="log4net.Appender.RollingFileAppender"><file value="c:\FrequenciaLogs\ComunicadorDispositivos.log" /><appendToFile value="true" /><maximumFileSize value="10240KB" /><maxSizeRollBackups value="10" /><staticLogFileName value="true" /><layout type="log4net.Layout.PatternLayout"><conversionPattern value="[%date] %level - %message%newline" /></layout><lockingModel type="log4net.Appender.FileAppender+MinimalLock" /></appender><appender name="NHibernateFileLog" type="log4net.Appender.RollingFileAppender"><file value="c:\FrequenciaLogs\ComunicadorDispositivos.NHibernate.log" /><appendToFile value="true" /><maximumFileSize value="10240KB" /><maxSizeRollBackups value="20" /><layout type="log4net.Layout.PatternLayout"><conversionPattern value="[%date] %level - %message%newline" /></layout><lockingModel type="log4net.Appender.FileAppender+MinimalLock" /></appender><logger name="FrequenciaFileLog"><level value="ALL" /><appender-ref ref="FrequenciaFileLog" /></logger><logger name="NHibernate"><level value="ALL" /><appender-ref ref="NHibernateFileLog" /></logger></log4net>

4. Configure o diretório dos logs

Altere os caminhos definidos em:
 

<file value="..." />

para um diretório válido no servidor.
Exemplo:
 

<file value="D:\Logs\ComunicadorDispositivos.log" />

Importante: Certifique-se de que a pasta exista e que o serviço do Comunicador possua permissão de gravação nesse diretório.

5. Configure o nível de log

Para que todas as informações sejam registradas, utilize:
 

<level value="ALL" />

Outros níveis disponíveis:
 

• INFO
• DEBUG
• WARN
• ERROR
• FATAL

Para diagnóstico, recomenda-se utilizar ALL, pois registra todas as operações executadas pelo Comunicador.

6. Salve as alterações e reinicie o Comunicador

Após concluir as configurações:
 

1. Salve o arquivo .config;
2. Reinicie o serviço do Comunicador (ou o próprio sistema, se necessário).

As alterações só passam a valer após a reinicialização.
 

7. Aguarde a reprodução do problema

Após habilitar a trace:
 

• mantenha a configuração ativa por aproximadamente 1 dia (ou até que o comportamento seja reproduzido);
• utilize normalmente o sistema durante esse período.

Isso permitirá que todas as informações necessárias sejam registradas.
 

8. Envie os arquivos de log

Após o período de coleta:
 

1. Acesse a pasta configurada para os logs;
2. Localize os arquivos gerados, por exemplo:
   • ComunicadorDispositivos.log
   • ComunicadorDispositivos.NHibernate.log
3. Compacte os arquivos (ZIP ou RAR);
4. Encaminhe-os para análise junto ao chamado.

9. Desative a Trace

Após o envio dos logs, remova ou desabilite a configuração adicionada e reinicie novamente o Comunicador.
 

Importante: Não é recomendado manter a trace em nível ALL permanentemente, pois ela gera uma grande quantidade de informações e pode aumentar significativamente o consumo de espaço em disco.

Resultado esperado

Após a configuração, o Comunicador passará a registrar detalhadamente suas operações e possíveis falhas, facilitando a identificação de problemas relacionados à comunicação com coletores de ponto, integrações e acesso ao banco de dados.
 

Resumo do procedimento

1. Habilite a trace.
2. Reinicie o Comunicador.
3. Mantenha a coleta por aproximadamente 1 dia ou até reproduzir o problema.
4. Envie os arquivos de log para análise.
5. Desative a trace e reinicie novamente o Comunicador.