Registrazione API lato client
NCache La registrazione dell'API lato client è una funzionalità diagnostica che registra tutto NCache Chiamate API effettuate da un'applicazione. Si tratta di un meccanismo di registrazione configurabile che crea diversi file di registro. Lo scopo della registrazione API è identificare quale API e le relative sequenze causano il problema in modo che il problema possa essere riprodotto facilmente da parte dell'utente. La registrazione dell'API client consente di risparmiare il sovraccarico appropriato del metodo chiamato insieme alle informazioni su chiave, dimensione dei dati, stato della cache, crittografia e compressione.
avvertimento
La registrazione API ha un impatto sulle prestazioni: si consiglia di abilitare la registrazione solo per scopi diagnostici.
Il logging è uno strumento importante che può essere utilizzato per tenere traccia di tutti gli eventi che si verificano in un'applicazione distribuita insieme ai rispettivi timestamp. NCache fornisce solo la funzionalità che può essere utilizzata per registrare le chiamate API sul lato client dell'applicazione sotto forma di file di registro.
Questa funzione può essere abilitata per creare un registro dettagliato e sequenziale di NCache Chiamate API effettuate dal lato client. Questa è un'opzione di modifica senza codice e viene abilitata semplicemente modificando le proprietà di configurazione del tuo progetto. Le informazioni nel file di registro possono essere utilizzate come meccanismo di traccia per comprendere e indagare su situazioni problematiche che potrebbero verificarsi sul lato client NCache Chiamate API.
Configurazione della registrazione dell'API lato client
Per abilitare e configurare la registrazione API lato client, è necessario aggiungere le seguenti proprietà nel file di configurazione dell'applicazione che può essere App.config or web.config a seconda del tipo di applicazione. Queste impostazioni devono essere aggiunte in <configuration>
e la <appSettings>
tag. È necessario aggiungere le seguenti proprietà per abilitare la registrazione API per NCache Chiamate API. Assicurati di aver aggiunto Web.dll al tuo progetto.
Abilita registrazione API
Questo è il primo valore che deve essere aggiunto alla configurazione. Questo attributo indica all'applicazione se abilitare o disabilitare la funzionalità di registrazione dell'API lato client. Impostare il valore su true per abilitare la funzionalità di registrazione nell'applicazione.
<add key="CacheClient.EnableAPILogging" value="true" />
Tempo prima dell'inizio della registrazione
Dopo aver abilitato la funzione di registrazione delle chiamate API, è necessario impostare il tempo di attesa del processo prima di registrare le chiamate API. Questo intervallo di tempo è ceduto hh: mm: ss format, il che significa che è il tempo che il processo attende prima che inizi la prima iterazione. Nell'esempio seguente, l'applicazione inizierà a registrare i registri non appena l'applicazione verrà avviata:
<add key="CacheClient.TimeBeforeLoggingStart" value="00:00:00" />
Iterazioni del registro API
È inoltre necessario specificare il numero di volte in cui l'applicazione può registrare i dati tramite il file APILogIterations
caratteristica. NCache ti consentirà di mantenere i registri solo per il numero di iterazioni specificato.
<add key="CacheClient.APILogIterations" value="4" />
Lunghezza dell'iterazione del registro API
Questa proprietà specifica la lunghezza di un'iterazione del log in secondi. Ad esempio, il codice seguente specificherà che ogni registro verrà registrato continuamente per un'ora prima che si verifichi un'interruzione:
<add key="CacheClient.APILogIterationLength" value="3600" />
Ritardo registro API tra l'iterazione
Questa proprietà imposta l'intervallo di tempo tra due iterazioni consecutive della registrazione delle chiamate API per NCache clienti. Questo intervallo di tempo è impostato in secondi.
<add key="CacheClient.APILogDelayBetweenIteration" value="5" />
Intervallo di registrazione del thread del logger
Questo è l'intervallo di tempo dopo l'iterazione di registrazione in cui i dati di registrazione verranno scritti nel file di registro.
<add key="CacheClient.LoggerThreadLoggingInterval" value="5" />
In base alle impostazioni sopra specificate, NCache inizierà a registrare le API utilizzate nella tua applicazione. Se mai si verifica una situazione in cui si verifica un problema e potrebbe essere correlato NCache, questo registro rappresenta un ulteriore passo avanti verso l'identificazione della radice del problema. Il file di registro creato come risultato della funzionalità si trova in %NCHOME%\log-files
(Windows) o /opt/ncache/log-files
(Linux).
Una nuova cartella viene creata una volta che l'applicazione ha terminato la registrazione in base al nome APIUsageLogs
. Tutti i file di registro API verranno creati nella cartella sopra menzionata, il nome del file di registro viene creato utilizzando il nome della cache utilizzata e anche il timestamp in cui è stato creato il file.
Vedere anche
NCache Log Viewer
Registrazione dei contatori delle prestazioni
Notifiche e-mail attivate NCache Eventi