hono

@logtide/hono

LogTide middleware for Hono — automatic request tracing, error capture, and breadcrumbs.

---

Features

• Automatic request spans for every incoming request
• Error capture with full request context
• W3C Trace Context propagation (traceparent in/out)
• Breadcrumbs for HTTP requests
• Scope access via c.get('logtideScope')
• Works everywhere — Node.js, Bun, Deno, Cloudflare Workers
• Full TypeScript support with strict types

Installation

npm install @logtide/hono
# or
pnpm add @logtide/hono
# or
yarn add @logtide/hono

---

Quick Start

import { Hono } from 'hono';
import { logtide } from '@logtide/hono';

const app = new Hono();

app.use('*', logtide({
  dsn: 'https://lp_your_key@your-instance.com',
  // Or use apiUrl + apiKey instead of dsn:
  // apiUrl: 'https://your-instance.com',
  // apiKey: 'lp_your_key',
  service: 'my-hono-api',
  environment: 'production',
}));

app.get('/hello', (c) => c.json({ message: 'Hello World' }));

export default app;

---

How It Works

The middleware runs on every request and:

1. Extracts incoming traceparent header (or generates a new trace ID)
2. Creates a span named after the request (e.g. GET /hello)
3. Stores scope on the Hono context (c.set('logtideScope', scope))
4. Calls next() to process the request
5. Finishes the span with ok or error based on response status
6. Injects traceparent into the response headers
7. Captures errors thrown by handlers with full context

---

Accessing the Scope

Use c.get() to access the LogTide scope inside your handlers:

app.get('/users/:id', (c) => {
  const scope = c.get('logtideScope');
  const traceId = c.get('logtideTraceId');

  // Add custom breadcrumbs
  scope.addBreadcrumb({
    type: 'query',
    category: 'database',
    message: 'SELECT * FROM users WHERE id = ?',
    timestamp: Date.now(),
  });

  return c.json({ id: c.req.param('id') });
});

---

Configuration

All ClientOptions from @logtide/core are supported:

Option	Type	Default	Description
dsn	string	required	DSN string: https://lp_KEY@host/PROJECT
service	string	required	Service name for log attribution
environment	string	—	Environment (e.g. production, staging)
release	string	—	Release / version identifier
debug	boolean	false	Enable debug logging
tracesSampleRate	number	1.0	Sample rate for traces (0.0 to 1.0)

See @logtide/core README for the full list of options.

---

Error Handling

Errors thrown by handlers are automatically captured with:

• HTTP method and URL
• Request span marked as error
• Error serialized with stack trace

app.get('/boom', () => {
  throw new Error('Something broke');
  // Automatically captured by LogTide middleware
});

For 5xx responses (e.g. from Hono's error handler), the middleware also logs an error entry.

---

Exports

import { logtide } from '@logtide/hono';
import type { LogtideHonoOptions } from '@logtide/hono';

---

License

MIT License - see LICENSE for details.

Links

• LogTide Website
• Documentation
• GitHub