Repolode
Enviar
loglayer

loglayer/loglayer

Uma API unificada de logging em TypeScript que envia logs para Pino, Winston, serviços de nuvem, arquivos, StatsD e OpenTelemetry por uma única interface fluente.

Ver no GitHubSite
Estrelas
548
Forks
12
Issues abertas
2
Último commit
há 27 dias

O que é?

LogLayer é uma biblioteca de logging para JavaScript e TypeScript que funciona como uma camada sobre loggers e transports existentes. O código da aplicação registra logs por meio de uma única API fluente para mensagens, metadados e erros, enquanto a saída real é encaminhada para a biblioteca de logging ou serviço configurado, como Pino, provedores de nuvem, arquivos, StatsD ou OpenTelemetry. É possível usar vários transports ao mesmo tempo.

A biblioteca adiciona gerenciamento de contexto e metadados a essa API. É possível anexar contexto persistente a um logger com withContext, metadados por entrada com withMetadata e erros com withError. Plugins, como um plugin de redação, podem modificar os dados do log antes que cheguem à biblioteca subjacente; o contexto e os metadados podem ser colocados em campos nomeados ou achatados na saída.

A biblioteca funciona em navegadores, Node.js, Bun e Deno, e inclui um mixin de wide events que emite uma entrada autocontida por operação. Há uma versão para Go disponível em um projeto separado.

Recursos principais

  • 01API fluente para mensagens de log, metadados e erros.
  • 02Encaminha logs para Pino e outras bibliotecas de logging, provedores de nuvem, arquivos, StatsD e OpenTelemetry.
  • 03Permite usar vários transports ao mesmo tempo.
  • 04Plugins podem modificar os dados do log, por exemplo, para redigir campos.
  • 05Contexto persistente e metadados por entrada, com posicionamento configurável dos campos.
  • 06Funciona em navegadores, Node.js, Bun e Deno.

Casos de uso

  • Padronizar o logging em uma base de código JavaScript ou TypeScript sem deixar de poder trocar o logger subjacente.
  • Enviar os mesmos logs da aplicação para um arquivo local e para um serviço de logging ou observabilidade na nuvem.
  • Redigir campos confidenciais, como senhas, antes de gravar os logs.
  • Emitir um wide event por solicitação ou operação para facilitar a depuração.

Início rápido

  1. 1

    Instale o pacote principal pelo npm

    npm install loglayer
  2. 2

    Instale uma biblioteca de logging, como Pino, e seu transporte

    npm install loglayer pino @loglayer/transport-pino
  3. 3

    Crie uma instância de LogLayer com um transporte e registre uma mensagem

Antes de usar

  • O README documenta apenas um monorepo pnpm para contribuir, sem nenhum comando para executá-lo de forma independente além da importação da biblioteca.

Em coleções

Plataformas de OpenTelemetry e observabilidade

Tópicos

#logging#typescript#javascript#observability#opentelemetry#nodejs#structured-logging#abstraction#bun#datadog

Perguntas frequentes

O que é loglayer?
Uma API unificada de logging em TypeScript que envia logs para Pino, Winston, serviços de nuvem, arquivos, StatsD e OpenTelemetry por uma única interface fluente. LogLayer é uma biblioteca de logging para JavaScript e TypeScript que funciona como uma camada sobre loggers e transports existentes. O código da aplicação registra logs por meio de uma única API fluente para mensagens, metadados e erros, enquanto a saída real é encaminhada para a biblioteca de logging ou serviço configurado, como Pino, provedores de nuvem, arquivos, StatsD ou OpenTelemetry. É possível usar vários transports ao mesmo tempo.
loglayer é gratuito? Qual é a licença?
loglayer é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
loglayer ainda é mantido?
Manutenção ativa. O último commit de loglayer foi em 25 de set. de 2026.
Para que posso usar loglayer?
Padronizar o logging em uma base de código JavaScript ou TypeScript sem deixar de poder trocar o logger subjacente. Enviar os mesmos logs da aplicação para um arquivo local e para um serviço de logging ou observabilidade na nuvem. Redigir campos confidenciais, como senhas, antes de gravar os logs. Emitir um wide event por solicitação ou operação para facilitar a depuração.
Como instalar loglayer?
Instale o pacote principal pelo npm: npm install loglayer Instale uma biblioteca de logging, como Pino, e seu transporte: npm install loglayer pino @loglayer/transport-pino Crie uma instância de LogLayer com um transporte e registre uma mensagem
Onde consigo loglayer?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/loglayer/loglayer

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados