パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細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 件

ソースリポジトリ

このパッケージを使用しているプロジェクト