Après la création de notre crud dans l'article "[CRUD ASP.NET Core MVC avec MYSQL](../crud-asp-et-core-mvc-avec-mysql)", nous ajouterons un fichier de journalisation ou un logger pour suivre l'état de notre application en production. ## C'est quoi un fichier de journalisation ou logger? Le fichier de journalisation ou un logger enregistre chronologiquement les événements exécutés sur notre application. Il permet de comprendre et de déboguer rapidement notre application en production en cas de bug ou erreur. ASP.net core propose des fournisseurs de journalisation grâce à son [hôte générique](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/host/generic-host?view=aspnetcore-7.0) au niveau des éléments suivants: - [Console](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0#console) - [Déboguer](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0#debug) - [EventSource](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0#event-source)[EventLog](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0#welog) : Windows uniquement Les fournisseurs de journaux de ASP.core peuvent être appelés **fournisseurs de journalisation intégrés.** ## Configuration de base Avant de créer un fichier de journalisation, il faut effectuer une configuration. La configuration de la journalisation est généralement fournie par la section Logging des fichiers appsettings.{ENVIRONMENT}.json, où l'espace réservé {ENVIRONMENT} correspond à l'[environnement](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/environments?view=aspnetcore-7.0). Le fichier appsettings.Development.json suivant est généré par défaut dans le projet ASP.NET Core : ```json { "Logging": { "LogLevel": { "Default": "Information", "Microsoft": "Warning", "Microsoft.Hosting.Lifetime": "Information" } } } ``` **La propriété Logging** peut avoir des propriétés [LogLevel](https://learn.microsoft.com/fr-fr/dotnet/api/microsoft.extensions.logging.loglevel) et des propriétés de fournisseur de journaux. **Le logLevel** est constitué d'une catégorie à gauche et d'un niveau de log à droite. ## Niveaux de journalisation Il est important de comprendre comment le niveau de log fonctionne. La propriété LogLevel spécifie le [niveau](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0#log-level) de journalisation minimal pour les catégories sélectionnées. Dans le code JSON précédent, les niveaux de journalisation Information et Warning sont spécifiés. LogLevel indique le niveau de gravité du journal, qui peut varier de 0 à 6 : **Trace = 0, Debug = 1, Information = 2, Warning = 3, Error = 4, Critical = 5 et None = 6.** ![ASP.NET niveau de log ou log level](https://lh5.googleusercontent.com/NyxwnpCUKrT_Q-qbEcyEnzTlk7ivcqk4ZLJksn0iX64buYD6Mj6TLW-5zBhFkQeljFaKN78MABa43frKcSxzMl6yd0IXmxM9Gm1B15OfWVr4FhO_PaB9k5BKlKBLAc1QQ41Jp4L0H3IGdeDUotUSdtZp9dctVbMlfV4CA8E7rXZcEPpY9fryMAc1_v98Rg) **NB:** Pour en savoir plus sur la journalisation dotnet voici le lien de la page officiel avec plus de détail en fonction de votre version de dotnet: [https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0](https://learn.microsoft.com/fr-fr/aspnet/core/fundamentals/logging/?view=aspnetcore-7.0) ## Maintenant débutons le code 👍 ![Nlog avec .NET core](https://lh5.googleusercontent.com/NyxwnpCUKrT_Q-qbEcyEnzTlk7ivcqk4ZLJksn0iX64buYD6Mj6TLW-5zBhFkQeljFaKN78MABa43frKcSxzMl6yd0IXmxM9Gm1B15OfWVr4FhO_PaB9k5BKlKBLAc1QQ41Jp4L0H3IGdeDUotUSdtZp9dctVbMlfV4CA8E7rXZcEPpY9fryMAc1_v98Rg) Nous utiliserons **un fournisseur de journalisation tiers (Nlog)** qui nous permettra d'avoir notre fichier de journalisation. ### Installation du package NLog **Ajoutons et installons le package nlog.** ```bash NLog.Web.AspNetCore ``` ![Installation NLog](https://lh5.googleusercontent.com/Kj3v1it7CdmbCcAzis530CYj7xX54RQJQ5uSKMLd7VuntndX2vkddeANVH5U_O1idM7HL-Gkbp6WVqHa7e39apLJHe3BWPZlY9BNFyTDL9OJ30n9kT7Z408cLf4EkeZEWUV5f8xc0BdrdcaOcHwhdIhvNbFK5iHDUySDtsHp0-OL3sBoP68BNxnnqBEJgw) ### Configuration du fichier NLog **Ajoutons un fichier de configuration propre à nlog** À la racine du projet créons un fichier `nlog.config` ![Création du fichier nlog.config](https://lh5.googleusercontent.com/pYiASkwIk8hQ9EREJv45I-8hm69F3N6DAHbfOLIY9ShKtLXzt0Lrsr0kBNod6eMPqnMXp_aS5E1l5BzDdtBLUu1qbtsklN3cjUZCAyRFGSoJlzS4FqC_nlisnuYUWBrnlaG0TPGJQ3xzfqLiYMDuiqkp4DskK3TB7LP7qUYRjEqLhNkkynolfBjlXbM9ow) **Ajoutons les éléments suivants dans notre fichier :** ```xml ``` L'élément `` nous permet de générer un fichier avec les informations de journalisation dans le fichier correspondant. ### Configuration dans Program.cs **Dans notre fichier Program.cs ajoutons nlog :** ```csharp public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args).ConfigureLogging((hostingContext, logging) => { logging.AddConfiguration(hostingContext.Configuration.GetSection("Logging")); logging.AddNLog(); }).ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup(); }); ``` ### Configuration dans Startup.cs **Dans notre fichier Startup aussi ajoutons l'élément suivant :** ```csharp LogManager.LoadConfiguration(string.Concat(Directory.GetCurrentDirectory(), "/nlog.config")); ``` ![Configuration Startup](https://lh6.googleusercontent.com/Eij4u66_LxsQJ-TeJRF4V9PusUhpgRA_zdDgU9_WW4RTcMgyTsjHz-WTFibbN3g5nZ1F60uSjTaFmQeCTfEuaOh_AiSf0Z1Ulx6P_GN3pr15zxqNPACedIwJZFBQHq4NtnYYtMvzjCbXzCb_taH_N9XgbyrMj3WlO7o-ddrFHSSHzbXgDRwJxv7zC6kbYg) ## Test en développement **Démarrons à nouveau notre solution et observons la création de fichier de journalisation ou log.** Après le démarrage, vous devriez voir un fichier de log généré automatiquement avec les événements de votre application. ## Configuration pour la production ### Adaptation du chemin pour Linux **Configurons notre fichier nlog.config pour la production sur un serveur linux.** Changeons juste notre path ou chemin avec le filename de notre serveur en production : ```xml ``` ### Déploiement en production **Faisons la mise à jour en production sur notre serveur linux.** Après la mise à jour nous démarrons notre service : ```bash epa@localhost:/var/log$ sudo systemctl restart crud-mvc.service epa@localhost:/var/log$ sudo systemctl status crud-mvc.service ``` Observons maintenant dans le fichier de notre projet nous avons le dossier logs avec notre fichier de journalisation à l'intérieur. ![Fichiers de log générés](https://lh5.googleusercontent.com/iDMA9MBbOzBDPGiCsVeSwLl48MgCL4J5c4406M3j4uw5E0pj032Fravf6_0QdMYGcgNpMxO0GkynTfkdW6IIsHOh-dFY4-o9FwMX0usonzNcyC9yaLd82Y8dtdR_ADonx_AeDEu9rpRdIi9Jcfkb2p4tJl2PNS0R5tnfEL6GFkpXl8kvay5oMSvQFPO6ng) ## Utilisation du logger dans le code Voici comment utiliser le logger dans vos contrôleurs : ```csharp public class ContactController : Controller { private readonly ILogger _logger; private readonly DataContext _db; public ContactController(ILogger logger, DataContext db) { _db = db; _logger = logger; } public async Task Index() { _logger.LogInformation("Accès à la page d'index des contacts"); try { var result = await _db.Contacts.ToListAsync(); return View(result); } catch (Exception ex) { _logger.LogError(ex, "Erreur lors de la récupération des contacts"); return View(new List()); } } [HttpPost] public async Task Create(Contact contact) { if (ModelState.IsValid) { try { _db.Contacts.Add(contact); await _db.SaveChangesAsync(); _logger.LogInformation("Contact créé avec succès : {ContactId}", contact.Id); TempData["success"] = "Création effectuée avec succès"; return RedirectToAction("Index"); } catch (Exception ex) { _logger.LogError(ex, "Erreur lors de la création du contact"); ModelState.AddModelError("", "Erreur lors de la création"); } } return View(contact); } } ``` ## Avantages du logging avec NLog ### 🔸 Avantages principaux : - **Traçabilité complète** : Enregistrement de toutes les actions importantes - **Debugging facilité** : Identification rapide des erreurs en production - **Monitoring** : Surveillance continue de l'application - **Audit** : Historique des opérations effectuées - **Performance** : Identification des goulots d'étranglement ### 🔸 Types de logs recommandés : - **Information** : Actions importantes (connexion utilisateur, création d'entité) - **Warning** : Situations suspectes mais non bloquantes - **Error** : Erreurs gérées avec contexte - **Critical** : Erreurs critiques nécessitant une intervention immédiate ## Bonnes pratiques 1. **Structurer vos messages** : Utilisez des messages clairs et contextuels 2. **Éviter les logs excessifs** : Ne loggez pas chaque opération triviale 3. **Inclure le contexte** : Ajoutez les IDs et données pertinentes 4. **Gérer la rotation** : Configurez la rotation des fichiers pour éviter les gros volumes 5. **Sécurité** : Ne loggez jamais de données sensibles (mots de passe, tokens) ## Conclusion Nous savons maintenant ajouter un fichier de journalisation dans nos projets .NET Core. Le logging est essentiel pour : - **Maintenir la qualité** de l'application en production - **Diagnostiquer rapidement** les problèmes - **Monitorer les performances** et l'utilisation - **Assurer la traçabilité** des opérations Cette implémentation avec NLog vous donne une base solide pour une gestion professionnelle des logs dans vos applications ASP.NET Core. --- *#AspNet #DotNet #Logger #NLog #Journalisation #Production #Debugging*