Мониторинг Клод-кода: ожидание разрешения на поимку и отсутствие результатов

Мониторинг Клод Кода требует трех уровней, а не одной панели. Используйте официальный канал OpenTelemetry Claude Code для потребления и активности, привязки жизненного цикла для ожиданий и неисправностей терминалов, а также проверку проекта на результат, который вы действительно запросили. Если вы пропустите третий слой, на сессии могут быть чистые следы, успешные звонки инструмента и отличное окончательное отклик, пока ожидаемый патч, результат теста или файл все еще отсутствуют. Разумный дефолт преднамеренно небольшой: экспортируйте редактированные показатели и события, записывайте шесть событий жизненного цикла без их полезных нагрузок свободным текстом, а затем оценивайте последнее событие по предсказанию выполнения задачи. Не собирайте запросы или сырный контент инструмента, чтобы решить, требуется ли внимание на ходу. Этот справочник создает этот дизайн из текущих схем Клод кода и тестирует порядок принятия решений на семи сессиях. Он не предполагает, что призыв к инструменту это прогресс, что пауза это неудача или что Stop означает, что работа завершена. Начнем с трех вопросов . Мониторинг становится более ясным, когда каждый сигнал отвечает на один вопрос и запрещается отвечать на остальные два. Складка Вопрос, на который он может ответить Сигналы Что он не может доказать Телеметрия Что Клод Код употребил или совершил? сессии, запросы API, токены, предполагаемая стоимость, результаты инструмента, решения инструмента, продолжительность является ли запрашиваемый результат правильным жизненный цикл Почему эта сессия молчит или заканчивается? запрос разрешения, уведомление, задание на фоне, запланированное пробуждение, остановка, поворота с API окончанием, конец сессии является ли файл, тест или внешний результат действительным Результат Получился ли этот заказ обещанным результатом? хэш файла, состояние выхода тестирования, проверка схемы, ответ API, подписанный артефакт почему сеанс подождал или сколько он стоил официальная документация по мониторингу Клод код раскрывает метрику через протокол OTel metrics, события через журналы/события и опциональные распределенные следы. Документированные показатели включают количество сеансов, измененные строки, обязательства, запросы, активное время, токены и предполагаемые затраты. События добавляют оперативную корреляцию, результаты API, результаты инструмента и решения о разрешениях. Это отличный показатель для первого слоя. Это не контракт на завершение. Различие имеет значение в обычной работе. Успешное событие инструмента Write говорит о завершении написания. В нем не говорится, что предполагаемый файл был написан в нужном месте, что получаемая программа компилирует, или что пользователь запросил этот файл. Токены и кривые стоимости могут показать неэффективное потребление, но низкооплачиваемая сеанс все равно может остановиться на шаг раньше поставляемого. Добавьте доказательства жизненного цикла с помощью крючков Клод Код Claude Codes ссылка на крючки обеспечивает второй слой, который отсутствует только на панели для использования. Особенно полезны четыре мероприятия: PermissionRequest запускается, когда показывается диалог разрешений. Если речь идет о новом неразрешенном событии, то сеанс ждет человека; он не задерживается. Stop зажигает, когда главный агент заканчивает реагировать. Текущий вход может включать background tasks и session crons , поэтому приостановленный поворот может все еще ждать задачи Shell, subagent, Monitor task, workflow, MCP task или запланированного пробуждения. StopFailure запускается вместо Stop , когда ошибка API заканчивает поворот. К его документированным классам ошибок относятся лимит ставки, перегрузка, аутентификация, расчет, недействительный запрос, отсутствующая модель, ошибка сервера и максимальные токены выхода. SessionEnd записывает причину окончания сессии. Он полезен для очистки и аудита, но не может блокировать прекращение. PostToolUse , PostToolUseFailure , Notification и PreCompact добавляют полезный контекст. Сохраняйте их семантику узкой: недавний PostToolUse является доказательством активности; повторяющийся PostToolUseFailure является доказательством проблем с инструментом; PreCompact отмечает контекстный переход, который стоит коррелировать с более поздним поведением. Ни один из них не является универсальным вердиктом в отношении здоровья. Для коллектора с минимальным уровнем конфиденциальности сохраняйте только часовую печать, идентификатор сессии, название событий, название инструмента, класс ошибок, тип уведомлений и количество задач в фоне или запланированных пробуждений. За исключением transcript path , cwd , last assistant message , команд Bash, ввода инструмента и текста уведомления, если диагностированный случай использования не оправдывает их. Официальные дефолты OTel поддерживают такое же ограничение. Непосредственный текст, текст помощника ответа, аргументы инструмента, входный/выходный контент инструмента и сырые тела API отключаются по умолчанию. Включение OTEL LOG RAW API BODIES может раскрыть всю историю разговора; это никогда не должно быть случайным переключателем для решения проблем. Превратить последние доказательства в государство Решение ниже достаточно мало, чтобы проверить. Он классифицирует последнее событие для каждой сессии, в то время как внешний верификатор поставляет outcome verified , когда поворота останавливается. Приказ преднамеренный. Ошибка терминальной API превосходит недавнее событие. Неразрешенное одобрение ждет, а не отсрочка. Фональная работа предотвращает, чтобы событие Stop было рассматриваться как завершение. Только после исключения этих случаев проверяющий принимает решение между complete и outcome missing . В сохраненном испытательном устройстве используются семь сеансов и 15 минутный примерный порог: Запуск устройства на фиксированном временном знаке воспроизводит все семь строк: Это правило принятия решений, а не демона производства. Пятнадцатиминутный порог неправильный для двухминутной работы и неправильный для двухчасовой работы. Установите свежесть от ожидаемой каденции и продолжительности работы, а затем сохраните путь uncertain для отсутствия или противоречивых доказательств. Определить завершение без разговора Единственный специальный для применения вход классификатора является outcome verified . Этот бит должен исходить от детерминистической проверки, когда это возможно, а не от поиска в окончательном сообщении помощника для done. Для выполнения задачи по изменению кода полезное выполнение может потребовать всех следующих функций: 1. ожидаемые файлы отличаются от стартового обязательства; 2. с успехом выходит направленное испытательное командование; 3. генерируемые декоды артефакта или упаковка могут быть импортированы; 4. результат остается в утвержденном хранилище и охране. Для выполнения задачи документации требуется адресный файл, проверка предварительного материала или схемы, все цитируемые локальные пути и любой проверяющий ссылку, которому хранилище уже доверяет. Для экспорта данных проверьте ожидаемый файл, проанализируйте его, подтвердите требуемые столбцы и сравнивайте количество строков с исходным границей. Для изменения API выполните тест контракта, а не примите запрос HTTP, который просто вернулся. Монитор должен хранить имя проверяющего, состояние выхода, время наблюдения и перевод результата, а не вымышленное объяснение. Когда детерминистический предикат не существует, записывайте outcome unknown . Неизвестный результат может потребовать пересмотра; он не должен молча стать здоровым. Предупреждение о следующей безопасной операции Семь штатов не нуждаются в семи сигналах тревоги. Направьте каждое состояние на наименьшее полезное действие: Государство Действие по умолчанию working Ничего не делай. waiting human уведомляет ответственного лица о категории разрешения, не одобряя его waiting background продемонстрировать зависимость и свежесть; не возобновить сессию failed: раскрыть класс ошибок и ограниченную политику повторной попытки outcome missing показать неудачное завершение предсказать и сохранить работу для проверки stalled перепроверьте доступность и ожидаемое время, прежде чем предложить один ограниченный толчок complete сохранять доказательства и закрывать дело Этот маршрут предотвращает две дорогостоящие ошибки. Во первых, он избегает повторного испытания агента, который правильно ждет власти. Во вторых, он избегает празднования перерыва разговора, когда доказательства проекта говорят, что результат отсутствует. Автоматическое восстановление требует более строгих границ, чем мониторинг. Ошибка лимита скорости может быть восстановлена после отключения; ошибка аутентификации обычно требует человека; запрос разрешения не должен быть автоматически одобрен только потому, что он старый. После любого вмешательства, перезапустите прогноз завершения. Успешное командование является доказательством деятельности, а не доказательством того, что первоначальная задача восстановилась. Применять конструкцию без чрезмерного сбора Практическое развертывание может оставаться постепенным: 1. Включить телеметрию Claude Code с показателями и событиями, оставив все блоки записи контента отключены. 2. Убедитесь, что claude code.session.count или claude code.user prompt доходят до коллектора перед созданием оповещений. 3. Добавьте локальные крючки для PermissionRequest , Stop , StopFailure , Notification , PreCompact и SessionEnd . 4. Нормизируйте эти полезные нагрузки в минимальном объеме; хеш идентификаторы на местном уровне и пути сброса и свободный текст. 5. Определить одно предсказание детерминистического завершения для одной последовательной задачи. 6. Повторить синтетические события для каждого штата, прежде чем уведомить кого либо. 7. Добавить предупреждение только тогда, когда владелец и безопасное следующее действие явно. Версия нормализатора. Клод код документирует минимальные версии для нескольких областей, а внутренние транскрипты явно не являются стабильным контрактом. Предпочтительно использовать поля прицепа и OTel, которые раскрываются в текущей документации; не создавайте долговечный монитор путем скрапа терминальных пикселей или предполагая, что форма частной транскрипты никогда не изменится. Полезная граница для Sidewisp Клод Код уже дает сильные сырые сигналы. Оперативный пробел превращает эти сигналы в сдержанное решение о состоянии здоровья: работа, ожидание, отказ, устаревание или отсутствие обещанного результата, а затем показание доказательств и безопасный следующий шаг. Sidewisp сейчас находится на этапе закрытого предварительного доступа. Его общественный сайт и система статей живы, но адаптеры мониторинга производства Клод Код, сбор агентов здравоохранения и восстановление, как правило, не доставляются. Предназначенная роль это слой здоровья наряду с существующими сроками выполнения, а не замена времени выполнения, обязательный шлюз модели или автономный фиксатор. Если эта граница совпадает с тем, как вы управляете агентами по кодированию, следующим шагом является список ожиданий для частного предварительного просмотра. До тех пор трехслойная схема в этом руководстве может быть использована самостоятельно: телеметрия для деятельности, крючки для жизненного цикла и детерминистические проверки результатов.