2026-07-31T19:49:35.085Z
Datadog LLM Beobachtungsdokumentation: Abdeckung der Prüfungsinstrumente
Verwandeln Sie das aktuelle SDK und die Dokumentation zur automatischen Instrumentation von Datadog in einen achtfachen Audit für Kompatibilität, Startup, Probenahme, manuelle Lücken, Wartezeiten und verifizierte Ergebnisse.
Die nützliche Art, die Datadog LLM Beobachtbarkeitsdokumentation Es handelt sich um einen veränderten Instrumentationsvertrag, nicht um einen Beweis dafür, dass jeder wichtige Agentenschritt sichtbar ist. Bevor Sie einer Spur vertrauen, überprüfen Sie vier Dinge: Ihre Framework und Tracerversionen werden zusammen unterstützt, exakt ein Setup Pfad ist aktiv, die Probenahme bewahrt die für Gesundheitsentscheidungen erforderlichen Beweise und jeder äußere Effekt hat einen deterministischen Ergebnisergebnis. Diese Unterscheidung ist wichtig, weil eine scheinbar vollständige Spur immer noch eine benutzerdefinierte Datenbank schreiben, eine nicht unterstützte Integration, eine legitime Genehmigung warten oder ein fehlendes Ergebnis verbergen kann. Beginnen Sie mit dem Supportvertrag, nicht mit dem Dashboard. Datadog's Überblick über die Beobachtbarkeit von Agenten Das ist das richtige Modell, um Latenz, Fehler, Token Nutzung und den Weg durch einen Agent zu untersuchen. Es ist nicht ein Versprechen, daß eine willkürliche Anmeldung vollständig instrumentalisiert ist. Verweis auf automatische Instrumente Sie beschränkt die automatische Verfolgung auf unterstützte Frameworks und Bibliotheken. Es leitet die Betreiber explizit auf manuelle Instrumentation für andere API Anrufe, Datenbankfragen und interne Funktionen. Behandeln Sie die Dokumentation als vier verknüpfte Verträge: Vertrag Beweise zur Aufzeichnung Versagen, die eine grüne Spur verbergen kann Kompatibilität Laufzeit, Rahmenversion, Tracerversion, Modulmodus ununterstützten Code Pfad emittiert teilweise oder keine Spannungen Startup ein aktivierter Einstellungsmodus, Standort, Anwendungsname, Transport duplizierte Initialisierung oder Daten, die an das falsche Ziel gesendet wurden Abdeckung die Stichprobenpolitik und ein Manifest der Tätigkeiten, die sichtbar sein müssen ein erforderliches Gesundheitsereignis entnommen wird oder nie mit Instrumenten versehen wird Das Ergebnis Erwartungsbestätigung und Bestimmungsort spezifische Abschlussbestätigung der Vermittler meldet Vollendung, aber die gewünschte Wirkung fehlt Diese Verträge sollten mit einem datierten Dokumentations Snapshot überprüft werden. Am 30. Juli 2026 listete die Python Tabelle von Datadog LangGraph =0.2.23 mit ddtrace =3.10.1 Auf derselben Seite sind unterschiedliche Mindestwerte für andere Frameworks und Sprachen aufgeführt. Wir haben das neueste Paket installiert ist daher schwächer als Dieses genaue Anwendungs /Tracer Paar erfüllt die geprüfte Unterstützungszeile. Die Verweis auf die SDK fügt eine weitere Grenze hinzu: Python Befehlszeilen Setup mit ddtrace run und In Code Einstellung mit LLMObs.enable() In diesem Abschnitt wird gewarnt, sie nicht zu kombinieren. DD LLMOBS SAMPLE RATE , was bedeutet, dass die Aufbewahrung von Spuren eher eine Entscheidung des Betreibers als eine inhärente Gesundheitsgarantie ist. Durchführung eines Instrumentationsaudits in acht Fällen Das Auditgerät fixiert eine Supportzeile Python, LangGraph 0.2.23 und ddtrace 3.10.1 dann ändert sich pro Fall eine operative Tatsache. instrumentation cases.json und erweitert seine cases Array mit den acht Bedingungen, die durch die aufgezeichnete Ausgabe beschrieben werden: Verwenden Sie diese Entscheidungsregel in audit datadog instrumentation.mjs Das heißt: Durchführung der Prüfung: Die aufgezeichnete Strecke bewertete acht Spielen und entsprach allen acht erwarteten Urteilen: Die Reihenfolge der Kontrollen ist bewusst. Kompatibilität kommt zuerst, weil eine fehlende Spanne aus einem nicht unterstützten Paar nicht als Applikationsfehler diagnostiziert werden sollte. Startup kommt als nächstes, weil zwei Setup Wege einen zweideutigen Sammelzustand erzeugen. Abdeckung folgt, weil ein richtig initialisierter Tracer immer noch erforderliche Beweise auslassen kann. Warte und Ergebniskontrollen kommen zuletzt, weil sie die Arbeit beschreiben, nicht den Telemetrie Transport. Das ist ein Konfigurations und Beweisvertragsaudit. nicht Schicken Sie einen Canary Run und bestätigen Sie, dass die erwarteten Wurzel und Kindstrecken unter der beabsichtigten Anwendung, Standort, Umgebung und Zeitfenster angezeigt werden. Eine Entscheidung über die Abdeckung der Probenahme zu treffen Datadog dokumentiert eine konfigurierbare Agent Observability Sample Rate. Sampling ist nützlich, wenn vollständige diagnostische Spuren teuer sind, aber es schafft eine strenge operative Konsequenz: Das Fehlen eines geprobten Spuren kann nicht das Fehlen eines Laufs, eines Tool Calls oder eines Ausfalls beweisen. Wenn Gesundheitsentscheidungen jeden Lauf abdecken müssen, müssen zwei Beweiswege vorhanden sein: 1. Diagnostische Spuren Sie behalten reichhaltige Spannungsdetails für Untersuchungen. 2. Pflichtige Krankenüberprüfungen Sie verzeichnen die Identität, den Zustand, die Frische, den Wartungsbesitz, den erwarteten Bestimmungsort und den Status der Ergebnisprüfung. Das Gerät kehrt zurück coverage gap wenn sampleRate ist unten 1 Die richtige Schlussfolgerung ist schmaler: Die verfügbaren Beweise können einen Allgemeinen Gesundheitsanspruch nicht unterstützen. Dies verhindert auch einen häufigen Warnfehler. Eine fehlende Stichprobe sollte einen Betreiber nicht als Ausfall bezeichnen. Vergleichen Sie zunächst die nicht geprobte Laufrechnung, den Laufzeitschlag und die Frische der Sammlung. Eskalieren Sie nur, wenn die Beweise einen für den Benutzer relevanten Fehler belegen oder nach einer ausdrücklichen Frist nicht verfügbar bleiben. Fügen Sie manuelle Spannungen an den Wirkungsgrenzen hinzu Automatische Instrumentation ist ein Ausgangspunkt, nicht eine Karte Ihres Geschäftsergebnisses. write release manifest Das Modell und die Werkzeuglänge können normal abgeschlossen werden, während die letzte Funktion stillschweigend fehlt. Erstellen Sie vor dem Einsatz ein kleines Operationsmanifest: Die Prüfungserklärungen instrumentation gap wenn eine erforderliche Operation keine automatische oder manuelle Abdeckung hat. Sie können dies nicht reparieren, indem Sie jeder Hilfsfunktion Spannings hinzufügen. Instrumentengrenzen, die die Entscheidung des Betreibers ändern: Anrufe über Dienste, dauerhafte Schreibungen, Berechtigungsprüfungen, Genehmigungsüberschreitungen, Wiederversuche mit externen Effekten und Bestimmungsortprüfung. Für eine Datei überprüfen Sie den erwarteten Pfad und verdauen Sie ihn. Für eine Pull Anfrage fragen Sie den Hosting Dienst nach PR und erforderlichen Überprüfungen. Für eine Nachricht behalten Sie den akzeptierten Identifikator des Anbieters und vereinbaren die Lieferung, wenn der Workflow dies erfordert. Span endete ohne Fehler ist Aktivitätsnachweis; es ist nicht das gleiche wie das gewünschte Ergebnis existiert. Haltet die Wartezeit bei, anstatt sie falsch als stecken zu markieren. Einige sind Fehler, andere sind richtige Wartezeiten auf eine Person, einen Anbieter oder ein geplantes Fenster. Eine rechtmäßige Wartezeit braucht eine kleine Quittung: Ohne Eigentümer, Frist und Wiederaufnahme Identität kehrt das Gerät zurück ambiguous wait Es kehrt nicht sofort zurück . stuck Mit einem gültigen Empfang kann die Überwachung bis zur Frist ruhig bleiben, die Anfrage an die richtige Person weiterleiten und später überprüfen, dass die Arbeit wieder aufgenommen wurde. Diese Unterscheidung verhindert, dass Betreiber gesunde Arbeiten wiederherstellen, indem sie sie erneut ausprobieren. Ein unsicherer erneuter Versuch an einer Grenze der externen Wirkung kann doppelte Tickets, Nachrichten, Zahlungen oder Bereitstellungen erzeugen, auch wenn der ursprüngliche Lauf lediglich auf Bestätigung wartete. Lesen Sie die Datadog Folge und die Ergebnisbestätigung zusammen Verwenden Sie die Datadog Spur, um zu antworten: Sind die erwarteten Rahmen und Modellanrufe aufgetaucht? Welche Spannung scheiterte, verlangsamte sich oder verbrauchte ungewöhnliche Token? Hat der Spurenbaum die erwartete Eltern Kind Struktur bewahrt? Ist der Beweis frisch und mit der beabsichtigten Anwendung verbunden? Verwenden Sie die separate Krankenbestätigung, um zu antworten: War der Lauf zu dieser Zeit erwartet? Wirkt es, wartet es, steckt es fest, ist es unsicher oder ist es vollständig? Haben alle erforderlichen Effekte einmal aufgetreten? Ist das Ziel das versprochene Ergebnis? Die endgültige Anlage ist absichtlich unbequem: der Spurenweg wird unterstützt, die Einrichtung ist sauber, die Probenahme ist abgeschlossen und kein Betrieb fehlt. complete Das Urteil lautet: false green Ich weiß nicht . Das ist die Grenze zu halten. Datadog kann detaillierte Spuren, Bewertung, Latenz, Fehler und Token Beweise liefern. Ihre Anwendung muss immer noch definieren, was Erfolg bedeutet und überprüfen, wo das Ergebnis lebt. Sidewisp wendet in seiner Produktrichtung die gleiche Unterscheidung nach Gesundheit an: Aktivität ist kein nützlicher Fortschritt, Warten ist nicht automatisch fest, und Befehlsvollständigung ist kein verifiziertes Ergebnis. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Seine Produktionsüberwachungsadapter werden heute im Allgemeinen nicht versandt; der öffentliche Standort ist ein Early Access Erlebnis und eine Produktdemonstration. Die praktische Roll out Sequenz ist kurz: Stecken Sie das Dokumentationsdatum ein, registrieren Sie die Support Reihe, wählen Sie einen Startweg, erklären Sie die Probenahmegrenze, listen Sie die erforderlichen Effektoperationen auf, wiederholen Sie die acht Bilder, senden Sie dann einen Live Canary und überprüfen Sie sein Ziel. Nur nachdem alle diese Quittungen zustimmen, sollte eine grüne Spur zu einem grünen Agenten Gesundheitsurteil werden.