آموزش لاگ کردن Logging در ASP.NET Core یکی دیگر از آموزش های گروه آموزشی پرووید می باشد که در این قسمت آن را به شما معرفی می کنیم. این بسته ی آموزشی نیز یکی از دوره های آموزشی دیگر که در حوزه ی فارسی سازی آموزش های انگلیسی تنظیم شده است می باشد. عنوان این بسته ی آموزشی لاگ کردن موثر اطلاعات در ASP.NET Core است که با نام اصلی Effective Logging in ASP.NET Core از شرکت Pluralsight منتشر شده است.

لاگ کردن (Logging) در ASP.NET Core

همانطور که ممکن است بدانید در فریم ورک ASP.NET Core از مکانیزم های مشابهی شبیه به آن چیزی که در .NET Core اتفاق می افتد برای انجام عملیات Logging استفاده می شود. بنابراین بهتر است که حتماً با مباحث مربوط به لاگ کردن اطلاعات در .NET Core آشنا بشوید. API مربوط به Logging در .NET Core و طبیعتاً در ASP.NET Core در یک پکیج با نام Microsoft.Extensions.Logging تعریف شده است. علاوه بر این Logging API نیاز به استفاده کردن از Logging Provider های مختلف به منظور ذخیره کردن و نشان دادن Log ها در یک رسانه خاص از قبیل Console و پنجره های Debug و Trace Listener خواهیم داشت. بنابراین می توان گفت که در پیاده سازی Logging در ASP.NET Core و .NET Core ما با دو مؤلفه بسیار مهم یعنی Logging API و Logging Provider ها روبرو خواهیم بود. همانطور که گفته شد Logging API در پکیج Microsoft.Extensions.Logging وجود دارد و می تواند در تمامی اپلیکیشن های مبتنی بر .NET Core از قبیل ASP.NET Core مورد استفاده قرار بگیرد. تنها کاری که نیاز است انجام بدهیم این است که از یک یا چند Logging Provider برای پیاده سازی عملیات Logging در اپلیکیشن های مبتنی بر .NET Core استفاده کنیم. کلاس های متعددی در Logging API های مربوط به .NET Core وجود دارند که مهمترین آنها شامل ILogger و ILogger Factory و ILogger Provider و Logger Factory می باشند. در ادامه رسالت هرکدام از این اینترفیس ها و کلاس ها را به طور کلی بررسی خواهیم کرد.

• اینتر فیس ILoggger Factory: از این اینترفیس به عنوان یک Factory Interface برای ایجاد کردن Instance هایی از نوع ILogger استفاده می کنیم. علاوه بر این به منظور اضافه کردن Instance هایی از نوع ILogger Provider نیز از اینترفیس ILogger Factory استفاده می شود. در Logging API مربوط به .NET Core یک کلاس درونی به نام Logger Factory وجود دارد که اینترفیس ILogger Factory را پیاده سازی می کند. ما می توانیم از این کلاس به منظور اضافه کردن Instance هایی از نوع ILogger Provider و همچنین بازیابی کردن Instance هایی از نوع ILogger برای یک Category خاص استفاده کنیم.
• اینترفیس ILogger Provider: از اینترفیس ILogger Provider به منظور مدیریت کردن و تولید کردن یک Logger مناسب توسط یک Logging Factory تعریف شده است استفاده می کنیم. علاوه بر این می توانیم یک Logging Provider را به وسیله پیاده سازی کردن اینترفیس ILogger Provider ایجاد کنیم.
• اینترفیس ILogger: از اینترفیس ILogger که شامل متدهایی برای Log کردن می باشد برای ثبت Log ها در رسانه های مختلف استفاده می کنیم. علاوه بر این Extension Method هایی وجود دارند که می توانند عملیات Log کردن را بسیار آسان کنند. در رابطه با Extension Method ها می توانید از آموزش متدهای گسترش Extension Method ها در سی شارپ دیدن کنید.

بررسی Logging Provider ها

همانطور که گفته شد مؤلفه مهم بعدی در مکانیزم Log کردن اطلاعات در .NET Core مبحث Logging Provider ها می باشد. یک Logging Provider به منظور نشان دادن و ذخیره کردن Log ها در یک رسانه خاص از قبیل Console و یا Net Log های مختلف مورد استفاده قرار می گیرد. مایکروسافت چندین Logging Provider مختلف را در قالب Nugget Package ها در اختیار ما قرار میدهد که برخی از مهمترین آنها شامل موارد زیر هستند.

• گزینه Microsoft.Extensions.Logging.Console
• گزینه Microsoft.Extensions.Logging.AzureAppServices
• گزینه Microsoft.Extensions.Logging.Debug
• گزینه Microsoft.Extensions.Logging. EventLog
• گزینه Microsoft.Extensions.Logging.EventSource
• گزینه Microsoft.Extensions.Logging.TraceSource

علاوه بر این مایکروسافت تلاش کرده است که با استفاده از فریم ورک های Logging دیگر از قبیل NLog و Serilog و Logger و Log4Net گزینه های بیشتری را در اختیار برنامه نویسان قرار بدهد.

سرفصل مطالب آموزش ویدئویی لاگ کردن (Logging) موثر در ASP.NET Core

فصل اول: مقدمه این دوره آموزشی

• مقدمه این دوره آموزشی

فصل دوم: شروع به کار با انجام Logging در ASP.NET Core

• مقدمه ای بر Effective Logging
• بررسی Module Overview
• بررسی بررسی پیکربندی های پیشرفت پروژه و <> <>
• آموزش عملی: بررسی اپلیکیشن موزد نظر با پیکربندی پیش فرض
• آموزش عملی: اضافه کردن Log Entry
• آموزش عملی: استفاده از Serilog برای نوشتن روی فایل ها
• آموزش عملی: اضافه کردن Log Entry برای Class Library
• جمع بندی

فصل سوم: کنترل پیام های Logged در اپلیکیشن های ASP.NET Core

• مقدمه
• بررسی Log Level ها
• بررسی متد ها و Category ها و EventId ها
• آموزش عملی: بررسی دوباره بروز رسانی های اپلیکیشن و نیازمندی های Logging
• آموزش عملی: اضافه کردن Log Entry ها با Level ها و Categoryها و EventId های مختلف
• آموزش عملی: بررسی ورودی های ورود به سیستم
• بررسی مکانیزم Filtering
• آموزش عملی: اعمال فیلترها
• آموزش عملی: بررسی Scope ها
• آموزش عملی: استفاده از LoggerMessage در شرایط عملکرد بالا
• جمع بندی

فصل چهارم: خودکارسازی Logging مربوط به رویداد های استاندارد در ASP.NET Core

• مقدمه
• بررسی Exception Handling
• آموزش عملی: بررسی Global Exception Handling در UI Project ها
• آموزش عملی: ثبت جزئیات استثنا و به روز رسانی Error Page
• نسخه ی نمایشی Middleware سفارشی برای مدیریت Global API Exception Handling
• آموزش عملی: خواندن پاسخ خطای API از UI
• بررسی Filter ها
• آموزش عملی: پیاده سازی Razor Page Filter برایLog کردن یک Performance
• آموزش عملی: پیاده سازی یک Action Filter برای API ها Log کردن Performance
• بررسی Attribute های Base Class ها
• آموزش عملی: ایجاد Attribute برای کنترل کننده ها و Action ها
• آموزش عملی: Overrid کردن Filter Method ها در Razor Pages
• آموزش عملی: ایجاد یک کلاس پایه برای Razor Page ها
• جمع بندی

فصل پنجم: ساختن Log Entries های بهتر برای فعال سازی تجزیه و تحلیل سریعتر

• مقدمه
• بررسی آناتومی یک Log Entry
• تجزیه و تحلیل Log Entry Content
• آموزش عملی: استفاده از Scopes برای افزودن Context
• آموزش عملی: بررسی دوباره Exception Handling
• آموزش عملی: حفاظت از Sensitive Information
• جمع بندی

فصل ششم: فعال سازی Consumption

• مقدمه
• بررسی انواع Consumption ها
• بررسی گزینه های مقصد
• آموزش عملی: استفاده از Serilog و Seq
• آموزش عملی: استفاده از NLog و Elasticsearch (ELK)
• آموزش عملی: استفاده کردن از Azure App Service Diagnostics
• جمع بندی و ارسال