Stack integrations

Autter Runtime is two credentials and three endpoints; everything else is per-stack sugar.

Credential	Where it lives	Can
Server key `autter_rt_…`	backend env vars only	send OTLP traces/metrics + relay browser events
Client key `autter_rtc_…`	frontend bundles (publishable)	send browser events only, origin-restricted

Endpoint	Format
`POST /v1/traces`, `POST /v1/metrics`	OTLP/HTTP — protobuf or JSON, gzip ok
`POST /v1/browser`	compact JSON (`@autter/runtime-browser` payload v1)

Any language with an OpenTelemetry SDK can send server telemetry — point its OTLP/HTTP exporter at the ingester and add the key as a header.

React / SPA / static sites

npm install @autter/runtime-browser

With a backend (recommended — relay, no key in the bundle):

initAutterBrowser({ endpoint: "/api/autter-runtime", service: "web-app" });

Without a backend (publishable client key, origin-restricted):

initAutterBrowser({
  endpoint: "https://otlp.autter.dev/v1/browser",
  clientKey: "autter_rtc_xxxxxxxx",
  service: "marketing-site",
});

React render errors: wrap with <AutterErrorBoundary> (from @autter/runtime-next, works in any React app). Vue/Svelte/Angular: call captureException(err) from the framework’s error hook (app.config.errorHandler, handleError, ErrorHandler).

Node.js (Express, Fastify, Koa, NestJS)

npm install @autter/runtime-node

// instrument.cjs — load first: node --require ./instrument.cjs server.js
const { initAutterServer } = require("@autter/runtime-node");
initAutterServer({
  apiKey: process.env.AUTTER_RUNTIME_KEY,
  service: "payments-api",
  release: process.env.GIT_SHA,
});

Relay for your frontend:

app.post("/api/autter-runtime", createBrowserRelayHandler({ apiKey }));

ESM-only apps need OpenTelemetry’s loader hook — see the package README.

Next.js

npm install @autter/runtime-next

Three files — instrumentation.ts, a relay route, and a client init + boundary. See the package README.

Go

import (
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp"
)

exp, _ := otlptracehttp.New(ctx,
    otlptracehttp.WithEndpointURL("https://otlp.autter.dev/v1/traces"),
    otlptracehttp.WithHeaders(map[string]string{
        "authorization": "Bearer " + os.Getenv("AUTTER_RUNTIME_KEY"),
    }),
)
// resource: service.name, service.version (release), deployment.environment
// errors: span.RecordError(err); span.SetStatus(codes.Error, err.Error())

Rust

// opentelemetry-otlp with the "http-proto" (default) or "http-json" feature
let exporter = opentelemetry_otlp::SpanExporter::builder()
    .with_http()
    .with_endpoint("https://otlp.autter.dev/v1/traces")
    .with_headers(HashMap::from([(
        "authorization".into(),
        format!("Bearer {}", std::env::var("AUTTER_RUNTIME_KEY")?),
    )]))
    .build()?;

Python, Java, .NET, or anything else

Standard OpenTelemetry environment variables work with every SDK:

OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.autter.dev
OTEL_EXPORTER_OTLP_HEADERS="authorization=Bearer ${AUTTER_RUNTIME_KEY}"
OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf
OTEL_SERVICE_NAME=payments-api
OTEL_RESOURCE_ATTRIBUTES=service.version=${GIT_SHA},deployment.environment=production
OTEL_TRACES_SAMPLER=parentbased_traceidratio
OTEL_TRACES_SAMPLER_ARG=0.01

Errors surface as issues when spans carry exception events (every SDK’s record_exception / RecordError does this) or ERROR status. Warnings (any language): add an autter.severity attribute to the exception event — "fatal" | "error" | "warning" | "info" (default error; the Node SDK’s crash marker autter.unhandled: true implies fatal). Warnings share the errors table with a severity column, so they group and aggregate identically:

span.record_exception(err)  # or add_event("exception", {...})
span.set_attribute("autter.severity", "warning")

Sampling guidance (all stacks)

Errors are always worth sending; keep successful-trace sampling at ~1% (OTEL_TRACES_SAMPLER_ARG=0.01). Request/usage metrics are derived server-side from spans and the http.server.duration histogram — no extra setup.

No @autter/* package for your language?

Send telemetry with just an OpenTelemetry SDK, a Collector, or a hand-rolled HTTP request.

Get started

Guides

Reference

Stack integrations

React / SPA / static sites

Node.js (Express, Fastify, Koa, NestJS)

Next.js

Go

Rust

Python, Java, .NET, or anything else

Sampling guidance (all stacks)

No @autter/* package for your language?

​React / SPA / static sites

​Node.js (Express, Fastify, Koa, NestJS)

​Next.js

​Go

​Rust

​Python, Java, .NET, or anything else

​Sampling guidance (all stacks)

No @autter/* package for your language?

React / SPA / static sites

Node.js (Express, Fastify, Koa, NestJS)

Next.js

Go

Rust

Python, Java, .NET, or anything else

Sampling guidance (all stacks)