See every error before it sees you.

// option A — script tag (autoload, ~12 KB gzipped)
<script
  src="https://cdn.coderadar.app/v1/sdk.js"
  data-project="truecom"
  data-env="production"
  data-release="[email protected]">
</script>

// option B — npm package (typed, tree-shakable)
// $ pnpm add @coderadar/browser

import { init } from "@coderadar/browser";
init({
  dsn:         "https://[email protected]/12",
  project:     "truecom",
  environment: "production",
  release:     "[email protected]",
});

// captures unhandled errors, unhandled promise rejections,
// console errors, and (optionally) fetch breadcrumbs.

# 1. install
# $ pip install coderadar

# 2. init at process boot
import coderadar
import os

coderadar.init(
    dsn         = os.environ["CODERADAR_DSN"],
    project     = "veritize",
    environment = os.environ.get("ENV", "dev"),
    release     = os.environ.get("RELEASE_SHA"),
    sample_rate = 1.0,
    traces_sample_rate = 0.2,
)

# 3. unhandled exceptions auto-capture.
#    FastAPI / Flask / Django middleware available:
from coderadar.fastapi import CodeRadarMiddleware
app.add_middleware(CodeRadarMiddleware)

// 1. install
// $ go get github.com/RelayOne/coderadar/sdks/go/coderadar

// 2. init at main()
package main

import (
    "os"
    "github.com/RelayOne/coderadar/sdks/go/coderadar"
)

func main() {
    client, _ := coderadar.NewClient(coderadar.Config{
        DSN:         os.Getenv("CODERADAR_DSN"),
        Project:     "relaygate",
        Environment: os.Getenv("ENV"),
        Release:     os.Getenv("RELEASE_SHA"),
        SampleRate:        1.0,
        TracesSampleRate:  0.2,
    })
    defer client.Flush()

    // net/http auto-wrap; chi / gin / echo helpers in submodules
    handler := coderadar.WrapHandler(yourMux)
    http.ListenAndServe(":8080", handler)
}

// trace = collection of spans sharing trace_id
{
  "trace_id": "b7f3a44d8e21c3d201",
  "spans": [
    {
      "span_id":    "5a2c",
      "parent_id":  null,
      "name":       "GET /api/billing/invoices",
      "start":      "...:08.150Z",
      "end":        "...:08.421Z",
      "attributes": { "http.status_code": 500, "http.route": "/api/billing/invoices" }
    },
    {
      "span_id":    "5a2d",
      "parent_id":  "5a2c",
      "name":       "db.query: select * from invoices...",
      "start":      "...:08.180Z",
      "end":        "...:08.395Z",
      "attributes": { "db.system": "postgresql", "db.statement": "SELECT ..." }
    },
    {
      "span_id":    "5a2e",
      "parent_id":  "5a2c",
      "name":       "render: dashboard.Errors",
      "start":      "...:08.398Z",
      "end":        "...:08.421Z",
      "events": [
        { "name": "exception", "event_id": "ev_01HZRX4D2KQ7" }
      ]
    }
  ]
}

// up to 100 breadcrumbs are attached to each captured event
[
  { "t": "...:08.041Z", "category": "navigation", "message": "/dashboard → /dashboard/billing" },
  { "t": "...:08.085Z", "category": "http",       "data": { "method": "GET", "url": "/api/billing/invoices", "status": 500 } },
  { "t": "...:08.140Z", "category": "console",    "level": "warn", "message": "Falling back to cached invoices" },
  { "t": "...:08.205Z", "category": "ui.click",   "data": { "target": "button.retry", "text": "Retry" } },
  { "t": "...:08.298Z", "category": "http",       "data": { "method": "GET", "url": "/api/billing/invoices", "status": 500 } },
  { "t": "...:08.420Z", "category": "render",     "message": "Errors.tsx unmount → mount with empty rows" }
]
// Categories: navigation, http, console, ui.click, ui.input, render, custom.*

# YAML — checked into the project repo, applied by `coderadar alerts apply`
# Or configure in the dashboard at /alerts/new

version: 1
project: truecom

rules:
  - name:     fatal_in_production
    when:     level:fatal env:production
    threshold: count > 0 in 1m
    channels: [slack-prod, email-eric]
    cooldown: 5m

  - name:     spike_any
    when:     level:error
    threshold: count > 50 in 5m
    group_by: [project]
    channels: [slack-prod]

  - name:     new_fingerprint
    when:     fingerprint:new env:production
    channels: [slack-prod]

channels:
  - id: slack-prod
    type: slack
    webhook: ${SLACK_WEBHOOK_URL}
  - id: email-eric
    type: email
    to:   [[email protected]]

import { Hono } from "hono";
import { honoMiddleware } from "@coderadar/sdk/hono";

const app = new Hono();
app.use("*", honoMiddleware({
  project: "relayone",
  release: process.env.RELEASE_SHA,
}));

app.get("/api/me", async (c) => {
  const u = await getUser(c);   // throws? auto-captured.
  return c.json(u);
});

from fastapi import FastAPI
from coderadar.fastapi import CodeRadarMiddleware
import coderadar
import os

coderadar.init(
    dsn=os.environ["CODERADAR_DSN"],
    project="veritize",
    release=os.environ.get("RELEASE_SHA"),
)

app = FastAPI()
app.add_middleware(CodeRadarMiddleware)

# manual capture inside a handler
from coderadar import capture_exception, capture_message, set_user

@app.get("/billing/{id}")
async def billing(id: str):
    try:
        return await get_invoice(id)
    except InvoiceMissing as e:
        capture_exception(e, tags={"invoice_id": id})
        raise

package main

import (
    "github.com/go-chi/chi/v5"
    "github.com/RelayOne/coderadar/sdks/go/coderadar"
    "github.com/RelayOne/coderadar/sdks/go/coderadar/chimid"
)

func main() {
    coderadar.NewClient(coderadar.Config{
        DSN: os.Getenv("CODERADAR_DSN"),
        Project: "relaygate",
    })

    r := chi.NewRouter()
    r.Use(chimid.Middleware())  // captures panics + 500s
    r.Get("/healthz", healthz)
    http.ListenAndServe(":8080", r)
}

// every SDK exposes capture* helpers

// node / browser
import { captureException, captureMessage, setUser, addBreadcrumb } from "@coderadar/sdk";

setUser({ id: user.id, segment: user.tier });
addBreadcrumb({ category: "checkout", message: "opened cart" });

try {
  await finalizeCheckout(cart);
} catch (err) {
  captureException(err, { tags: { stage: "checkout" } });
  throw err;
}

captureMessage("Inventory desync detected", { level: "warning" });

# every SDK reads these env vars by default

CODERADAR_DSN="https://[email protected]/12"
CODERADAR_PROJECT="truecom"            # or set in init() — env var wins
CODERADAR_ENVIRONMENT="production"     # dev | staging | production | preview-* | ...
CODERADAR_RELEASE="[email protected]"    # SHA or semver tag
CODERADAR_SAMPLE_RATE="1.0"            # 0.0–1.0 — errors
CODERADAR_TRACES_SAMPLE_RATE="0.2"     # 0.0–1.0 — traces
CODERADAR_DEBUG="false"               # SDK self-logging
CODERADAR_BUFFER_SIZE="1048576"        # bytes, server SDKs only
CODERADAR_FLUSH_INTERVAL="5000"        # ms

# dual-accept legacy CODEWATCH_* env vars (90-day window)
CODEWATCH_DSN=# still accepted; logs deprecation warning at boot

# the coderadar CLI
$ pnpm add -g @coderadar/cli

# list projects you can see
$ coderadar projects list

# tail events from one project
$ coderadar tail --project=truecom --level=error

# upload a sourcemap manually
$ coderadar sourcemaps upload \
    --project=truecom \
    [email protected] \
    --file=dist/static/js/main.abc123.js.map

# apply alert rules from a YAML file
$ coderadar alerts apply --file=.coderadar/alerts.yaml

# open a project in the dashboard
$ coderadar open truecom