搜尋套件、儲存庫與 APP 分類

套件詳情v2.0.0+1

logging_appenders

用於 Dart 日誌套件的記錄器附加元件,支援列印、檔案與遠端記錄(logz、loki、graylog (gelf))。

AndroidiOSmacOSWindowsLinux
近 30 天下載
1.5萬
喜歡數
44
Pub 分數
160

安裝套件

flutter pub add logging_appenders

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個 Flutter/Dart 套件,透過提供用於列印日誌、寫入檔案以及將日誌遠端傳送至 Logz.io、Loki 和 Graylog (GELF) 等服務的附加器來擴展核心日誌功能。它與 Dart 日誌套件無縫整合,讓開發者能以最少的設定將日誌訊息導向多個目的地。非常適合用於除錯、監控以及跨環境的集中式日誌管理。

適用情境

  • 在開發中除錯應用程式
  • 生產環境的集中式日誌聚合
  • 將日誌寫入本機檔案以進行分析
  • 發送日誌到遠端監控服務
  • 實時日誌串流用於可觀測性

主要特色

  • 支援列印、檔案與遠端記錄目標
  • 與流行的日誌管理平台整合
  • 使用 Dart 日誌套件輕鬆設定
  • 可設定的日誌格式化與過濾
  • 跨平台相容性
  • 可擴充的架構,用於自訂追加器

適合對象

  • 開發跨平台 Flutter 應用的開發者
  • 需要集中式日誌記錄的團隊
  • 需要持久化日誌儲存的應用程式
  • 負責管理可觀測性流程的DevOps工程師
  • 使用結構化日誌記錄並輸出 JSON 的項目

使用建議

  • 需要正確配置遠程服務端點
  • 檔案追加器若未妥善管理,可能會影響效能
  • 遠端記錄引入了網路依賴
  • 確保敏感資料在生產環境中不會被記錄
  • 可能需要為特定後端添加額外依賴項

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

logging_appenders

Pub codecov

Native dart package for logging appenders usable with the logging package.

Color Output Screenshot

It currently includes appenders for:

Performance of Remote Logging Appenders

I am not sure if it is wise to use this in production, but it's great during beta testing with a handful of users so you have all logs available.

It tries to stay reasonable performant by batching log entries and sending them off only every few seconds. If network is down it will retry later. (with an ever increasing interval).

Getting Started

After installing package logging and logging_appenders:

import 'package:logging/logging.dart';
import 'package:logging_appenders/logging_appenders.dart';

final _logger = Logger('main');

void main() {
  PrintAppender.setupLogging();

  // The above code is the same as:
  // Logger.root.level = Level.ALL;
  // PrintAppender()..attachToLogger(Logger.root);

  _logger.fine('Lorem ipsum');
}

Outputs:

$ dart main.dart
2019-08-19 15:36:03.827563 FINE main - Lorem ipsum

Support for Exception chaining

To chain exception you can use the extension method on Exception: causedBy().

int test() {
  try {
    int.parse('a');
  } catch (e, stackTrace) {
    throw Exception('unable to parse').causedBy(e, stackTrace);
  }
}
int main() {
  try {
    test();
  } catch (e, stackTrace) {
    logger.severe('catched Exception', e, stackTrace);
  }
}

Color Formatter

    PrintAppender(formatter: const ColorFormatter())
        ..attachToLogger(Logger.root);

Produces:

Color Output Screenshot

Logging to stderr

When using dart:io (ie. command line apps) it is possible to define which log levels should go to stderr instead of stdout:

PrintAppender.setupLogging(stderrLevel: Level.SEVERE);

Remote Appenders

Appender for logz.io

  final _logzIoApiSender = LogzIoApiAppender(
    // you can find your API key and the required URL from 
    // the logz.io dashboard: https://app-eu.logz.io/#/dashboard/settings/general
    apiToken: 'MY API KEY',
    url: 'https://listener-eu.logz.io:8071/',
    labels: {'app': 'MyApp', 'os': Platform.operatingSystem},
  );
  _logzIoApiSender.attachToLogger(Logger.root);
  
  
  // ...
  If you know that you no longer need the appender. it's good to dispose it:
  _logzIoApiSender.dispose();

所屬分類

依賴

依賴清單 5 項

原始碼儲存庫

使用此套件的專案