Breadcrumb

Breadcrumb installiert sich als Code-Abhängigkeit, was heißt, dass es kein externes Konto und keinen Netzwerksprung für Ihre Trace-Daten gibt. Sie legen eine Instanz an, richten sie auf Ihre Datenbank aus, und sie läuft in Ihrem Prozess. Nichts verlässt Ihre Infrastruktur, außer Sie entscheiden anders. Keine Überraschungen. Für Teams mit strengen Datenregeln ist das oft der ausschlaggebende Punkt.

Die Spans werden in eine einzige Tabelle normalisiert, breadcrumb_spans, die in der Datenbank lebt, in die Ihre App ohnehin schreibt. Es ist kein Export, kein Webhook und keine Nur-Lese-API über das Schema eines anderen. Ihre Analysen werden zu gewöhnlichen Abfragen mit dem ORM, das Sie nutzen, sodass Sie Traces mit Nutzern, Bestellungen oder allem anderen verknüpfen können, was Sie speichern. Prisma-Nutzer etwa ziehen die Tabelle herein und behandeln sie wie jedes andere Modell.

Modellaufrufe instrumentieren sich selbst. Sie übergeben bc.telemetry() dort, wo das Vercel AI SDK experimental_telemetry erwartet, und Breadcrumb liest Modell, Anbieter, Token-Zahlen, Kosten und Nutzlasten aus Attributen, die das SDK bereits ausgibt. Es gibt keinen manuellen Span-Aufbau um jeden Aufruf. Das hält das Setup klein und macht es leichter, Tracing zu einem bestehenden Projekt hinzuzufügen, ohne es umzuschreiben.

Die Arbeit um die Modellaufrufe instrumentiert sich nicht selbst, also umschließen Sie sie mit bc.trace(). Retrieval, Tool-Aufrufe und der abschließende Datenbank-Schreibvorgang landen auf derselben Zeitleiste wie die Modell-Spans. Wenn sich eine Anfrage langsam anfühlt, sehen Sie, ob die Verzögerung im Retrieval, in einem Tool oder im Modell selbst liegt, statt zu raten.

Breadcrumb stellt Traces über MCP bereit, sodass ein Agent sie abfragen kann wie ein Entwickler. Sie können einem Coding-Agenten einen Schlüssel geben und ihn durch Produktions-Traces wühlen lassen, oder das Dashboard selbst lesen. Die Option hidePayloads hält rohe Prompts aus dem heraus, was der Agent sieht, was zählt, wenn Traces sensible Nutzereingaben enthalten.

Das Dashboard ist eine Komponente, kein festes SaaS-Bild. Ein gehostetes Werkzeug muss generisch bleiben, weil es die App aller bedient; Ihr eigenes muss nur Ihre bedienen. Sie montieren es hinter Ihrer eigenen Authentifizierung und können zusätzliche Panels als Seiten darin ausliefern. Diese Flexibilität ist schwer zu bekommen, wenn die Dashboard-Oberfläche auf der Domain eines anderen liegt und die App jedes Kunden bedienen muss.

Die Aufbewahrung ist ein Fenster, das Sie pro Umgebung festlegen und das durchgegangen wird, sobald Traces eintreffen. Nichts wird pro Ereignis gemessen, sodass Sie nie Nutzlasten samplen oder verwerfen müssen, nur um eine Rechnung klein zu halten. Sie entscheiden, wie lange Daten bleiben, und Sie behalten vollständige Traces, solange sie da sind.