Registro de API do lado do cliente
NCache O Client Side API Logging é um recurso de diagnóstico que registra todos NCache Chamadas de API feitas por um aplicativo. Este é um mecanismo de registro configurável que cria vários arquivos de registro. O objetivo do log da API é identificar qual API e suas sequências causam o problema para que o problema possa ser facilmente reproduzido pelo usuário. O log da API do cliente evita a sobrecarga apropriada do método chamado junto com a chave, o tamanho dos dados, o status do cache, a criptografia e as informações de compactação.
Aviso
O log da API tem um impacto no desempenho – é recomendado habilitar o log apenas para fins de diagnóstico.
O log é uma ferramenta importante que pode ser usada para manter um registro de todas as ocorrências que ocorrem em uma aplicação distribuída junto com seus respectivos carimbos de data/hora. NCache fornece apenas o recurso que pode ser usado para registrar chamadas de API no lado do cliente do aplicativo na forma de arquivos de log.
Este recurso pode ser ativado para criar um log detalhado e sequencial de NCache Chamadas de API feitas do lado do cliente. Esta é uma opção de alteração sem código e é habilitada simplesmente alterando as propriedades de configuração do seu projeto. As informações no arquivo de log podem ser usadas como um mecanismo de rastreamento para compreender e investigar situações problemáticas que possam surgir no lado do cliente NCache Chamadas de API.
Configurando a geração de registros de API do lado do cliente
Para ativar e configurar o log da API do lado do cliente, as propriedades a seguir precisam ser adicionadas ao arquivo de configuração do aplicativo, que pode ser App.config or web.config dependendo do seu tipo de aplicação. Essas configurações devem ser adicionadas sob o <configuration>
e os votos de <appSettings>
Tag. As propriedades a seguir precisam ser adicionadas para ativar o log de API para NCache Chamadas de API. Certifique-se de ter adicionado Web.dll ao seu projeto.
Ativar log de API
Este é o primeiro valor que precisa ser adicionado à configuração. Este atributo informa ao aplicativo se deve ativar ou desativar o recurso de log da API do lado do cliente. Defina o valor como true para ativar o recurso de registro no aplicativo.
<add key="CacheClient.EnableAPILogging" value="true" />
Tempo antes do início do registro
Depois de habilitar o recurso de registro de chamadas de API, você precisa definir o tempo que o processo aguarda antes de registrar as chamadas de API. Este intervalo de tempo é dado em hh: mm: ss format, o que significa que é o tempo que o processo espera antes do início da primeira iteração. No exemplo a seguir, o aplicativo começará a gravar logs assim que o aplicativo for iniciado:
<add key="CacheClient.TimeBeforeLoggingStart" value="00:00:00" />
Iterações de log da API
Você também precisa especificar o número de vezes que o aplicativo pode registrar os dados por meio do APILogIterations
recurso. NCache só permitirá que você mantenha logs para o número especificado de iterações.
<add key="CacheClient.APILogIterations" value="4" />
Duração da iteração do log da API
Essa propriedade especifica a duração de uma iteração de log em segundos. Por exemplo, o código a seguir especificará que cada log será gravado continuamente por uma hora antes de ocorrer um intervalo:
<add key="CacheClient.APILogIterationLength" value="3600" />
Atraso de log da API entre iteração
Esta propriedade define o intervalo de tempo entre duas iterações consecutivas de log de chamadas de API para NCache clientes. Este intervalo de tempo é definido em segundos.
<add key="CacheClient.APILogDelayBetweenIteration" value="5" />
Intervalo de registro de thread do Logger
Este é o intervalo de tempo após a iteração de log em que os dados de log serão gravados no arquivo de log.
<add key="CacheClient.LoggerThreadLoggingInterval" value="5" />
Com base nas configurações especificadas acima, NCache começará a registrar as APIs usadas em seu aplicativo. Se alguma vez houver uma situação em que surja um problema que possa estar relacionado com NCache, esse log é mais um passo mais perto de identificar a raiz do problema. O arquivo de log criado como resultado do recurso está localizado em %NCHOME%\log-files
(Windows) ou /opt/ncache/log-files
(Linux).
Uma nova pasta é criada assim que o aplicativo terminar de registrar pelo nome APIUsageLogs
. Todos os arquivos de log da API serão criados na pasta mencionada acima, o nome do arquivo de log é criado usando o nome do cache que está sendo usado e também o carimbo de data/hora em que o arquivo foi criado.
Veja também
NCache Visualizador de registro
Registro de contadores de desempenho
Notificações por e-mail ativadas NCache Eventos