Vercel Daemons können OpenTelemetry-Traces an Vercel Tracing senden

Vercel Daemons können jetzt OpenTelemetry-Traces an Vercel Tracing senden. Dadurch erscheinen Vorgänge von Hintergrund-Workern in derselben Trace-Ansicht wie der Rest eines Projekts. Die Integration ermöglicht es Agenten außerdem, Daemon-Spans über die Vercel CLI zu suchen und die Ergebnisse als JSON zu erhalten.
- Vercel Daemons können OpenTelemetry-Traces an Vercel Tracing exportieren.
- Jeder Daemon erhält einen Unix-Socket für OTLP/HTTP-Traces.
- Version 2.3.0 oder höher von @vercel/otel aktiviert den automatischen Export für Node.js-Daemons.
- Die Vercel CLI kann Traces nach Projekt- und Servicenamen durchsuchen.
- Suchergebnisse können für Agenten als JSON zurückgegeben werden.
Tracing für Vorgänge von Hintergrund-Workern
Vercel zufolge können seine Daemons jetzt Traces an Vercel Tracing senden. Dadurch können Entwickler und ihre Agenten die von Hintergrund-Workern ausgeführten Vorgänge zusammen mit den übrigen Traces eines Projekts untersuchen.
Für den Empfang der Daten stellt Vercel jedem Daemon einen Unix-Socket für OTLP/HTTP-Traces bereit. Der Pfad zu diesem Socket wird in der Umgebungsvariable VERCEL_OTEL_SOCKET_PATH gespeichert. Damit erhält der Daemon einen eigenen Kanal, über den er die von seinem Worker aufgezeichneten Spans exportieren kann.
Node.js-Einrichtung verwendet @vercel/otel
Bei Node.js-Daemons aktiviert ein Upgrade von @vercel/otel auf Version 2.3.0 oder höher den automatischen Trace-Export mit der Standardkonfiguration. Laut Vercel erkennt das SDK den Socket und sendet die Spans des Workers an Vercel.
Das Beispiel von Vercel initialisiert OpenTelemetry, bevor der Worker startet:
import { registerOTel } from '@vercel/otel';
registerOTel({ serviceName: 'my-daemon' });
Im Beispiel wird der Servicename my-daemon festgelegt. Über ihn können anschließend die Traces des Daemons gesucht werden.
Daemon-Spans mit der Vercel CLI suchen
Die daraus entstehenden Spans sind über die Vercel CLI verfügbar. Laut Vercel kann die CLI innerhalb eines Projekts nach dem Servicenamen suchen und die Ergebnisse für Agenten als JSON zurückgeben.
Die Dokumentation enthält folgenden Befehl:
vercel traces search --project my-project --service my-daemon --json
Vercel zufolge durchsucht dieser Befehl die Daemon-Spans der vergangenen Stunde und gibt sie als JSON aus. Die Funktion verbindet die Trace-Erfassung mit Befehlszeilen-Workflows. Dadurch lässt sich die Aktivität von Hintergrund-Workern in einem Format abrufen, das Agenten verarbeiten können.
Vercel: Daemons can now send traces to Vercel Tracing


