Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. time series
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
      1. Docker & Kubernetes
      2. Operating systems
      3. Log forwarders
      4. Programming languages
        1. JavaScript & Node.js
          1. Quick start guide
          2. Advanced usage
          3. Frameworks
            1. Next.js
            2. Pino
            3. Koa
            4. Winston
            5. Bunyan
        2. Python
        3. Ruby
        4. PHP
        5. Java
        6. .NET
        7. Go
        8. Erlang
      5. Cloud platforms
      6. Web servers & Load balancers
      7. Databases & queues
      8. Storage
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Connections API
    7. Query API ↗
  7. Alternative to
    1. Lightstep

Logtail Bunyan stream

Start logging in 3 steps

1. Install

Install Logtail Bunyan and Logtail Node NPM packages:

Install Logtail packages
npm install @logtail/bunyan @logtail/node

2. Setup

Set up Logtail Bunyan stream:

Set up Bunyan logger
const bunyan = require("bunyan");
const { Logtail } = require("@logtail/node");
const { LogtailStream } = require("@logtail/bunyan");

// Create Logtail client
const logtail = new Logtail("$SOURCE_TOKEN", {
  endpoint: 'https://$INGESTING_HOST',
});

// Create Bunyan logger
const logger = bunyan.createLogger({
  name: "Example logger",
  level: "debug",
  streams: [
    {
      stream: new LogtailStream(logtail),
    },
  ],
});


3. Start logging 🎉

Use Bunyan logger as usual:

Send logs to Logtail
logger.error("Something bad happened.");
logger.info({
    item: "Orange Soda",
    price: 100.00
}, "Log message with structured logging.");

// Ensure that all logs are sent to Logtail
logtail.flush()

You should see your logs in Logtail → Live tail.

Bunyan version 2.0.0 or higher is required.

Need help?

Please let us know at hello@betterstack.com.
We're happy to help! 🙏

Other Logtail clients

Looking for a different JavaScript logging solution? Check out Logtail clients for JavaScript and Node.js.

Previous article

Better Stack Winston transport

Next article

Better Stack Python logging