{"id":399,"date":"2022-09-21T13:04:11","date_gmt":"2022-09-21T13:04:11","guid":{"rendered":"https:\/\/oussamasaidi.com\/?p=399"},"modified":"2025-12-20T11:15:10","modified_gmt":"2025-12-20T11:15:10","slug":"serilog-in-aspnet-core-3-1","status":"publish","type":"post","link":"https:\/\/oussamasaidi.com\/en\/serilog-in-aspnet-core-3-1\/","title":{"rendered":"Ma\u00eetriser les Logs Structur\u00e9s avec Serilog dans ASP.NET Core 8"},"content":{"rendered":"

Guide Complet Serilog avec Exemples pour SQL Server et le Cloud<\/em><\/p>\n\n\n\n

Introduction<\/strong><\/h2>\n\n\n\n

Aujourd’hui, les applications modernes g\u00e9n\u00e8rent des volumes croissants de donn\u00e9es. Pour les d\u00e9velopper efficacement, une solution de journalisation robuste devient indispensable. Parmi les outils disponibles, Serilog<\/strong> se distingue comme l’une des meilleures biblioth\u00e8ques de logging pour .NET.<\/p>\n\n\n\n

Dans ce tutoriel, nous allons d\u00e9couvrir comment l’impl\u00e9menter dans ASP.NET Core 8<\/strong>. Vous apprendrez \u00e0 configurer des sinks pour SQL Server et le cloud, \u00e0 r\u00e9soudre les probl\u00e8mes courants et \u00e0 adopter les bonnes pratiques.<\/p>\n\n\n\n

\n\n\n\n

Pourquoi Choisir Serilog ?<\/strong><\/h2>\n\n\n\n

Contrairement au syst\u00e8me de logging par d\u00e9faut d’ASP.NET Core, Serilog offre plusieurs avantages majeurs :<\/p>\n\n\n\n

✅ Logs structur\u00e9s<\/strong> : Format JSON pour une analyse simplifi\u00e9e
✅ Plus de 100 sinks<\/strong> : Support pour SQL Server, Elasticsearch, Slack, etc.
✅ Enrichissement facile<\/strong> : Ajout automatique d’infos comme l’ID utilisateur
✅ Performances optimis\u00e9es<\/strong> : Traitement asynchrone non bloquant<\/p>\n\n\n\n

Gr\u00e2ce \u00e0 ces fonctionnalit\u00e9s, Serilog s’impose comme l’outil id\u00e9al pour les applications professionnelles.<\/p>\n\n\n\n

\n\n\n\n

\u00c9tape 1 : Installation des Packages Serilog<\/strong> avec NuGet<\/strong><\/h2>\n\n\n\n

Pour commencer, ajoutez ces packages \u00e0 votre projet :<\/p>\n\n\n\n

dotnet add package Serilog.AspNetCore\ndotnet add package Serilog.Sinks.MSSqlServer\ndotnet add package Serilog.Sinks.Console<\/pre>\n\n\n\n
Cette configuration de base vous permettra de stocker les logs dans une base de donn\u00e9es SQL Server tout en les affichant dans la console.<\/p>\n\n\n\n
\n\n\n\n
\u00c9tape 2 : Configuration Serilog<\/strong> dans appsettings.json<\/strong><\/h2>\n\n\n\n
Ensuite, configurez Serilog dans votre fichier de param\u00e8tres :<\/p>\n\n\n\n
{\n  \"Serilog\": {\n    \"Using\": [\"Serilog.Sinks.Console\"],\n    \"MinimumLevel\": \"Information\",\n    \"WriteTo\": [\n      {\n        \"Name\": \"Console\",\n        \"Args\": {\n          \"outputTemplate\": \"{Timestamp:HH:mm:ss} [{Level}] {Message}{NewLine}{Exception}\"\n        }\n      },\n      {\n        \"Name\": \"MSSqlServer\",\n        \"Args\": {\n          \"connectionString\": \"Server=.;Database=Logs;Trusted_Connection=True;\",\n          \"tableName\": \"LogEvents\"\n        }\n      }\n    ]\n  }\n}<\/pre>\n\n\n\n
Cette configuration offre un bon \u00e9quilibre entre lisibilit\u00e9 et richesse d’information.<\/p>\n\n\n\n
\n\n\n\n
\u00c9tape 3 : Initialisation dans Program.cs<\/strong><\/h2>\n\n\n\n
Maintenant, initialisez Serilog dans le point d’entr\u00e9e de votre application :<\/p>\n\n\n\n
using Serilog;\n\nvar builder = WebApplication.CreateBuilder(args);\n\nbuilder.Host.UseSerilog((ctx, lc) =&gt; lc\n    .ReadFrom.Configuration(ctx.Configuration)\n    .Enrich.WithProperty(\"Application\", \"MonApp\")\n    .Enrich.WithCorrelationId());\n\nvar app = builder.Build();\n\napp.UseSerilogRequestLogging();\n\napp.MapGet(\"\/\", () =&gt; {\n    Log.Information(\"Page d'acc\u00e8s visit\u00e9e \u00e0 {Timestamp}\", DateTime.UtcNow);\n    return \"Bonjour !\";\n});\n\napp.Run();<\/pre>\n\n\n\n
Cette impl\u00e9mentation permet de capturer automatiquement les requ\u00eates HTTP.<\/p>\n\n\n\n
\n\n\n\n
Cas d’Usage de Serilog Avanc\u00e9s<\/strong><\/h2>\n\n\n\n
1. Journalisation dans le Cloud (Azure Application Insights)<\/strong><\/h3>\n\n\n\n
Pour une solution cloud, ajoutez simplement :<\/p>\n\n\n\n
.WriteTo.ApplicationInsights(\n    \"&lt;CL\u00c9_INSTRUMENTATION&gt;\",\n    TelemetryConverter.Traces)<\/pre>\n\n\n\n
2. Surveillance des Erreurs (Sentry.io)<\/strong><\/h3>\n\n\n\n
Configurez Sentry pour le suivi des erreurs critiques :<\/p>\n\n\n\n
dotnet add package Serilog.Sinks.Sentry<\/pre>\n\n\n\n
.WriteTo.Sentry(o =&gt; {\n    o.Dsn = \"&lt;VOTRE_DSN&gt;\";\n    o.MinimumBreadcrumbLevel = LogLevel.Debug;\n})<\/pre>\n\n\n\n
\n\n\n\n
D\u00e9pannage des Probl\u00e8mes Courants<\/strong><\/h2>\n\n\n\n
Probl\u00e8me<\/th>Solution<\/th><\/tr><\/thead>
Logs absents dans SQL Server<\/td>V\u00e9rifiez autoCreateSqlTable: true<\/code><\/td><\/tr>
Ralentissements<\/td>Utilisez des sinks async comme Serilog.Sinks.Async<\/code><\/td><\/tr>
Propri\u00e9t\u00e9s manquantes<\/td>Ajoutez .Enrich.With()<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n
Bonnes Pratiques pour la Production<\/strong><\/h2>\n\n\n\n
    \n
  1. Privil\u00e9giez les sinks asynchrones<\/strong> pour les applications \u00e0 fort trafic<\/li>\n\n\n\n
  2. Prot\u00e9gez les donn\u00e9es sensibles<\/strong> avec Destructure.ToMaximumDepth(3)<\/code><\/li>\n\n\n\n
  3. Archivez les fichiers de logs<\/strong> avec Serilog.Sinks.File<\/code><\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n
    Conclusion<\/strong><\/h2>\n\n\n\n
    Serilog transforme radicalement la gestion des logs dans ASP.NET Core. Gr\u00e2ce \u00e0 ce guide, vous disposez d\u00e9sormais de tous les \u00e9l\u00e9ments pour impl\u00e9menter une solution professionnelle.<\/p>\n\n\n\n
    Pour approfondir le sujet, consultez notre tutoriel sur OpenTelemetry<\/a> pour les syst\u00e8mes distribu\u00e9s.<\/p>\n\n\n\n
    Derniers articles<\/h2>\n\n\n\n