Home

歡迎來到 OzaLog 文件

OzaLog v3.0+ —— 輕量、極簡 API、HFT 級異步的 .NET 本地日誌函式庫

套件資訊

項目	連結
NuGet	https://www.nuget.org/packages/OzaLog/
GitHub	https://github.com/ozakboy/OzaLog
介紹網站	https://ozakboy.github.io/OzaLog/
授權	MIT

⚠️ 重要說明

本套件前身為 Ozakboy.NLOG(v2.x 已棄用)。v3.0 改名為 OzaLog 以避免與 NLog (jkowalski's package) 撞名混淆。OzaLog 與 NLog 完全無關,僅命名相近。

從 v2.x 升級請見 升級指南(繁中)。

為什麼選 OzaLog

• 極簡 API —— 一行 LOG.Info_Log("...") 即可寫 log,無需 DI、無需 LoggerFactory
• HFT 級異步 —— ConcurrentQueue + 持久化 FileStream 池 + 1ms 快取時間戳 + drop-oldest 背壓
• 零依賴 —— net8.0 / net9.0 / net10.0 完全零 NuGet 依賴
• 線程安全 —— 預設線程安全,專為加密貨幣報價串流等高並發場景設計

支援的 TargetFrameworks

• .NET 8.0 / 9.0 / 10.0(LTS + Current)
• .NET Standard 2.0 / 2.1(舊專案相容)

v3.0 已移除: .NET Framework 4.6.2、.NET 6.0、.NET 7.0(皆已 EOL)。

立即上手

using OzaLog;

LOG.Info_Log("Hello, OzaLog!");
LOG.Error_Log("Something went wrong", exception);
LOG.CustomName_Log("BTC", "tick: 67890.12");

詳細範例請見:

• LOG Samples —— 完整 API 與配置範例
• ErrorMessageException Samples —— 異常 log 範例

進階文件

主題	連結
完整 README	README_zh-TW.md
配置選項	docs/zh-TW/configuration.md
API 參考	docs/zh-TW/api.md
HFT 異步架構	docs/zh-TW/async-pipeline.md
效能對比	docs/zh-TW/benchmarks.md
版本歷史	docs/zh-TW/changelog.md

開源支持

如果 OzaLog 對您有幫助,歡迎透過贊助頁面以加密貨幣或 Binance Pay 支持開發者。