2026-08-02T00:38:18.495Z
클로드 코드 모니터링: 캡처 허가 대기 및 실종 결과
클로드 코드 텔레메트리, 라이프 사이클 해킹, 그리고 결정적 검사를 결합하기 위한 실용적인 3층 설계, 따라서 활동은 건강한 결과로 오해되지 않습니다.
클로드 코드 모니터링은 하나의 패시보드보다는 세 층이 필요합니다. 클로드 코드의 공식 OpenTelemetry 피드를 사용해서 소비와 활동, 대기 및 터미널 실패에 대한 라이프사이클 해킹, 그리고 실제로 요청한 결과에 대한 프로젝트 소유의 체크를 사용하십시오. 세 번째 계층을 생략하면, 세션에는 깨끗한 흔적이, 성공적인 도구 호출 및 예상되는 패치, 테스트 결과 또는 파일이 여전히 빠진 상태에서 맑은 최종 응답이있을 수 있습니다. 합리적인 기본값은 의도적으로 작습니다. 편집된 매트릭과 이벤트를 수출하고, 무료 텍스트 유용량이 없는 여섯 개의 라이프사이클 이벤트를 기록하고, 작업에 대한 완료 예측에 따라 마지막 이벤트를 평가합니다. 실행에 주의가 필요한지 여부를 결정하기 위해 단말기나 원료 도구 내용을 수집하지 마십시오. 이 가이드는 현재의 클로드 코드 계획에서 그 디자인을 구축하고 7개의 세션에 대한 결정 순서를 테스트합니다. 그것은 도구 호출이 진보, 일시 중지이 실패 또는 Stop 는 작업이 완료되었다고 가정하지 않습니다. 세 가지 질문으로 시작하세요. 각각의 신호가 한 질문에 답하고 다른 두 질문에 답하는 것은 금지되어 있을 때 모니터링이 더 명확해집니다. 계층 답할 수 있는 질문 신호 증명할 수 없는 것은 텔레메트리 클로드 코드는 무엇을 먹거나 죽였을까요? 세션, API 요청, 토큰, 추정 비용, 도구 결과, 도구 결정, 기간 요청된 결과가 정확하는지 여부는 생명주기 왜 이 세션이 조용하거나 끝나는가? 허가 요청, 알림, 배경 작업, 예정된 깨어남, 정지, API 종료 회전, 세션 종료 파일, 테스트 또는 외부 결과가 유효한지 결과 이 임무 는 약속 된 결과 를 얻었습니까? 파일 해시, 테스트 출력 상태, 스키마 검증, API 응답, 서명 된 유물 회의가 왜 기다렸는지 또는 얼마나 많은 비용이 들었는지 공식 클로드 코드 모니터링 문서는 OTel 메트릭스 프로토콜을 통해 매트릭스, 로그/ 이벤트로 이벤트 및 선택적으로 분산된 추적을 노출합니다. 문서화된 매트릭은 세션 카운트, 라인 변경, 커밋, 트러 요청, 액티브 시간, 토큰 및 추정 비용입니다. 이벤트는 신속한 상관관계, API 결과, 도구 결과 및 권한 결정을 추가합니다. 이것은 첫 번째 층에 대한 훌륭한 증거입니다. 이 계약은 완공 계약이 아닙니다. 보통의 업무에서는 그 차이가 중요합니다. 성공적인 Write 도구 이벤트는 작성 완료되었다고 말합니다. 의도된 파일이 올바른 위치에 작성되었거나, 그 결과 프로그램에서 컴파일되거나 사용자가 해당 파일을 요청했다고 말하지 않습니다. 토큰과 비용 곡선은 가급적 소비를 드러낼 수 있지만, 저렴한 세션은 여전히 배달 가능한 것보다 한 걸음 앞서 멈출 수 있습니다. 클로드 코드 해킹으로 라이프사이클 증거를 추가 클로드 코드스 호크 참조는 사용 전용 패시보드에서 놓친 두 번째 층을 제공합니다. 특히 4가지 이벤트가 유용합니다. PermissionRequest 는 권한 대화가 표시될 때 발사됩니다. 가장 최근에 해결되지 않은 사건이라면, 세션은 사람을 기다리고 있습니다. Stop 는 주요 요원이 응답을 끝낼 때 발사합니다. 현재 입력에는 background tasks 및 session crons 가 포함될 수 있으므로 정지 회전에서는 여전히 셸 작업, subagent, 모니터 작업, 작업 흐름, MCP 작업 또는 예정된 깨어남을 기다리고 있을 수 있습니다. 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 사이에 결정을 내린다. 유지된 시험장치는 7개의 세션과 15분짜리 예제 임대기를 사용한다. 고정된 시간표로 장치를 실행하면 일곱 줄 모두 재생됩니다. 이건 결정 규칙이고, 생산 다이몬이 아닙니다. 15분짜리 임기는 2분짜리 린트 작업과 2시간짜리 빌드 작업에 맞지 않습니다. 작업의 예상 시기와 기간에 대한 신선도를 설정하고, 실종 또는 모순적인 증거에 대한 uncertain 경로를 유지하십시오. 대화 밖 에서 완성 을 정의 하십시오 분류자의 유일한 응용 프로그램에 대한 입력은 outcome verified 입니다. 이 비트는 가능한 한 결정적 검증에서 왔어야 합니다. 최종 보조 메시지를 검색하는 것에서 아닙니다. 코드 변경 작업에 있어서 유용한 완료는 다음의 모든 것을 필요로 할 수 있습니다. 1. 예상된 파일은 초기 공약과 다를 수 있습니다. 2. 집중 테스트 명령이 성공적으로 종료됩니다. 3. 생성된 유물 디코드 또는 패키지는 수입될 수 있습니다. 4. 그 결과는 승인된 저장소 및 범위에 남아 있습니다. 문서 작업을 위해 목적 파일, 프론트머터 또는 스키마 검증, 인용된 모든 로컬 경로 및 저장소가 이미 신뢰하는 모든 링크 검사기를 요구합니다. 데이터 수출을 위해 예상된 파일을 확인하고 분석하고, 필요한 열을 검증하고, 원본 경계와 줄 수를 비교하십시오. API 변경을 위해서는 단순히 반환된 HTTP 요청을 받아들이기보다는 계약 테스트를 실행하십시오. 모니터에는 검증자의 이름, 출력 상태, 관찰 시간 및 결과의 소화가 저장되어야 합니다. 결정적 표본이 존재하지 않는 경우, outcome unknown 를 기록하십시오. 알려지지 않은 결과로 인해 검토가 요구될 수 있습니다. 다음 안전 조치에 대한 경고 7개 주에서는 7개의 경보가 필요 없습니다. 각 상태를 가장 작은 유용한 동작으로 로우트하십시오: 국가 기본 동작 working 아무것도 하지 말아요 waiting human 허가 카테고리를 가진 책임자에게 승인하지 않고 통보합니다. waiting background 의존성과 신선함을 보여주기; 회의를 다시 시작하지 마십시오. failed: 오류 클래스 및 제한된 재실험 정책을 노출 outcome missing 실패한 완공을 표시하고 검사를 위해 작업을 보존 stalled 한 가지 제한된 추진을 제안하기 전에 접근성 및 예상 기간을 다시 확인합니다. complete 증거들을 보관하고 문제를 닫습니다. 이 라우팅은 두 가지 값비싼 실수를 방지합니다. 첫째, 권위를 기다리고 있는 에이전트를 다시 시도하는 것을 피합니다. 둘째, 프로젝트 증거가 결과가 없는 상태에서 대화 중단을 기념하는 것을 피합니다. 자동화된 회복은 모니터링보다 더 엄격한 경계를 필요로 합니다. 속도 제한 오류는 백오프 후 재발전될 수 있습니다. 인증 오류는 일반적으로 사람이 필요합니다. 허가 요청은 오래된 것만으로 자동 승인되지 않습니다. 모든 개입 후, 완료 예측을 다시 실행하십시오. 성공한 명령은 활동의 증거가 아니라 원래의 임무가 회복되었다는 증거입니다. 너무 많이 수집하지 않고 디자인을 적용하십시오. 실질적인 투입은 점진적으로 유지될 수 있습니다. 1. 매트릭과 이벤트와 함께 클로드 코드 텔레메트리를 활성화하고, 모든 콘텐츠 로깅 스위치를 차단합니다. 2. claude code.session.count 또는 claude code.user prompt 가 수집기에 도착한 것을 확인하기 전에 알림을 작성하십시오. 3. PermissionRequest , Stop , StopFailure , Notification , PreCompact , SessionEnd 에 대한 로컬 해킹을 추가합니다. 4. 그 해킹 유용량을 최소한의 봉투로 정상화하십시오. 지역적으로 해시 식별자 및 드롭 경로 및 자유 텍스트. 5. 하나의 결과적 작업에 대한 결정적 완성 전제를 정의하십시오. 6. 모든 주에서 합성 이벤트를 다시 재생하고 다른 사람에게 알리기 전에. 7. 알림을 추가하는 것은 소유자와 안전 다음 동작이 명시되어 있을 때만입니다. 정상화 버전. 클로드 코드는 여러 분야에 대한 최소한의 버전을 문서화하고, 표본 내부는 명시적으로 안정적인 계약이 아닙니다. 현재 문서에서 노출된 과 OTel 필드를 선호하십시오. 터미널 픽셀을 스크래핑하거나 개인 표본 모양이 절대 변하지 않을 것으로 가정하여 오래 지속되는 모니터를 구축하지 마십시오. Sidewisp의 유용한 경계는 클로드 코드는 이미 강력한 원시 신호를 제공합니다. 운영적 격차는 이러한 신호를 제한된 건강 결정으로 변화시키고 있습니다. 작동, 기다림, 실패, 노후화, 또는 약속된 결과를 놓치고 있습니다. Sidewisp는 현재 비공개 프리뷰 단계입니다. 공공 사이트와 기사 시스템은 실시간이지만 생산 클로드 코드 모니터링 어댑터, 에이전트 건강 수집 및 복구 일반적으로 배송되지 않습니다. 의도된 역할은 기존 실행 시간과 함께 건강 계층이며, 대체 실행 시간, 필수 모델 게이트웨이 또는 자율 고정 장치가 아닙니다. 만약 그 경계가 코딩 에이전트를 작동하는 방식과 일치한다면, 개인 미리보기 대기 목록은 적절한 다음 단계입니다. 그 때까지, 이 가이드의 3층 패턴은 그 자체로 사용할 수 있습니다. 활동의 텔레메트리, 생명주기의 해킹, 그리고 결과의 결정적 검사.