LogLayer : une bibliothèque de journalisation moderne pour TypeScript / JavaScript

Vous en avez assez de jongler avec plusieurs bibliothèques de journalisation sur plusieurs projets ? Frustré par les erreurs incohérentes et la journalisation des métadonnées ? LogLayer, une solution open source, rationalise votre processus de journalisation et améliore l'expérience des développeurs.

Qu'est-ce que LogLayer ?

LogLayer agit comme une couche de journalisation unifiée, compatible avec les bibliothèques de journalisation populaires (Pino, Winston, Bunyan) et les fournisseurs de cloud (AWS, Google Cloud, DataDog). Il offre une API cohérente et intuitive pour enregistrer les messages, les métadonnées et les erreurs, dirigeant vos journaux vers la destination choisie.

Voici un exemple rapide :

import { LogLayer } from 'loglayer'
import { PinoTransport } from '@loglayer/transport-pino'
import pino from 'pino'

// Configure LogLayer with Pino
const log = new LogLayer({
  transport: new PinoTransport({ logger: pino() })
})

// Log with metadata
log.withMetadata({ userId: '123', action: 'login' })
   .info('User logged in successfully')

// Contextual logging (persists across calls)
log.withContext({ requestId: '123' })
log.info('Processing request') // requestId included

try {
  // ... potential error-throwing code
} catch (error) {
  log.withError(error)
     .withMetadata({ userId: '123' })
     .error('User request processing failed')
}

Principaux avantages de LogLayer :

• Commutation transparente de bibliothèque : Changez facilement de bibliothèque de journalisation sans refactorisation du code. Imaginez devoir passer de Pino à Winston à mi-projet – LogLayer rend cela indolore.

• API cohérente : Une API unifiée élimine le besoin de mémoriser différents noms de méthodes et ordres de paramètres dans les bibliothèques. Comparez :

<code>// LogLayer's consistent approach:
log.withMetadata({ some: 'data' }).info('my message')

// Inconsistent APIs without LogLayer:
winston.info('my message', { some: 'data' })     // winston
bunyan.info({ some: 'data' }, 'my message')      // bunyan</code>

• Support multi-transport : Envoyez des journaux vers plusieurs destinations (DataDog et votre enregistreur, par exemple) simultanément :

import { LogLayer } from 'loglayer'
import { datadogLogs } from '@datadog/browser-logs'
import { PinoTransport } from "@loglayer/transport-pino"
import { DatadogBrowserLogsTransport } from "@loglayer/transport-datadog-browser-logs"

// Datadog initialization (replace placeholders)
datadogLogs.init({
  clientToken: '<client_token>',
  site: '<datadog_site>',
  forwardErrorsToLogs: true,
  sampleRate: 100
})

const log = new LogLayer({
  transport: [
    new PinoTransport({ logger: pino() }),
    new DatadogBrowserLogsTransport({ logger: datadogLogs })
  ]
})

// Logs sent to both Pino and DataDog
log.info('User logged in successfully')
</datadog_site></client_token>

• Gestion simplifiée des erreurs : Gestion des erreurs standardisée dans toutes les bibliothèques.

• Système de plugins extensible : Ajoutez des plugins pour des fonctionnalités telles que la rédaction de données sensibles.

• Tests sans effort : Les simulations intégrées simplifient les tests.

Démarrage :

L'installation est simple :

npm install loglayer

Utilisation de base :

import { LogLayer, ConsoleTransport } from 'loglayer'

const log = new LogLayer({ transport: new ConsoleTransport({ logger: console }) })

log.info('Hello world!')

En savoir plus :

• Documentation officielle
• Référentiel GitHub
• Forfait NPM

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!