Logs de cliente para registro de erros
NCache fornece registro para o aplicativo cliente e no nível do soquete. O registro em log está desabilitado por padrão, mas pode ser habilitado especificando as configurações de log por meio da API no arquivo NCache aplicação ou NCache arquivo de configuração cliente.ncconf
Esses logs contêm informações sobre operações do cliente e dados de uso de operações propagadas por meio do servidor de soquete para se comunicar com o servidor remoto. Esses logs são criados no local padrão onde NCache registros são salvos.
Para habilitar os logs do cliente programaticamente para um cache, NCache fornece CacheConnectionOptions. Você pode especificar ainda mais o nível de log para logs de cliente, conforme explicado abaixo.
Considerações Especiais
If cliente.ncconf arquivo contém o
enable-client-log
valores e o usuário os passaCacheConnectionOptions
também, os valores passados porCacheConnectionOptions
serão de alta prioridade e serão usados.Se um dos valores (HabilitarClientLogs or Nível de registro) passa por
CacheConnectionOptions
e ambos são definidos no cliente.ncconf, ele lerá aquele fornecido emCacheConnectionOptions
e o que não constaCacheConnectionOptions
, a partir de cliente.ncconf.
Por exemplo, se os logs do cliente forem ativados usando CacheConnectionOptions
e LogLevel
não for especificado, ele habilitará os logs do cliente independentemente do valor em cliente.ncconf e usar o valor de log-level
da cliente.ncconf uma vez que não é fornecido através CacheConnectionOptions
.
- Se nenhum valor for passado em
CacheConnectionOptions
, ele lerá os valores de cliente.ncconf.
Pré-requisitos
- Para aprender sobre os pré-requisitos padrão necessários para trabalhar com todos os NCache recursos do lado do cliente, consulte a página fornecida em Pré-requisitos da API do lado do cliente.
- Para obter detalhes da API, consulte: ICache, CacheManager, Obter Cache, CacheConnectionOptions, HabilitarClientLogs, Nível de registro.
Registro de erro da API usando opções de conexão
Neste exemplo, se algum valor já estiver presente em cliente.config eles serão sobrescritos e os valores fornecidos por meio CacheConnectionOptions será usada.
string cacheName = "demoCache";
var options = new CacheConnectionOptions();
// Enable client logs by setting the flag true
options.EnableClientLogs = true;
// Set the log level for client logging
options.LogLevel = LogLevel.Debug;
// Connect to the cache with CacheConnectionOptions
ICache cache = CacheManager.GetCache(cacheName, options);
Note
Para garantir que a operação seja à prova de falhas, é recomendável lidar com possíveis exceções em seu aplicativo, conforme explicado em Como lidar com falhas.
Erro ao registrar a partir da configuração do cliente
Se os logs do cliente não forem ativados por meio de CacheConnectionOptions
ele procurará o próximo valor possível, ou seja, o valor de enable-client-log
in cliente.ncconfe use-o. Caso seja falso, os logs não serão habilitados.
Note
Quando o Nível de registro não é especificado através do CacheConnectionOptions
então ele procurará o próximo valor possível, ou seja, o valor de log-level
no cliente.ncconf e use-o. Caso não seja mencionado ali, utilizará o valor padrão, ou seja, log-level = "error".
Note
If NCache está instalado, os logs do cliente são colocados em %NCHOME%/bin/log-files/ClientLogs. Caso contrário, eles são encontrados na pasta bin do aplicativo.
Tipos de registro
A seguir estão os tipos de registro:
INFO: O nível de informações descreve algumas informações úteis sobre qualquer operação executada no cache, como o início e a parada do log das operações de transferência de estado.
ERRO: Este sinalizador de log fornece a causa dos erros gerados durante a execução da operação. Esse log de status ajuda na maioria dos cenários de solução de problemas, como durante o início de uma exceção de cache que ocorre ao ingressar em sua própria réplica.
DEPURAR: Esta opção de log imprime informações detalhadas sobre quaisquer operações no cache, como informações sobre cada operação como uma chave e itens de cache durante a transferência de estado. Essas informações de log analisam os problemas de cache em detalhes sempre que a depuração normal não é possível. Mas isso causa degradação de desempenho para operações de cache.