در اپ‌های دنیای حقیقی وواقعی، سازوکار لاگ کردن مطلوب نادرست طراحی اپلیکیشن برای ردیابی و انواع‌زدایی رفتارهای غیرمنتظره نرم‌افزار ضروری میباشد. در Asp.Net Core ما یک Logging API داخلی داریم که در Microsoft.Extensions.Logging قرار گرفته میباشد که تحت عنوان یک پکیج NuGet ارائه میشود.

با این API، ما می توانیم داده ها را با providerهای داخلی لاگ کردن مانند Console، Debug، EventListener، TraceListeners و غیره لاگ کنیم. برای توسعه و گسترش تعداد providerها مایکروسافت با providerهای لاگ گوناگون فرد ثالث مانند NLog، Serilog، Loggr، Log4Net و برخی مفاد دیگر همیاری نموده است.

درین نوشته‌علمی، ترکیب Asp.Net Core با NLog، یکی‌از دوستداشتنی‌ترین providerهای لاگ فرد ثالث را نظارت خوا هیم کرد.

پروسه ترکیب

در‌این نوشته‌ی‌علمی، مخلوط NLog با اپلیکیشن اینترنت Asp.Net Core را پوشش خوا هیم بخشید. در‌این مراحل سه فعالیت وجود داراست که بایستی ایفا دهیم:

1. اضافه کردن NLog NuGet Package

2. اضافه کردن NLog Configuration

3. اضافه کردن NLog Provider

اضافه کردن NLog NuGet Package

در اولی گام بایستی NLog را از NuGet package manager نصب کنیم.

برای ایفا این فعالیت، از سولوشن بر روی پروژه کلیک راست کرده و از منو Manage NuGet Packages را گزینش میکنیم. پنجره Package Manager Solution گشوده می‌گردد.

از پنجره Package Manager، پکیج NLog.Web.AspNetCore NuGet را کاوش می کنیم، همان طور که در تصویر تحت آرم داده گردیده‌است.

آن گاه، واپسین ورژن را تعیین کرده و بر روی Install کلیک می کنیم. در شکل نیاز به ورژن گذشته، قادر خواهیم بود از لیست کشویی مرتبط با ورژن آن را گزینش کنیم.

با اعمال این عمل NLog NuGet package برای پروژه ما نصب می‌گردد. بعداز اخذ پیام توفیق، قادر خواهیم بود به مرحله آتی برویم، یعنی اضافه کردن کانفیگ NLog.

اضافه کردن NLog Configuration

بعداز نصب پکیج NuGet ی NLog می بایست آن را کانفیگ کنیم. داده ها کانفیگ برای NLog در درون یک فولدر configuration، به اسم nlog.config در پوشه روت اپلیکیشن مراقبت میشود.

این nlog.config به طور اتوماتیک ساخت نمی شود. بدین ترتیب بایستی آن را به طور دستی اضافه کنیم.

برای اضافه کردن nlog.config، بر روی پروژه راست کلیک کرده و Add و بعد از آن New Item را از منو گزینش می کنیم. از پنجره Text file ,new item template را کاوش می کنیم.

همان گونه که در تصویر ذیل آرم داده شد‌ه‌است، پوشه متنی را nlog.config نامگذاری نمائید.

پوشه کانفیگ NLog یک فولدر تنظیمات مبتنی بر XML میباشد. در ذیل دست‌کم کانفیگ لازم برای تایپ کردن داده ها لاگ در پوشه جان دار میباشد.