← All sessions, cheat sheets & labs
Week 5 · Field guide · Observability

Helicone

Proxy-based observability: change one line, the base URL, and get logging, cost and latency dashboards, caching, and rate limiting.

proxy observabilityopen source1-line integration

What it is

Observability through a proxy.

Helicone routes your model calls through its proxy: you change the base URL, and every request flows through Helicone on the way to the provider. From that vantage point it gives you logging, cost and latency dashboards, caching, and rate limiting, all with near-zero code change. There is no SDK to weave through your call sites, just a different endpoint and an auth header.

The one job

Instant observability from one line.

Change one thing, the base URL, and you have logging and cost and latency dashboards immediately. It is the lowest-friction way to start seeing your traffic.

Reach for it when

Skip it when

A minimal look

One line: the base URL.

import OpenAI from "openai";

// the ONLY change: point the client at Helicone + add an auth header
const openai = new OpenAI({
  baseURL: "https://oai.helicone.ai/v1",
  defaultHeaders: { "Helicone-Auth": `Bearer ${process.env.HELICONE_KEY}` },
});

const res = await openai.chat.completions.create({
  model: "gpt-4o", messages,
});                                       // logged, priced, cacheable

The principle it teaches

Course principle

The cheapest observability is the one you actually turn on. Helicone is low-friction visibility for Session 10: if a one-line change is all that stands between you and a dashboard, you will do it, and having some traces beats having none.

Where it fits your labs

This is a Week 5 tool. When you want cost and latency numbers on your Lab 5 agent before investing in full tracing, Helicone gets you a dashboard in one edit.

Use in
Week 5, for fast cost and latency visibility on your lab agents.
week 5
Pairs with
Your OpenAI client: set the baseURL to Helicone and add the auth header.