Integration

Taren in Minuten in deine App integrieren

Verbinde deine Web‑ oder Backend‑Apps mit Taren und schicke Fehler, Stacktraces und Kontext direkt in ein zentrales Kanban‑Board für dein Team.

Leichtes SDK

Installiere das SDK in deinem Frontend oder Backend und sende Fehler mit einem einzigen Funktionsaufruf.

Einfache REST‑API

Ideal für bestehende Services und Worker: Schicke JSON‑Payloads direkt an die Taren‑API.

Automatische Tickets

Fehler werden gruppiert, kategorisiert und als Tickets im Kanban‑Board angelegt – bereit für dein Team.

Backend‑Integration (Node)

Fange Exceptions in deinem Server auf und sende sie direkt an Taren – inklusive Kontext wie URL und User.

import { Taren } from "@taren/node";

const taren = new Taren({
  apiKey: process.env.TAREN_API_KEY!,
  environment: process.env.NODE_ENV || "development",
});

app.use(async (err, req, res, next) => {
  await taren.captureError(err, {
    url: req.originalUrl,
    method: req.method,
    userAgent: req.headers["user-agent"],
    userId: req.user?.id,
  });

  res.status(500).json({ message: "Internal server error" });
});

REST‑API Beispiel

Wenn du kein SDK nutzen möchtest, kannst du Fehler einfach per HTTP‑Request an die API senden.

POST https://api.taren.dev/v1/errors
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "message": "Unhandled exception in /checkout",
  "stack": "Error: ...",
  "environment": "production",
  "context": {
    "url": "https://your-app.com/checkout",
    "userId": "1234",
    "userAgent": "Mozilla/5.0",
    "release": "v1.2.3"
  }
}

Sicher integriert

Taren läuft als gehosteter Dienst – API‑Keys sind projektbasiert, Environments trennbar und können jederzeit rotiert werden.

  • API‑Keys pro Projekt und Environment
  • Rate‑Limiting und Schutz vor Missbrauch
  • Optionale Anonymisierung sensibler Daten

Best Practices

  • Nur relevante Errors senden, keine Debug‑Logs.
  • User‑Kontext so knapp wie nötig halten.
  • Release‑Versionen mitsenden, um Fehler Builds zuzuordnen.
  • Alerts in Slack/Teams verbinden, damit niemand Tickets verpasst.