Bagikan melalui

File Log (POS untuk Dokumentasi .NET v1.14 SDK)

Microsoft Point of Service untuk .NET (POS untuk .NET) menyertakan fitur pengelogan untuk merekam POS untuk .NET, Objek Layanan, dan peristiwa aplikasi. Parameter pengelogan dibaca dari POS untuk kunci registri .NET, \HKLM\SOFTWARE\POSfor.NET\Logging, dan entri ditulis menggunakan Logger kelas .

Mengaktifkan Pengelogan

Pengelogan diaktifkan ketika kunci registri \HKLM\SOFTWARE\POSfor.NET\Logging\Enabled diatur ke nilai bukan nol.

Ukuran File Log

Ukuran file log maksimum ditentukan dalam kunci registri \HKLM\SOFTWARE\POSfor.NET\Logging\MaxLogFileSizeMB. Jika ukuran file ini terlampaui saat pengelogan diaktifkan, pengelogan akan berhenti. Tidak akan ada pengecualian atau kesalahan yang dikembalikan ke aplikasi.

Secara default, ukuran file log maksimum adalah 10 megabyte (MB).

Lokasi File Log

Kunci registri \HKLM\SOFTWARE\POSfor.NET\Logging\location digunakan untuk menentukan di mana file log akan ditulis.

Secara default, lokasi ini diatur ke variabel lingkungan %TEMP% yang, di Windows, default ke direktori C:\Documents and Pengaturan\(username)\Local Pengaturan\temp. Ini adalah direktori per pengguna.

Nama File Log

Nama file log terdiri dari tiga elemen:

  • Nama file dasar yang terkandung dalam kunci registri \HKLM\SOFTWARE\POSfor.NET\Logging\Name. Default untuk nilai ini adalah PosFor.Net.
  • Tanda waktu dalam format ini: (yyyy-mm-dd hh-mm-ssZ)
  • Ekstensi file .txt.

Ini adalah contoh nama file log umum:

PosFor.Net(2006-08-10 18-33-29Z).txt

Log File Header

Header yang berisi informasi seperti pengguna, OS, utas panggilan, dan proses ditulis ke setiap file log saat dibuat. Header ini mencakup bidang berikut:

  • Pengguna saat ini: Nama pengguna saat ini.
  • Nama komputer: Nama komputer yang membuat log.
  • Versi OS: Versi Windows yang sedang dijalankan, termasuk paket layanan.
  • Runtime .Net: Versi runtime .NET.
  • Id Proses: PID proses yang membuat file log.
  • Id Utas: Utas yang membuat log.
  • Ukuran file log maks: Ukuran file maksimum yang akan digunakan untuk file log ini.
  • File: Nama executable yang membuat file log.
  • InternalName: Nama internal dari executable.
  • OriginalFilename: Nama asli executable.
  • FileVersion: Informasi versi yang disimpan dalam executable.
  • FileDescription: Deskripsi yang disimpan dalam executable.
  • Produk: Deskripsi produk yang disimpan dalam executable.
  • ProductVersion: Versi file yang disimpan dalam executable.
  • Debug: Bendera debug.
  • Di-patch: File yang di-patch.
  • PraRilis: Bendera pra-rilis.
  • PrivateBuild: Bendera build privat.
  • SpecialBuild: Bendera build khusus.
  • Bahasa: Bahasa yang digunakan untuk membuat file log.

Entri File Log

Entri log dapat dibuat oleh POS untuk .NET atau dengan aplikasi atau Objek Layanan. Entri dibuat dengan memanggil metode yang sesuai pada instans kelas Pencatat.

Setiap entri berisi bidang berikut:

  • Stempel waktu.

  • ID utas yang membuat entri.

  • Tingkat kepentingan. Setiap entri log ditandai dengan tingkat kepentingannya yang ditentukan oleh metode Pencatat yang terlibat.

    Tag Penting dalam Entri Log Metode Pencatat yang Sesuai
    INFO Logger.Info
    PERINGATAN Logger.Warning
    KESALAHAN Logger.Error

  • String nama ditentukan oleh kode yang disebut metode Pencatat. String ini ditentukan ketika metode Pencatat dipanggil dan mungkin belum tentu berisi nama yang dapat dieksekusi.

  • Misalnya, entri umum dalam file log akan terlihat seperti ini: [8/10/2006 6:12:14 PM 2936 INFO PosExplorer] Memasuki LoadExplorer()

Komentar

Jika ada file log yang terbuka, dan aplikasi memanggil Refresh() metode , file ditutup dan yang baru dibuat dengan stempel waktu yang diperbarui.

Lihat Juga

Referensi

Konsep

Sumber Daya Lain

  • Last updated on