Vercel Daemons senden Traces jetzt direkt an Vercel Tracing

Die Meldung

Am 13. November 2026 hat Vercel im Changelog angekündigt, dass Vercel Daemons jetzt OpenTelemetry-Traces direkt an Vercel Tracing senden können. Nach Vercels Worten können Sie und Ihre Agenten so die Abläufe von Hintergrundprozessen neben den übrigen Traces Ihres Projekts ansehen. Der Beitrag stammt von Gal Schlezinger, Softwareingenieur im Infrastruktur-Team von Vercel. Er ist mit einer Minute Lesezeit angegeben. Er ist kurz, aber die Angaben sind konkret.

So funktioniert es

Die Ankündigung beschreibt drei Schritte. Erstens stellt Vercel jedem Daemon einen Unix-Socket bereit, der Traces im Format OTLP/HTTP empfängt, und setzt den Pfad dieses Sockets in der Umgebungsvariablen VERCEL_OTEL_SOCKET_PATH. Zweitens aktualisiert man @vercel/otel auf Version 2.3.0 oder neuer. Mit dieser Version exportieren Node.js-Daemons mit der Standardkonfiguration ihre Traces automatisch: Das SDK erkennt den Socket und sendet die Spans, die der Prozess aufzeichnet, an Vercel. Drittens initialisiert man OpenTelemetry, bevor der Prozess startet. Das offizielle Beispiel besteht aus zwei Zeilen in worker.ts. Es importiert registerOTel und ruft es mit dem serviceName 'my-daemon' auf. Den Dienstnamen wählt man selbst.

So liest man die Daten

Die Spans sind über die Vercel-CLI abrufbar. Der Befehl in der Ankündigung lautet vercel traces search, mit --project für das Projekt, --service für den Dienst und --json für die Ausgabe als JSON. Vercel erklärt, man könne innerhalb eines Projekts nach Dienstnamen suchen und JSON für die eigenen Agenten erhalten. Die Beschriftung des Beispiels sagt, dass es die Daemon-Spans der letzten Stunde sucht. Der Beitrag endet mit einem Link zur Dokumentation des Daemon-Tracings. Für alles, was darüber hinausgeht, ist die Dokumentation maßgeblich.

Warum das nützlich ist

Dieser Abschnitt ist unsere Lesart und nicht der Text der Ankündigung. Ein Hintergrundprozess hat keine Seitenanfrage als klaren Einstiegspunkt. Wenn er sich falsch verhält, bleiben Entwicklern oft nur Logs. Ein Trace zerlegt einen Vorgang in zeitlich bemessene Spans, sodass man sieht, welcher Schritt die Zeit verbraucht hat. Der praktische Wert der Änderung liegt darin, dass die Spans der Daemons am selben Ort erscheinen wie die übrigen Traces des Projekts. Man baut keinen eigenen Sammelweg auf und muss nicht entscheiden, wohin die Daten gehen, denn die Plattform gibt den Pfad über eine Umgebungsvariable vor und das SDK findet ihn. Die Spans gehen über einen lokalen Unix-Socket an den Vercel-Tracing-Dienst, ein Daemon braucht also keine eigene externe Adresse für einen Collector. Der Beitrag geht darauf nicht ein, wir nennen es nur als allgemeine Anmerkung.

Ein zweiter Punkt ist die Eignung für Agenten. Der Beitrag sagt, die CLI könne JSON für Agenten liefern. Einen Coding-Agenten oder Betriebs-Agenten die Daemon-Spans der letzten Stunde abfragen zu lassen, ist also ein Einsatz, den Vercel selbst vorsieht. Das passt zu einem breiteren Trend: Plattformen öffnen ihre Observability-Daten für automatisierte Werkzeuge.

Grenzen, die man kennen sollte

Die Ankündigung sagt nur, dass Node.js-Daemons mit der Standardkonfiguration ihre Traces automatisch exportieren, und verlangt @vercel/otel ab Version 2.3.0. Zu anderen Laufzeiten, eigenen Konfigurationen, Sampling, Aufbewahrung oder Preisen sagt sie nichts, und wir raten nicht. Schauen Sie in die Dokumentation, wenn Sie diese Antworten brauchen. Der Beitrag nennt auch nicht, ob die Funktion für alle Tarife gilt oder ob der Daemon selbst eine Mindestversion verlangt. Prüfen Sie beides, bevor Sie sich darauf verlassen. Das Beispiel betont, dass OpenTelemetry vor dem Prozess starten muss. Es ist naheliegend, dass früher ausgeführte Arbeit unerfasst bleiben kann, doch der Beitrag nennt die Folge nicht.

Fazit

Es ist ein kleines, praktisches Update. Bei einem Node.js-Daemon mit Standardkonfiguration und plattformseitigem Unix-Socket aktualisieren Sie @vercel/otel auf 2.3.0 oder neuer, rufen Sie registerOTel vor dem Start des Prozesses auf, und die Spans des Daemons erscheinen in Vercel Tracing, wo vercel traces search sie als JSON zurückgeben kann. Für Teams, die bereits Hintergrundaufgaben auf Vercel Daemons betreiben, ist der Aufwand gering, und die Funktion ist einen Versuch wert.