Condividi tramite

File di log (documentazione POS per .NET v1.14 SDK)

Microsoft Point of Service per .NET (POS per .NET) include una funzionalità di registrazione per la registrazione di eventi POS per .NET, oggetti servizio e applicazioni. I parametri di registrazione vengono letti dalla chiave del Registro di sistema POS per .NET, \HKLM\SOFTWARE\POSfor.NET\Logging e le voci vengono scritte usando la classe Logger.

Abilitazione della registrazione

La registrazione è abilitata quando la chiave del Registro di sistema \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled è impostata su qualsiasi valore diverso da zero.

Dimensioni del file di log

Le dimensioni massime del file di log sono specificate nella chiave del Registro di sistema \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Se le dimensioni del file vengono superate durante l'abilitazione della registrazione, quest'ultima verrà interrotta. Non verranno restituiti eccezioni o errori all'applicazione.

Per impostazione predefinita, la dimensione massima del file di log è di 10 megabyte (MB).

Percorso del file di registro

La chiave del Registro di sistema \HKLM\SOFTWARE\POSfor.NET\Logging\location viene usata per determinare dove verranno scritti i file di log.

Per impostazione predefinita, questo percorso è impostato sulla variabile di ambiente %TEMP% che, in Windows, per impostazione predefinita corrisponde alla directory C:\Documents and Settings\(nome utenti)\Local Settings\temp. Si tratta di una directory per utente.

Nomi file di log

I nomi dei file di log sono costituiti da tre elementi:

  • Nome del file di base contenuto nella chiave del Registro di sistema \HKLM\SOFTWARE\POSfor.NET\Logging\Name. Il valore predefinito per questo valore è PosFor.Net.
  • Timestamp in questo formato: (aaaa-mm-gg hh-mm-ssZ)
  • L'estensione del file è .txt.

Questo è un esempio di un tipico nome di file di log:

PosFor.Net(2006-08-10 18-33-29Z).txt

Intestazione del file di log

Un'intestazione contenente informazioni quali l'utente, il sistema operativo, il thread chiamante e il processo viene scritta in ogni file di log al momento della creazione. Questa intestazione include i campi seguenti:

  • Utente corrente: il nome dell'utente corrente.
  • Nome computer: nome del computer che crea il log.
  • Versione del sistema operativo: versione di Windows in esecuzione, inclusi i Service Pack.
  • Runtime .Net: versione del runtime .NET.
  • ID processo: PID del processo che ha creato il file di log.
  • ID thread: thread che ha creato il log.
  • Dimensioni massime del file di log: dimensioni massime del file da usare per questo file di log.
  • File: nome del file eseguibile che ha creato il file di log.
  • InternalName: nome interno dell'eseguibile.
  • OriginalFilename: nome originale del file eseguibile.
  • FileVersion: informazioni sulla versione archiviate nel file eseguibile.
  • FileDescription: descrizione archiviata nell'eseguibile.
  • Product: descrizione del prodotto archiviata nell'eseguibile.
  • ProductVersion: versione del file archiviata nel file eseguibile.
  • Debug: flag di debug.
  • Con patch: file con patch.
  • Versione non definitiva: flag di versione non definitiva.
  • PrivateBuild: flag di build privata.
  • SpecialBuild: flag di build speciale.
  • Lingua: lingua usata per creare il file di log.

Voci del file di log

Le voci di log possono essere create da POS per .NET, dall'applicazione o dall'oggetto servizio. Le voci vengono create chiamando il metodo appropriato in un'istanza della classe Logger.

Ciascuna voce include i campi seguenti:

  • Timestamp.

  • ID thread, alla base della creazione della voce.

  • Livello di importanza. Ogni voce di log è contrassegnata con il livello di importanza determinato dal metodo Logger coinvolto.

    Tag di importanza nelle voci di log Metodo Logger corrispondente
    INFO Logger.Info
    AVVISO Logger.Warning
    ERROR Logger.Error

  • Stringa del nome specificata dal codice che ha chiamato il metodo Logger. Questa stringa viene specificata quando viene richiamato il metodo Logger e potrebbe non contenere necessariamente il nome dell'eseguibile.

  • Ad esempio, una voce tipica nel file di log sarà simile alla seguente: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering LoadExplorer()

Commenti

Se è presente un file di log aperto e l'applicazione chiama il metodo Refresh(), il file viene chiuso e ne viene creato uno nuovo con il timestamp aggiornato.

Vedi anche

Riferimento

Concetti

Risorse aggiuntive