Edge-first framework

Hono observability, live in minutes.

OpenTelemetry tracing for Hono, on Node or the edge runtime of your choice.

Create a project Full Hono docs
Three ways in

Snippet, wizard, or manual.

Lead with the fastest path — the copy-paste snippet with your token baked in. The wizard and manual setup stay available.

  1. STEP 1
    Copy-paste the snippet

    Create an OpenTelemetry project, export TRACEPATH_URL and TRACEPATH_TOKEN.

  2. STEP 2
    Run the wizard

    npx tracepath-wizard detects Hono and writes the bootstrap.

  3. STEP 3
    Manual path

    Bootstrap NodeSDK before your app starts; disable the HTTP auto-instrumentation when using @hono/otel.

Real code

A working instrumentation.js.

Taken from our own examples and docs — this is the actual shape of a Hono integration.

import { NodeSDK } from "@opentelemetry/sdk-node";
import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
import { PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
import { getNodeAutoInstrumentations } from "@opentelemetry/auto-instrumentations-node";

const tracepathUrl = process.env.TRACEPATH_URL || "https://ingest.tracepath.dev";
const tracepathToken = process.env.TRACEPATH_TOKEN;

const sdk = new NodeSDK({
  traceExporter: new OTLPTraceExporter({
    url: `${tracepathUrl}/api/otel/v1/traces`,
    headers: { Authorization: `Bearer ${tracepathToken}` },
  }),
  metricReader: new PeriodicExportingMetricReader({
    exporter: new OTLPMetricExporter({
      url: `${tracepathUrl}/api/otel/v1/metrics`,
      headers: { Authorization: `Bearer ${tracepathToken}` },
    }),
    exportIntervalMillis: 10_000,
  }),
  // Disable instrumentation-http — @hono/otel handles HTTP spans at the
  // middleware level. Keep other auto-instrumentations (db, redis, fetch).
  instrumentations: [
    getNodeAutoInstrumentations({
      "@opentelemetry/instrumentation-http": { enabled: false },
    }),
  ],
});

sdk.start();

Source: examples/hono-otel/instrumentation.js in the TracePath repo. TODO-verify: snippet matches the latest SDK release before publishing.

What you get

Built for Hono.

Middleware-level HTTP spans via @hono/otel

Runs on Node and edge-compatible runtimes

Metrics over OTLP

Trace-context propagation built in

Browse everything tagged #hono →

Other frameworks

Next.jsNestJSExpressGoFlutterReactVueSvelte

Instrument Hono today.

Free plan, no credit card. First event in under five minutes.

Start freeSelf-host instead