PostHog LLM Наблюдаемость: проверка ключа соединения

За наблюдением PostHog LLM требуется преднамеренный ключ для присоединения, когда работа агента может попытаться повторно, покинуть сессию браузера или поделиться сессией с другой задачей. $session id , $ai session id и $ai trace id полезны, но ни один из них не является автоматически идентичностью принятой работы. В эксперименте с 14 событиями группировка по сессии фронтэнда создала две смешанные группы и две неправильные пары между поколением и результатом. Группировка по сессии AI разделила одну повторную задачу на две сессии и все же привела к ошибочной паре. Устойчивый work id соединил все три ожидаемых проверенных результата, сохранил повторную попытку как одну задачу и изолировал неисправное получение в качестве сироты, вместо того, чтобы присоединить его к здоровому следу. Правило эксплуатации конкретно: использовать сессии PostHog для навигации и агрегации, следы для деятельности причинно следственной модели и безопасный для конфиденциальности work id для устройства, которое в конечном итоге должно дать результат. Затем объедините эти поля. Вот как следы, затраты и анализ продукта становятся контрактом доказательств, а не свободной коллекцией панелей. Четыре идентификатора отвечают на четыре разных вопроса Модель следа AI PostHog требует $ai trace id для событий наблюдения AI. Группы следов, связанные с поколениями и периодами. Отвечает: какая модель и инструментальная деятельность принадлежали к этому взаимодействию? Справочник сеансов AI определяет $ai session id как необязательную группировку, выбранную в соответствии с применением. Она может представлять рабочий процесс, нить, разговор или другую логическую границу. Тот же справочник отличает его от стандартного фронтэнда $session id , который обычно записывается в браузере. PostHog также использует distinct id для ассоциации событий с личностью или идентичностью службы. Это отвечает, кто или что выпустило событие; оно не должно быть перегружено идентификатором задачи. Принятая единица работы агента нуждается в четвертой идентичности: Идентификатор Хорошая граница Неисправность при использовании в качестве рабочего ключа distinct id Человек, счет или услуга Один актер может иметь много совместных задач $session id Визит в первую очередь Работа на фоне может пережить его; один визит может начать несколько задач $ai session id Заседание AI, определяемое приложениями Повторная попытка или перезагрузка может создать другую сессию $ai trace id Одно причинно следственное следствие Фрагменты работы с множественными следами на протяжении повторных попыток и передач work id Одно принятое задание и его результат Должны быть созданы и распространяются приложениями Создать work id , когда система принимает задачу, до первого звонка модели. Сделайте его непрозрачным и стабильным. Он должен выжить после повторной попытки, перезагрузки работника, ожидания одобрения, закрытия браузера и изменения модели. Не используйте адрес электронной почты, запрос, маршрут или имя направления. генерационная документация PostHog определяет модель событий поколения. документация о таможенных свойствах показывает примеры JavaScript wrapper с использованием posthogProperties и posthogDistinctId , в то время как руководство сессии документирует $ai session id как выбранную приложения группировку. Версия упаковки, наблюдаемая с помощью тега npm latest , была @posthog/ai 8.4.0 27 июля 2026 года; рассматривайте это как датированный снимок и проверьте текущую документацию для вашего поставщика и установленную версию. Воспроизведите эксперимент с 14 событиями . Устройство содержит пять признанных рабочих удостоверений и один преднамеренно неверный результат. Он моделирует три формы неисправности , которые часто скрываются в панелях только для сеансов: 1. work 102 начинается в сессии браузера browser b , повторно пытается после того, как контент фронта исчез, и продолжается в новой сессии AI. Его проверенный результат приходит с work id , но без идентификаторов сеансов. 2. work 103 и work 104 запускаются внутри одной сессии браузера. Только work 103 имеет проверенный результат, в то время как work 104 имеет продуктовое событие, но никакого результата. 3. work 105 завершает за сессией AI ai run d , но позднее результатное событие содержит work 999 при сохранении тех же значений переднего конца и сессии AI. Это не синтетические трюки по названию. Они представляют собой общие изменения топологии: повторная попытка на фоне, одновременные задачи из одного посещения и событие, соотношение которого метаданные не согласны. Я загрузил события в форме PostHog в таблицу SQL в памяти и оценил три стратегии. Стратегия получает кредит только тогда, когда группа содержит как поколение, так и ожидаемый результат одной и той же работы. Он записывает неправильную пару, когда одно поколение для одного ID работы делится одной группой с результатом для другой. Измеренный результат был: Стратегия корреляции Правильная проверенная работа Пропущенная ожидаемая работа Смешанные группы Неправильные пары Фрагментированные повторные попытки : : : : : Frontend $session id 2 из 3 1 2 2 0 $ai session id 2 из 3 1 1 1 1 Прочный work id 3 из 3 0 0 0 0 Фронт сессия соединяет work 103 с work 104 и соединяет work 105 с неправильным результатом work 999 . Соединение сессии AI избежало совпадения браузера, но разделило work 102 на ai run b1 и ai run b2 ; в результате не было никакой сессии AI. Он также присоединился к work 105 к work 999 , потому что оба носили ai run d . Запрос work id вывел шесть рядов: пять принятых рабочих единиц плюс work 999 . Шестой ряд имел один результат и нулевые поколения. Вместо того, чтобы сделать work 105 зеленым, запрос выявил результатное событие сироту. Создать матрицу работы в HogQL PostHog документирует доступ к SQL как HogQL, обложка вокруг ClickHouse SQL с упрощенным доступом к объектам событий. Событие свойства используют точечную нотацию, включая долярные префиксированные свойства PostHog. Поддерживаемые агрегации включают countIf , uniqExactIf и groupUniqArray . Этот запрос создает один ряд на прочный рабочий ключ: Справочник SQL PostHog показывает таблицу events , доступ к свойствам, представления SQL и форму API HogQLQuery . ссылка на агрегацию перечисляет функции условного и точного уникальности, используемые здесь. Интерпретировать форму строки перед вычислением балла: generation count = 0 и outcome count 0 являются результатом, не подтвержденным. ai session count 1 может быть законным повторным испытанием или передачей; проверьте retry count , прежде чем назвать его дубликатом. frontend session count = 0 это нормально для фоновой работы. product event count 0 показывает поведение продукта, а не проверку назначения. trace count 1 можно ожидать, когда одна принятая задача охватывает повторные попытки. Для work 102 матрица сообщает о двух следах, двух сессиях AI, одной повторной попытке и одном результате. Ряд остается нетронутым, потому что рабочий ключ пережил оба изменения сессии. Это главный результат эксперимента. Проверить столкновения до того, как доверять приборной панели Матрица работы показывает, что успешно группировано. Аудит столкновения задает вопрос о том, были ли альтернативные ключи объединены не связанной работой. Проверьте это против фронтальных сеансов: Повторяйте с $ai session id . В фиксированной форме аудиторская группа возвращает browser c с work 103 и work 104 , плюс browser d с work 105 и work 999 . Аудит сессии AI возвращает ai run d с work 105 и work 999 . Это не доказывает, какое событие не так. Он определяет границу, где атрибуция на основе сеанса небезопасна, и предоставляет оператору небольшой набор исследований. Добавьте вторую проверку в другом направлении: подсчитайте количество различных значений сессии на work id . Рабочий ключ с двумя сеансами AI и повторным испытанием, вероятно, является непрерывностью попыток. Рабочий ключ, появляющийся во многих сеансах без повторной попытки, передачи или записи резюме, может указывать на повторное использование ключа. Устройство и бегатель могут быть преднамеренно проверены. Местный бегатель выполняет матрицу работы SQL по всем 14 событиям, затем оценивает три стратегии объединения и утверждает пять выводов: Это не реальный показатель PostHog. Он не измеряет латентность приема, разрешения API запросов, сохранение или типы собственности, специфические для арендатора. Он проверяет относительное утверждение за приборной панелью. Прежде чем использовать запрос в производстве, запустите его в качестве SQL взгляды на безобидный набор канарных файлов и сравнивайте возвращенные столбцы с вашим устройством. Инструмент ключ без утечки содержания задачи Присоедините один и тот же непрозрачный рабочий ключ к каждому соответствующему событию. В примерах поддерживаемых JavaScript укладков страница с пользовательскими свойствами документирует posthogProperties и posthogDistinctId , страница сессий помещает $ai session id внутри posthogProperties , а страница конфиденциальности документирует posthogPrivacyMode . В сочетании с этими документальными вариантами форма запроса выглядит так: Используйте точные варианты, поддерживаемые интеграцией вашего поставщика и установленной версией. режим конфиденциальности PostHog исключает $ai input и $ai output choices ; он не очищает произвольные таможенные свойства. Сохраняйте список. Хорошие поля непрозрачные идентификаторы, номера попыток, версии рабочего потока, состояния с низкой кардинальностью, временные штампы и хэши. Плохие поля это запросы, завершения, секреты, электронные письма, необработанные пути файлов и полезные нагрузки провайдера. Выпускать события заявления с одним и тем же work id только после того, как существует их основной факт. Событие report view opened относится к анализу продукции. Событие agent outcome verified должно следовать авторитетному обратному прочтению и включать в себя хэшированную ссылку на место назначения плюс проверенный контент или хэш версии. Обе события могут делиться вопросом, не притворяясь, что они означают одно и то же. Держите distinct id стабильным для актера, которого вы хотите проанализировать. Сохраняйте $session id и $ai session id для их документированных границ навигации. Модель становится легче дебгурировать, потому что ни одно поле не выполняет три задания. Используйте эксперимент в качестве экспериментального испытания Начнем с трех канарских птиц , а не с большой панели: одна задача, которая начинается и завершается в одном браузере и сессии AI; одна задача, которая попытается повторно на новой сессии AI после окончания сессии браузера; две задачи, начавшиеся с одной сессии браузера, с результатом только для одной. Добавьте одно событие результатов, которое преднамеренно не соответствует результатам, в испытательной среде. Твоя рабочая матрица должна показаться сиротой. Запросы столкновения сессии должны обозначать общие группы. Если панель дает возможность проверить несовместимую задачу, то ключ "соединяйтесь" все равно неверен. Следить за самим контрактом: считать отсутствующие события AI work id ; учитывать исходные события без строки генерации; считать принятые рабочие удостоверения, распределенные по сеансам без повторных попыток или выдачи доказательств; измерять задержку приема событий, прежде чем рассматривать недавнее отсутствие как неисправность; предупреждение о внезапном увеличении количества столкновений на сессии или повторном использовании рабочих ключей. Затем расходы становятся более безопасными для интерпретации. Стоимость генерации суммы по work id , а не просто по сессии, и делитесь только по работе с результатом статуса вашего бизнеса принимает. Результат стоимость за проверенную единицу работы на протяжении повторных попыток, а не стоимость за след или посещение браузера. Где Sidewisp подходит PostHog хорошо подходит для захвата событий, анализа продуктов, понимания SQL и расследования. Эксперимент сохраняет эти сильные стороны, в то время как делает единую оперативное суждение ясным. Sidewisp предназначен для того, чтобы стать слоем здоровья вокруг существующих сроков действия агента, используя доказательства, свежесть, неопределенность, границы одобрения и проверку. Это не замена времени выполнения, обязательная модель шлюза или замена PostHog. Адаптеры для мониторинга производства и восстановления не отправляются сегодня. Sidewisp сейчас находится на этапе закрытого предварительного доступа. Если эта проблема соединения ключей соответствует вашей среде, присоединяйтесь к списку ожиданий для частного предварительного просмотра и опишите, какие сроки работы, границы сеансов и результаты вашей работы пересекаются. До тех пор держите идентификаторы PostHog честными: сессии навигируют, следы объясняют активность, а прочный рабочий ключ несет операционный результат.