Registri client per la registrazione degli errori
NCache fornisce la registrazione per l'applicazione client e a livello di socket. La registrazione è disabilitata per impostazione predefinita, ma può essere abilitata specificando le impostazioni di registro tramite API nel file NCache applicazione o NCache file di configurazione client.ncconf.
Questi registri contengono informazioni sulle operazioni del client e dati sull'utilizzo delle operazioni propagate attraverso il server socket per comunicare con il server remoto. Questi registri vengono creati nella posizione predefinita in cui NCache i registri vengono salvati.
Per abilitare i log client a livello di programmazione per una cache, NCache fornisce Opzioni di connessione cache. È possibile specificare ulteriormente il livello di registro per i registri client, come spiegato di seguito.
considerazioni speciali
If client.ncconf il file contiene il
enable-client-log
valori e l'utente li trasmetteCacheConnectionOptions
così come i valori passatiCacheConnectionOptions
avranno la priorità alta e verranno utilizzati.Se uno dei valori (AbilitaClientLogs or Loglevel) è passato
CacheConnectionOptions
ed entrambi sono impostati nel client.ncconf, leggerà quello fornito daCacheConnectionOptions
e quello non previstoCacheConnectionOptions
,da client.ncconf.
Ad esempio, se i registri client sono abilitati utilizzando CacheConnectionOptions
ed LogLevel
non è specificato, abiliterà i log dei client indipendentemente dal valore in client.ncconf e usa il valore di log-level
da client.ncconf dal momento che non è fornito attraverso CacheConnectionOptions
.
- Se non vengono passati valori
CacheConnectionOptions
, leggerà i valori da client.ncconf.
Prerequisiti
- Per conoscere i prerequisiti standard richiesti per lavorare con all NCache Per le funzionalità lato client fare riferimento alla pagina specificata Prerequisiti dell'API lato client.
- Per i dettagli dell'API, fare riferimento a: ICache, Gestore cache, Ottieni cache, Opzioni di connessione cache, AbilitaClientLogs, Loglevel.
Errore durante la registrazione dall'API utilizzando le opzioni di connessione
In questo esempio, se sono già presenti valori in client.config verranno sovrascritti e i valori verranno forniti Opzioni di connessione cache verrà utilizzato.
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:
Per garantire che l'operazione sia a prova di errore, si consiglia di gestire eventuali potenziali eccezioni all'interno dell'applicazione, come spiegato in Gestione dei guasti.
Registrazione degli errori dalla configurazione del client
Se i registri client non sono abilitati tramite CacheConnectionOptions
cercherà il prossimo valore possibile, ovvero il valore di enable-client-log
in client.ncconfe usarlo. Nel caso sia falso, i log non verranno abilitati.
Note:
Quando il Loglevel non è specificato attraverso il CacheConnectionOptions
quindi cercherà il prossimo valore possibile, ovvero il valore di log-level
nel client.ncconf e usarlo. Nel caso in cui non sia menzionato lì, utilizzerà il valore predefinito, ovvero log-level = "error".
Note:
If NCache è installato, i log del client vengono inseriti in %NCHOME%/bin/log-files/ClientLogs. Altrimenti, si trovano nella cartella bin dell'applicazione.
Tipi di registrazione
Di seguito sono riportate le tipologie di registrazione:
INFO: Il livello di informazioni descrive alcune informazioni utili su qualsiasi operazione eseguita sulla cache, ad esempio l'avvio del registro e lo stato di arresto delle operazioni di trasferimento dello stato.
ERRORE: Questo flag di registro fornisce la causa degli errori generati durante l'esecuzione dell'operazione. Questo registro di stato è utile nella maggior parte degli scenari di risoluzione dei problemi, ad esempio durante l'avvio di un'eccezione della cache che si verifica per l'unione con la propria replica.
DEBUG: Questa opzione di registro stampa informazioni dettagliate su qualsiasi operazione nella cache, ad esempio informazioni su ogni operazione come una chiave e gli elementi della cache durante il trasferimento di stato. Queste informazioni di registro analizzano in dettaglio i problemi della cache ogni volta che il normale debug non è possibile. Ma questo provoca un degrado delle prestazioni per le operazioni della cache.