Sdílet prostřednictvím

Soubory protokolů (Dokumentace k pos pro .NET v1.14 SDK)

Microsoft Point of Service for .NET (POS pro .NET) obsahuje funkci protokolování pro záznam POS pro .NET, objekty služby a události aplikace. Parametry protokolování jsou načteny z poS pro klíč registru .NET, \HKLM\SOFTWARE\POSfor.NET\Logging a položky se zapisují pomocí Logger třídy.

Povolení protokolování

Protokolování je povoleno, pokud je klíč registru \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled nastaven na libovolnou nenulovou hodnotu.

Velikost souboru protokolu

Maximální velikost souboru protokolu je zadána v klíči registru \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Pokud se tato velikost souboru při povoleném protokolování překročí, protokolování se zastaví. Aplikaci se nevrátí žádná výjimka nebo chyba.

Ve výchozím nastavení je maximální velikost souboru protokolu 10 megabajt (MB).

Umístění souboru protokolu

Klíč registru \HKLM\SOFTWARE\POSfor.NET\Logging\location slouží k určení umístění zápisu souborů protokolu.

Ve výchozím nastavení je toto umístění nastaveno na proměnnou prostředí %TEMP%, která ve Windows ve Výchozím nastavení používá adresář C:\Documents a Nastavení\(username)\Local Nastavení\temp. Toto je adresář pro jednotlivé uživatele.

Názvy souborů protokolu

Názvy souborů protokolu se skládají ze tří prvků:

  • Název základního souboru obsažený v klíči registru \HKLM\SOFTWARE\POSfor.NET\Logging\Name. Výchozí hodnota je PosFor.Net.
  • Časové razítko v tomto formátu: (rrrr-mm-dd hh-mm-ssZ)
  • Přípona souboru .txt.

Toto je příklad typického názvu souboru protokolu:

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

Hlavička souboru protokolu

Hlavička obsahující informace, jako je uživatel, operační systém, volání vlákna a proces, se při vytváření zapíše do každého souboru protokolu. Tato hlavička obsahuje následující pole:

  • Aktuální uživatel: Jméno aktuálního uživatele.
  • Název počítače: Název počítače, který vytváří protokol.
  • Verze operačního systému: Verze systému Windows, která se spouští, včetně aktualizací Service Pack.
  • Modul runtime .NET: Verze modulu runtime .NET.
  • ID procesu: IDENTIFIKÁTOR PID procesu, který vytvořil soubor protokolu.
  • ID vlákna: Vlákno, které vytvořilo protokol.
  • Maximální velikost souboru protokolu: Maximální velikost souboru, která se má použít pro tento soubor protokolu.
  • Soubor: Název spustitelného souboru, který vytvořil soubor protokolu.
  • InternalName: Interní název spustitelného souboru.
  • OriginalFilename: Původní název spustitelného souboru.
  • FileVersion: Informace o verzi uložené ve spustitelném souboru.
  • FileDescription: Popis uložený ve spustitelném souboru.
  • Produkt: Popis produktu uložený ve spustitelném souboru.
  • ProductVersion: Verze souboru uložená ve spustitelném souboru.
  • Ladění: Příznak ladění.
  • Opraveno: Opravený soubor.
  • Předběžné verze: Příznak předběžné verze
  • PrivateBuild: Příznak privátního sestavení.
  • SpecialBuild: Zvláštní příznak sestavení.
  • Jazyk: Jazyk použitý k vytvoření souboru protokolu.

Položky souboru protokolu

Položky protokolu mohou být vytvořeny poS pro .NET nebo aplikací nebo objektem služby. Položky jsou vytvořeny voláním příslušné metody v instanci Logger třídy.

Každá položka obsahuje následující pole:

  • Časové razítko.

  • ID vlákna, které vytvořilo položku.

  • Úroveň důležitosti Každá položka protokolu je označena svou úrovní důležitosti, která je určena metodou Logger .

    Značka důležitosti v položkách protokolu Odpovídající logger – metoda
    INFO Logger.Info
    UPOZORNĚNÍ Logger.Warning
    CHYBA Logger.Error

  • Řetězec názvu určený kódem, který se nazývá Logger metoda. Tento řetězec je zadán při vyvolání Logger metoda a nemusí nutně obsahovat název spustitelného souboru.

  • Například typická položka v souboru protokolu by vypadala takto: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Zadání LoadExplorer()

Komentáře

Pokud je otevřený soubor protokolu a aplikace volá metodu Refresh() , soubor se zavře a vytvoří se nový soubor s aktualizovaným časovým razítkem.

Viz také

Reference

Koncepty

Další prostředky

  • Last updated on