Pakete, Repositories und App-Kategorien suchen

Paketdetailsv2.0.0+1

logging_appenders

Logging-Appender für das Dart-Logging-Paket für Print, Datei und Remote (logz, loki, graylog (gelf)).

AndroidiOSmacOSWindowsLinux
30-Tage-Downloads
15.300
Likes
44
Pub-Punkte
160

Paket installieren

flutter pub add logging_appenders

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Ein Flutter/Dart-Paket, das die grundlegende Protokollierungsfunktion erweitert, indem es Appender für die Ausgabe von Protokollen, das Schreiben in Dateien und das Fernsenden von Protokollen an Dienste wie Logz.io, Loki und Graylog (GELF) bereitstellt. Es integriert sich nahtlos mit dem Dart-Logging-Paket und ermöglicht Entwicklern, Protokollnachrichten mit minimaler Konfiguration über mehrere Ziele zu leiten. Ideal für Debugging, Überwachung und zentrale Protokollverwaltung über verschiedene Umgebungen hinweg.

Anwendungsfälle

  • Anwendungen im Entwicklungsprozess debuggen
  • Zentrale Protokollaggregation für die Produktion
  • Protokolle in lokale Dateien schreiben zur Analyse
  • Senden von Protokollen an Remote-Monitoring-Dienste
  • Echtzeit-Log-Streaming für Beobachtbarkeit

Hauptmerkmale

  • Unterstützt Druck-, Datei- und Remote-Logging-Ziele
  • Integration mit beliebten Log-Management-Plattformen
  • Einfache Einrichtung mit dem Dart-Logging-Paket
  • Konfigurierbare Protokollformatierung und -filterung
  • Plattformübergreifende Kompatibilität
  • Erweiterbare Architektur für benutzerdefinierte Appender

Geeignet für

  • Entwickler, die plattformübergreifende Flutter-Anwendungen erstellen
  • Teams, die zentrales Protokollieren erfordern
  • Anwendungen, die eine dauerhafte Protokollspeicherung benötigen
  • DevOps-Ingenieure, die Observability-Pipelines verwalten
  • Projekte, die strukturierte Protokollierung mit JSON-Ausgabe verwenden

Hinweise

  • Erforderliche korrekte Konfiguration der Remote-Service-Endpunkte
  • Die Dateianhängung kann die Leistung beeinträchtigen, wenn sie nicht verwaltet wird
  • Remote-Protokollierung führt zu Netzwerkabhängigkeiten
  • Stellen Sie sicher, dass sensible Daten in der Produktion nicht protokolliert werden
  • Könnte zusätzliche Abhängigkeiten für bestimmte Backends erfordern

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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();

Kategorien

Abhängigkeiten

Abhängigkeiten 5 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden