Partager via

Fichiers journaux (documentation du SDK POS pour .NET v1.14)

Microsoft Point of Service pour .NET (POS pour .NET) inclut une fonctionnalité de journalisation pour l’enregistrement de POS pour .NET, des objets de service et des événements d’application. Les paramètres de journalisation sont lus à partir de la clé de Registre POS pour .NET \HKLM\SOFTWARE\POSfor.NET\Logging, et les entrées sont écrites à l’aide de la classe Logger.

Activation de la journalisation

La journalisation est activée lorsque la clé de Registre \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled est définie sur une valeur différente de zéro.

Taille du fichier journal

La taille maximale du fichier journal est spécifiée dans la clé de Registre \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Si cette taille de fichier est dépassée lorsque la journalisation est activée, la journalisation s’arrête. Aucune exception ou erreur n’est retournée à l’application.

Par défaut, la taille maximale du fichier journal est de 10 mégaoctets (Mo).

Emplacement du fichier journal

La clé de Registre \HKLM\SOFTWARE\POSfor.NET\Logging\location est utilisée pour déterminer où les fichiers journaux seront écrits.

Par défaut, cet emplacement est défini sur la variable d’environnement %TEMP% qui, dans Windows, est définie par défaut sur le répertoire C:\Documents and Settings\(username)\Local Settings\temp. Il s’agit d’un répertoire propre à l’utilisateur.

Noms de fichiers journaux

Les noms de fichiers journaux sont composés de trois éléments :

  • Nom du fichier de base contenu dans la clé de Registre \HKLM\SOFTWARE\POSfor.NET\Logging\Name. La valeur par défaut est PosFor.Net.
  • Horodatage au format suivant : (aaaa-mm-jj hh-mm-ssZ)
  • Extension de fichier .txt.

Voici un exemple de nom de fichier journal classique :

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

En-tête de fichier journal

Un en-tête contenant des informations telles que l’utilisateur, le système d’exploitation, le thread appelant et le processus est écrit dans chaque fichier journal lors de sa création. L’en-tête inclut les champs suivants :

  • Utilisateur actuel : nom de l’utilisateur actuel.
  • Nom de l’ordinateur : nom de l'ordinateur qui crée le journal.
  • Version du système d’exploitation : version de Windows en cours d’exécution, y compris les Service Packs.
  • Runtime .Net : version du runtime .NET.
  • ID de processus : PID du processus qui a créé le fichier journal.
  • ID de thread : thread qui a créé le journal.
  • Taille maximale du fichier journal : taille de fichier maximale à utiliser pour ce fichier journal.
  • Fichier : nom de l’exécutable qui a créé le fichier journal.
  • InternalName : nom interne de l’exécutable.
  • OriginalFilename : nom d’origine de l’exécutable.
  • FileVersion : informations de version stockées dans l’exécutable.
  • FileDescription : description stockée dans l’exécutable.
  • Product : description de produit stockée dans l’exécutable.
  • Productversion : version de fichier stockée dans l’exécutable.
  • Debug : indicateur de débogage.
  • Patched : fichier corrigé.
  • Prérelease : indicateur de préversion.
  • PrivateBuild : indicateur de build privé.
  • SpecialBuild : indicateur de build spécial.
  • Langage : langage utilisé pour créer le fichier journal.

Entrées de fichier journal

Les entrées de journal peuvent être créées par POS pour .NET ou par l’application ou l’objet de service. Les entrées sont créées en appelant la méthode appropriée sur une instance de la classe Logger.

Chaque entrée contient les champs suivants :

  • Timestamp.

  • ID du thread à l’origine de l’entrée.

  • Niveau d’importance. Chaque entrée de journal est marquée avec son niveau d’importance qui est déterminé par la méthode Logger impliquée.

    Balise d’importance dans les entrées du journal Méthode Logger correspondante
    INFO Logger.Info
    WARNING Logger.Warning
    ERROR Logger.Error

  • Chaîne de nom spécifiée par le code qui a appelé la méthode Logger. Cette chaîne est spécifiée lorsque la méthode Logger est appelée et peut ne pas nécessairement contenir le nom de l’exécutable.

  • Par exemple, une entrée classique dans le fichier journal se présente comme suit : [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Entering loadExplorer()

Commentaires

Si un fichier journal est ouvert et que l’application appelle la méthode Refresh(), le fichier est fermé et un nouveau est créé avec l’horodatage mis à jour.

Voir aussi

Informations de référence

Concepts

Autres ressources

  • Last updated on