Les premiers pas

Le paquet de journalisation principal est Serilog. Les plateformes prises en charge sont .NET/.NET Core, .NET Framework 4.5+, Windows (8/WinRT/Universal+) et Windows Phone 8+.

Installation à partir de NuGet

Voici les commandes pour installer Serilog :

Parcourez la balise Serilog sur NuGet pour voir les récepteurs, les extensions et les paquets tiers associés disponibles.

Configuration

Les types se trouvent dans l'espace de noms Serilog :

Le Logger racine est créé à l'aide de LoggerConfiguration :

Cette opération est généralement effectuée une fois au démarrage de l'application, et l'enregistreur est enregistré pour une utilisation ultérieure par les classes d'application. Plusieurs enregistreurs peuvent être créés et utilisés indépendamment si nécessaire.

Le journal de bord global et statiquement accessible de Serilog est défini via Log.Logger et peut être appelé à l'aide des méthodes statiques de la classe Log :

La configuration et l'utilisation de la classe Log sont une commodité facultative facilitant l'adoption de Serilog par les bibliothèques. Serilog ne nécessite aucun état statique/à l'échelle du processus dans le pipeline de journalisation lui-même, donc l'utilisation directe de Logger/ILogger est acceptable.

Exemple d'application

L'exemple complet ci-dessous montre la journalisation dans une application console simple, avec des événements envoyés à la console ainsi qu'un fichier journal horodaté.

1. Créer un nouveau projet d'application console
2. Installer le paquet Serilog de base, le récepteur de console et le récepteur de fichiers

Au prompt de l'interpréteur de commande dans le répertoire du projet, saisissez :

dotnet add package Serilog dotnet add package Serilog.Sinks.Console dotnet add package Serilog.Sinks.File



3. Ajoutez le code suivant à Program.cs :


1. using System;
2. using Serilog;
3.  
4. class Program
5. {
6.     static async Task Main()
7.     {
8.         Log.Logger = new LoggerConfiguration()
9.             .MinimumLevel.Debug()
10.             .WriteTo.Console()
11.             .WriteTo.File("logs/myapp.txt", rollingInterval: RollingInterval.Day)
12.             .CreateLogger();
13.  
14.         Log.Information("Bonjour!");
15.  
16.         int a = 10, b = 0;
17.         try
18.         {
19.             Log.Debug("Dividing {A} by {B}", a, b);
20.             Console.WriteLine(a / b);
21.         }
22.         catch (Exception ex)
23.         {
24.             Log.Error(ex, "Quelque chose s'est mal passé");
25.         }
26.         finally
27.         {
28.             await Log.CloseAndFlushAsync();
29.         }
30.     }
31. }


4. Exécuter le programme :

[08:08:03 INF] Bonjour!
[08:08:03 DBG] Dividing 10 by 0
[08:08:03 ERR] Quelque chose s'est mal passé
System.DivideByZeroException: Attempted to divide by zero.
   at SerilogExample.Program.Main() in C:\Source\Git\ConsoleSerilog\ConsoleSerilog\Program.cs:line 21