Bagaimana bekerja dengan log4net di C #

Saat mengerjakan aplikasi, Anda mungkin sering ingin mencatat data aplikasi yang mungkin termasuk, urutan kejadian dalam aplikasi Anda, tindakan pengguna atau bahkan kesalahan saat terjadi. Ada banyak framework logging yang dapat Anda gunakan, tetapi log4net sejauh ini merupakan salah satu framework logging yang paling populer untuk digunakan dengan aplikasi yang dibangun atau dikembangkan di .NET. Ini adalah pustaka sumber terbuka (port pustaka sumber terbuka log4j populer untuk Java) yang dapat digunakan untuk mencatat data aplikasi ke target log berbeda di .NET.

Menginstal log4net 

Cara termudah dan tercepat untuk mulai menggunakan log4net adalah dengan menginstalnya melalui NuGet Package Manager. Dengan asumsi bahwa Anda telah membuat proyek aplikasi konsol di Visual Studio, Anda dapat menginstal log4net melalui NuGet Manager, dengan mengikuti langkah-langkah berikut.

  1. Di "Solution Explorer Window", pilih dan klik kanan pada proyek Anda
  2. Klik "Kelola Paket NuGet ..."
  3. Klik "Online" lalu ketik log4net di kotak pencarian
  4. Pilih paket log4net yang ingin Anda instal
  5. Klik "Instal" untuk memulai proses instalasi

Pada tulisan ini, rilis stabil terbaru dari log4net adalah 2.0.5. Setelah log4net diinstal melalui NuGet Package Manager, Anda akan mengamati perakitan log4net ditambahkan sebagai referensi untuk proyek Anda.

Konfigurasi log4net

Sekarang paket log4net telah berhasil diinstal, tambahkan baris berikut ke file AssemblyInfo.cs di folder Properties proyek Anda. Jika ini tidak ditentukan, pengaturan konfigurasi tidak akan dipertimbangkan.

[perakitan: log4net.Config.XmlConfigurator (ConfigFile = "Log4Net.config", Watch = true)]

Atau, Anda juga dapat menyebutkan hal yang sama di file app.config atau web.config.

[perakitan: log4net.Config.XmlConfigurator (Watch = true)]

Jika metadata konfigurasi log4net Anda berada di beberapa file lain (yaitu, selain file web.config atau app.config), Anda dapat menentukan yang berikut ini.

[perakitan: log4net.Config.XmlConfigurator (ConfigFile = "log4net.config", Watch = true)]

Langkah selanjutnya adalah menentukan detail konfigurasi yang diperlukan untuk log4net di app.config atau file web.config di aplikasi Anda. Dengan asumsi Anda menggunakan proyek aplikasi konsol, tambahkan bagian konfigurasi bernama "log4net" di file app.config seperti yang ditunjukkan di bawah ini.

Sekarang, tambahkan bagian "" setelah elemen dalam file app.config Anda. Selanjutnya, di dalam bagian "", tempatkan detail konfigurasi seperti yang ditunjukkan pada potongan kode yang diberikan di bawah ini.

Hanya itu yang perlu Anda lakukan untuk mengkonfigurasi log4net. Sekarang mari kita jelajahi bagaimana kita dapat menggunakannya dalam kode kita. Elemen ini digunakan untuk menentukan nama dan jenis logger yang akan digunakan. Dalam contoh ini kami menggunakan appender file bergulir. Namun, ada banyak jenis appender yang tersedia, yaitu AdoNetAppender, AspNetTraceAppender, ConsoleAppender, dll. Berikut adalah daftar lengkap dan cara mengkonfigurasi appender lainnya.

Menggunakan log4net 

Di kelas Anda, buat referensi ke ILog dengan melakukan panggilan ke metode statis GetLogger dari kelas LogManager seperti yang ditunjukkan dalam cuplikan kode yang diberikan di bawah ini.

private static hanya baca log4net.ILog log = 

log4net.LogManager.GetLogger

(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);

Sekarang Anda dapat menggunakan instance bernama log untuk mencatat data ke target yang dikonfigurasi. Cuplikan kode berikut mengilustrasikan bagaimana Anda sekarang dapat memanfaatkan instance log untuk mencatat data.

log.Debug ("Ini adalah pesan Debug");

log.Info ("Ini adalah pesan Info");

log.Warn ("Ini adalah pesan Peringatan");

log.Error ("Ini adalah pesan Error");

log.Fatal ("Ini adalah pesan Fatal");

Berikut daftar kode lengkap yang menunjukkan bagaimana Anda dapat mencatat pesan pengecualian Anda dalam file teks menggunakan log4net.

Program kelas

   {

       static readonly log4net.ILog log =

       log4net.LogManager.GetLogger

(System.Reflection.MethodBase.GetCurrentMethod (). DeclaringType);

       static void Main (string [] args)

       {

           mencoba

           {

               membuang Pengecualian baru ("Ini adalah pesan pengujian ...");

           }

           catch (Exception ex)

           {

               log.Error (mis.Message);

           }          

           Console.Read ();

       }

   }

Setelah Anda menjalankan program di atas, file teks bernama .log akan dibuat dan pesan pengecualian yang ditentukan dengan dicatat bersama dengan stempel waktu. Perhatikan bahwa Anda juga dapat menggunakan log4net secara terprogram, yaitu, mengkonfigurasi log4net secara terprogram tanpa memerlukan konfigurasi yang telah kita bahas sebelumnya.