Hono

The autotel-hono package provides an otel() middleware for automatic request tracing and HTTP metrics in Hono applications.

Installation

npm install autotel-hono autotel

Quick Start

import { Hono } from 'hono';
import { init, getRequestLogger } from 'autotel';
import { otel } from 'autotel-hono';

init({ service: 'my-api' });

const app = new Hono();
app.use('*', otel());

app.get('/api/users', async (c) => {
  const log = getRequestLogger();
  log.set({ route: '/api/users' });
  const users = await db.users.findAll();
  log.emitNow();
  return c.json(users);
});

With Adapters

Use useLogger() from autotel-adapters/hono when the otel() middleware already creates a span (avoids duplicate spans):

import { otel } from 'autotel-hono';
import { useLogger } from 'autotel-adapters/hono';

app.use('*', otel());
app.get('/orders/:id', (c) => {
  const log = useLogger(c);
  log.set({ route: c.req.path });
  return c.json({ ok: true });
});

Options

The otel() middleware accepts options for customizing tracing behavior:

Option	Description
tracer	Custom tracer instance
tracerProvider	Custom tracer provider
meter	Custom meter instance
spanNameFactory	Custom span name from request
captureRequestHeaders	Headers to capture as span attributes
captureResponseHeaders	Response headers to capture
captureActiveRequests	Track active request gauge
captureRequestDuration	Track request duration histogram
serviceName	Override service name
serviceVersion	Override service version
disableTracing	Disable span creation (metrics only)

Span Attributes

HTTP request spans include:

• http.request.method — GET, POST, etc.
• url.path — Request path
• http.response.status_code — Response status
• http.request.duration_ms — Request duration

Examples

• example-hono — Hono with otel() middleware, useLogger() request-scoped logging, and manual trace() in handlers.

Related

• autotel-adapters — DX helpers (useLogger, withAutotel)
• Agent Guide — Framework setup snippets