pulse_logger 0.1.0

Dart-first operational event logger for sending sanitized app events to Console and Slack transports.

example/example.dart

import 'dart:io';

import 'package:pulse_logger/pulse_logger.dart';

Future<void> main() async {
  final webhookUrl = Platform.environment['SLACK_WEBHOOK_URL'];

  final config = PulseConfig(
    environment: Platform.environment['APP_ENV'] ?? 'local',
    appName: 'Pulse Logger Example',
    minimumLevel: LogLevel.debug,
    defaultProperties: const <String, dynamic>{
      'team': 'mobile',
    },
    sensitiveKeys: const <String>[
      'email',
    ],
    sessionId: 'example-session',
    appVersion: '0.1.0',
  );

  final consoleTransport = const ConsoleTransport(useColor: false);

  final logger = webhookUrl == null || webhookUrl.isEmpty
      ? PulseLogger(config: config, transport: consoleTransport)
      : PulseLogger.multiChannel(
          config: config,
          transports: <Transport>[
            consoleTransport,
            SlackTransport(webhookUrl: webhookUrl),
          ],
          onError: (error, stackTrace) {
            // Keep observability on transport failures without breaking the app.
          },
        );

  await logger.info(
    event: 'user_login_started',
    title: 'User login started',
    properties: const <String, dynamic>{
      'source': 'google',
      'email': '[e-mail]',
    },
  );

  await logger.warning(
    event: 'checkout_retry',
    title: 'Checkout retry scheduled',
    properties: const <String, dynamic>{
      'attempt': 2,
    },
  );

  try {
    throw StateError('Payment gateway rejected the request');
  } on Object catch (error, stackTrace) {
    await logger.error(
      event: 'payment_failed',
      title: 'Payment failed',
      error: error,
      stackTrace: stackTrace,
      properties: const <String, dynamic>{
        'gateway': 'stripe',
        'amount': 49.99,
      },
    );
  }

  await logger.dispose();
}