2026-08-01T12:22:35.126Z

PostHog LLM Beobachtbarkeit: Testen Sie den Schlüssel zum Zusammenschluss

Vergleichen Sie Frontend-Sitzungen, AI-Sitzungen und dauerhafte Arbeits-IDs über Wiederversuche und gleichzeitige Aufgaben hinweg, und legen Sie dann Attributionsfehler mit HogQL auf.

Die PostHog LLM Beobachtbarkeit benötigt einen bewussten Join Schlüssel, sobald die Agentarbeit erneut versuchen, eine Browser Sitzung verlassen oder eine Sitzung mit einer anderen Aufgabe teilen kann. $session id , $ai session id und $ai trace id sind nützlich, aber keine sind automatisch die Identität der angenommenen Arbeit. In einem 14 Event Experiment erzeugte die Gruppierung durch die Frontend Sitzung zwei kombinierte Gruppen und zwei falsche Generation zu Ergebnis Paarungen. Die Gruppierung nach der AI Sitzung teilte eine erneut geprüfte Aufgabe in zwei Sitzungen auf und produzierte trotzdem eine falsche Pairing. Ein langlebiger work id verband alle drei erwarteten überprüften Ergebnisse zusammen, bewahrte den erneuten Versuch als eine Aufgabe und isolierte eine Fehlarbeit als Waisenbestätigung, anstatt sie an eine gesunde Spur zu binden. Die Betriebsregel ist spezifisch: Nutzung von PostHog Sitzungen für Navigation und Aggregation, Spuren für kausalen Modellaktivität und ein sicherer für die Privatsphäre work id für die Einheit, die schließlich ein Ergebnis erzeugen muss. Dann stellen Sie diese Felder zusammen ab. So werden Spuren, Kosten und Produktanalysen zu einem Evidenzvertrag und nicht zu einer losen Sammlung von Dashboards. Vier Identifikatoren beantworten vier verschiedene Fragen Die AI Spurenmodell von PostHog benötigt $ai trace id für AI Beobachtungsereignisse. Eine Spurengruppe bezieht sich auf Generationen und Spannungen. Die Antwort lautet: Welches Modell und welche Werkzeugaktivität gehörten zu dieser Interaktion? Die AI Sitzungsleitfaden definiert $ai session id als eine optionelle, anwendungsorientierte Gruppierung über Spuren hinweg. Es kann einen Workflow, einen Thread, ein Gespräch oder eine andere logische Grenze darstellen. Der gleiche Leitfaden unterscheidet es vom Standard Frontend $session id , der in der Regel im Browser erfasst wird. PostHog verwendet distinct id auch, um Ereignisse mit einer Person oder einer Dienstidentität zu verbinden. Das gibt die Antwort, wer oder was das Ereignis ausgesendet hat; es sollte nicht mit einem Aufgabenidentifikator überlastet werden. Eine akzeptierte Einheit von Agentenarbeit benötigt eine vierte Identität: Identifizierungszeichen Gute Grenze Ausfall bei Verwendung als Arbeitsschlüssel distinct id Person, Konto oder Dienstleistung Ein Schauspieler kann viele Aufgaben gleichzeitig besitzen. $session id Besuch im Vorfeld Hintergrundarbeit kann sie überleben; ein Besuch kann mehrere Aufgaben beginnen $ai session id Anwendungsdefinierte AI Sitzung Ein Neuerversuch oder Neustart kann eine weitere Sitzung erstellen $ai trace id Ein Ursache Spur Fragmente mit mehreren Spuren auf Wiederholungen und Übergaben work id Eine akzeptierte Aufgabe und ihr Ergebnis Sie müssen durch die Anwendung erzeugt und verbreitet werden Erstellen Sie work id , wenn das System die Aufgabe akzeptiert, vor dem ersten Modellruf. Machen Sie es unsichtbar und stabil. Es sollte einen erneuten Versuch überleben, Arbeiter neu starten, Genehmigung warten, Browser schließen und Modellwechsel. Nehmen Sie es nicht aus einer E Mail Adresse, einem Anruf, einem Pfad oder einem Zielnamen ab. PostHogs Generationsdokumentation definiert das Ereignismodell der Generation. Sein Dokumentation über die Zölle Eigenschaften zeigt JavaScript Wrapper Beispiele mit posthogProperties und posthogDistinctId an, während der Sitzungsleitfaden $ai session id als eine anwendungsberechtigte Gruppierung dokumentiert. Die über das npm latest Tag beobachtete Paketversion war @posthog/ai 8.4.0 am 27. Juli 2026; betrachten Sie dies als einen datierten Snapshot und überprüfen Sie die aktuelle Dokumentation für Ihren Anbieter und die installierte Version. Reproduzieren Sie das 14 Event Join Key Experiment Das Gerät enthält fünf akzeptierte Arbeits IDs und eine absichtlich falsche Ausgangs ID. Es modelliert drei Fehlerformen, die nur in Sitzungs Dashboards oft verborgen sind: 1. work 102 beginnt in der Browser Sitzung browser b , versucht nach dem Verschwinden des Frontend Kontexts erneut und setzt unter einer neuen AI Sitzung fort. Das bestätigte Ergebnis kommt mit work id , aber keine Sitzungs IDs. 2. work 103 und work 104 starten innerhalb derselben Browser Sitzung. Nur work 103 hat ein überprüftes Ergebnis, work 104 hat ein Produktereignis, aber kein Ergebnis. 3. work 105 vollendet unter AI Session ai run d , aber ein späteres Ergebnis Ereignis trägt work 999 , während die gleichen Frontend und AI Session Werte erhalten. Das sind keine synthetischen Namens Tricks. Sie repräsentieren häufige Topologieänderungen: ein Hintergrundversuch, gleichzeitige Aufgaben aus einem Besuch und ein Ereignis, dessen Korrelationsmetadaten nicht übereinstimmen. Ich habe die PostHog förmigen Ereignisse in eine SQL Tabelle geladen und drei Strategien ausgewertet. Eine Strategie erhält nur Anerkennung, wenn eine Gruppe sowohl eine Generation als auch das erwartete Ergebnis für dieselbe Arbeit enthält. Es erfasst ein falsches Paar, wenn eine Generation für eine Arbeits ID eine Gruppe mit einem Ergebnis für eine andere teilt. Das gemessene Ergebnis war: Korrelationsstrategie Korrekt geprüfte Arbeiten Verpasste erwartete Arbeit Vermischte Gruppen Falsche Paare Fragmentierte Wiederversuche : : : : : Frontend $session id 2 von 3 1 2 2 0 $ai session id 2 von 3 1 1 1 1 Dauerhafte work id 3 von 3 0 0 0 0 Die Frontend Sitzung schloss work 103 mit work 104 und schloss work 105 mit dem falschen work 999 Ergebnis zusammen. Die AI Sitzung Joining vermied die gleichzeitige Browser Kollision, aber work 102 aufgeteilt ai run b1 und ai run b2 ; sein Ergebnis hatte keine AI Sitzung zu befestigen. Zudem wurde work 105 auf work 999 übertragen, da beide ai run d trugen. Die work id Abfrage ergab sechs Reihen: fünf akzeptierte Arbeitsbereiche plus work 999 . Diese sechste Reihe hatte nur ein Ergebnis und keine Generationen. Anstatt work 105 grün zu machen, enthüllte die Abfrage ein Waisenergebnis. Erstellen Sie die Arbeitsmatrix in HogQL PostHog dokumentiert SQL Zugriff als HogQL, ein Umschlag um ClickHouse SQL mit vereinfachtem Event Property Zugriff. Ereignis Eigenschaften verwenden Punktennotation, einschließlich Dollar Präfix PostHog Eigenschaften. Zu den unterstützten Aggregationen gehören countIf , uniqExactIf und groupUniqArray . Diese Abfrage erstellt eine Zeile pro langlebigen Arbeitsschlüssel: Die SQL Leitfaden für PostHog zeigt die events Tabelle, den Zugriff auf Eigenschaften, SQL Insights und die HogQLQuery API Form. Die Aggregationsreferenz listet die hier verwendeten bedingten und exakten Einzigartigkeitsfunktionen auf. Interpretieren Sie die Zeilenform vor der Berechnung einer Punktzahl: generation count = 0 und outcome count 0 ist ein Waisenergebnis, keine verifizierte Arbeit. ai session count 1 kann ein legitimes Wiederversuch oder eine Übergabe sein; prüfen Sie retry count , bevor Sie es als Duplikat bezeichnen. frontend session count = 0 ist für Hintergrundarbeiten normal. product event count 0 zeigt das Produktverhalten und nicht die Bestimmungsortüberprüfung an. trace count 1 kann erwartet werden, wenn eine akzeptierte Aufgabe erneut versucht wird. Für work 102 berichtet die Matrix über zwei Spuren, zwei AI Sitzungen, einen erneuten Versuch und ein Ergebnis. Die Zeile bleibt intakt, weil der Arbeitsschlüssel beide Sitzungsänderungen überlebt hat. Das ist das zentrale Ergebnis des Experiments. Überprüfungskollisionen, bevor man einem Dashboard vertraut Eine Arbeitsmatrix zeigt, was erfolgreich gruppiert wurde. Bei einem Kollisions Audit wird gefragt, ob die alternativen Schlüssel unabhängige Arbeiten zusammengefasst hätten. Führen Sie das gegen Frontend Sitzungen aus: Wiederholen Sie es mit $ai session id . In der Feststellung stellt der Frontend Audit browser c mit work 103 und work 104 sowie browser d mit work 105 und work 999 zurück. Bei der Prüfung der AI Sitzung wird ai run d mit work 105 und work 999 zurückgegeben. Dies beweist nicht, welches Ereignis falsch ist. Es identifiziert eine Grenze, bei der die sessbasierte Zuteilung unsicher ist, und gibt dem Betreiber einen kleinen Untersuchungssatz. Fügen Sie eine zweite Prüfung in die andere Richtung hinzu: Zählen Sie die Anzahl der verschiedenen Sitzungswerte pro work id . Ein Arbeitsschlüssel mit zwei AI Sitzungen und einem erneuten Versuchsereignis ist wahrscheinlich Kontinuität zwischen den Versuchen. Ein Arbeitsschlüssel, der in vielen Sitzungen ohne Wiederversuch, Übergabe oder Weiterlauf auftaucht, kann auf Wiederverwendung hinweisen. Das Gerät und der Läufer sind absichtlich zu überprüfen. Der lokale Läufer führt eine SQL Arbeitsmatrix über alle 14 Ereignisse aus, evaluiert dann die drei Zusammenschlussstrategien und behauptet fünf Ergebnisse: Es ist kein Live PostHog Benchmark. Es misst nicht die Einnahme Latenz, die API Zulassungen für Abfragen, die Aufbewahrung oder die mieterspezifischen Eigentumstypen. Es testet die Beziehungsansprüche hinter dem Dashboard. Bevor Sie die Abfrage in der Produktion verwenden, laufen Sie sie als SQL Insight auf einem harmlosen Kanarien Set aus und vergleichen Sie die zurückgegebenen Spalten mit Ihrem Fixment. Instrument der Schlüssel ohne Leckage Aufgaben Inhalt Fügen Sie den gleichen unsichtbaren Arbeitsschlüssel an jedes relevante Ereignis an. In den unterstützten JavaScript Wrapper Beispielen dokumentiert die Custom Property Seite posthogProperties und posthogDistinctId , die Sitzungsseite stellt $ai session id innerhalb von posthogProperties und die Datenschutzseite dokumentiert posthogPrivacyMode . Wenn man diese dokumentierten Optionen kombiniert, sieht die Anfrageform aus wie folgt: Verwenden Sie die genauen Optionen, die von der Integration Ihres Anbieters und der installierten Version unterstützt werden. PostHogs Datenschutzmodus schließt $ai input und $ai output choices aus; es entsorgt keine willkürlichen, benutzerdefinierten Eigenschaften. Halten Sie eine Auflistung. Gute Felder sind unsichtbare IDs, Versuchsnummern, Workflow Versionen, Low Cardinality Zustände, Zeitstempel und Hashes. Schlechte Felder sind Anfragen, Abfüllungen, Geheimnisse, E Mails, Rohdateienpfade und Anbieter Nutzkosten. Veröffentlichen Sie Antragsereignisse mit demselben work id erst, nachdem die zugrunde liegende Tatsache vorliegt. Ein report view opened Ereignis gehört zur Produktanalyse. Ein agent outcome verified Ereignis sollte einem autorisierten Rücklesen folgen und einen hashigen Zielverweis plus den verifizierten Inhalt oder das Version Hash enthalten. Die beiden Ereignisse können eine Frage teilen, ohne vorzugeben, dass sie dasselbe bedeuten. Halten Sie distinct id stabil für den Schauspieler, den Sie analysieren möchten. Behalten Sie $session id und $ai session id für ihre dokumentierten Navigationsgrenzen. Das Modell wird einfacher zu debuggen, weil kein Feld drei Aufgaben erfüllt. Verwenden Sie das Experiment als Betriebstest Beginnen Sie mit drei Kanarien anstelle eines großen Dashboards: eine Aufgabe, die in einem Browser und einer AI Sitzung beginnt und abgeschlossen wird; eine Aufgabe, die nach Ablauf der Browser Sitzung in einer neuen AI Sitzung erneut versucht wird; Zwei Aufgaben wurden von derselben Browser Sitzung gestartet, wobei nur für eine das Ergebnis erzielt wurde. Hinzufügen eines absichtlich ungleichen Ergebnisereignisses in einer Prüfumgebung. Deine Arbeitsmatrix sollte es als Waise auftauchen. Die Sitzungs Kollisionsanfragen sollten die geteilten Gruppen markieren. Wenn ein Dashboard die unvergleichliche Aufgabe überprüft erscheint, ist der Schlüssel für die Verbindung immer noch falsch. Überwachen Sie den Vertrag selbst: die AI Ereignisse, die work id fehlen, zählen; die Ergebnisse ohne Generationszeile zu zählen; die Anzahl der angenommenen Arbeits IDs aufgeteilt auf Sitzungen ohne erneute Versuche oder Übergabe von Beweisen; die Verzögerung der Ereignisverzehrung zu messen, bevor eine kürzlich fällige Abwesenheit als Ausfall betrachtet wird; Aufmerksamkeit bei plötzlichen Anstiegen der Kollizionen der Sitzung oder der Wiederverwendung von Arbeitsschlüsseln. Die Kosten werden dann sicherer zu interpretieren. Summenerzeugungskosten nach work id , nicht nur nach Sitzung, und teilen Sie nur nach Arbeit mit dem Ergebnisstatus, den Ihr Unternehmen akzeptiert. Das Ergebnis ist die Kosten pro verifizierte Arbeitsleistungseinheit in den erneuten Versuchen, nicht die Kosten pro Spur oder Browserbesuch. In welchem Sidewisp passt PostHog eignet sich gut für Event Capture, Produktanalyse, SQL Insights und Untersuchung. Das Experiment behält diese Stärken und macht die Einsatz Urteilseinheit explizit. Sidewisp soll eine gesundheitliche Schicht um die bestehenden Wirkstofflaufzeiten werden, wobei Beweise, Frische, Unsicherheit, Genehmigungsgrenzen und Verifizierung verwendet werden. Es handelt sich nicht um eine Ersatzlaufzeit, ein obligatorisches Modell Gateway oder einen PostHog Ersatz. Die Produktionsüberwachungs und Wiederherstellungsadapter werden heute nicht versandt. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Wenn dieses Problem mit dem Schlüsselvereinigung in Ihrer Umgebung passt, schließen Sie sich der Warteliste der privaten Vorschau an und beschreiben Sie, welche Laufzeiten, Sitzungsgrenzen und Ergebnisse Ihre Arbeit kreuzt. Bis dahin halten Sie die Identifikatoren von PostHog ehrlich: Sitzungen navigieren, Spuren erklären Aktivität, und der dauerhafte Arbeitsschlüssel trägt das Betriebsergebnis.