로컬에서 버그 보고서를 확인하기¶
Agent 진단 파일을 받은 후, obscli를 사용하여 채팅 내용, 도구, LLM 진단 결과 및 리소스 메트릭스를 오프라인 상태에서 확인할 수 있습니다.
이 명령어는 ZIP 파일을 검증하고, 로컬 URL을 출력하며, 기본 브라우저를 열어줍니다. 터미널을 계속 실행 상태로 유지해야 합니다. Ctrl+C 또는 프로세스 종료 명령어가 나오면 로컬 서비스가 즉시 중단됩니다. 브라우저가 자동으로 열리지 않도록 하려면 다음과 같이 사용하세요:
로컬 ZIP 파일 하나만 지정할 수 있습니다. 서비스는 127.0.0.1의 임의 포트를 사용하며 다른 주소에서 수신하도록 설정할 수 없습니다. URL 토큰은 처음 사용한 후 만료되며, 같은 브라우저는 세션 쿠키로 계속 접속합니다. 새 브라우저 세션에서는 명령을 다시 시작하세요. URL을 전달하지 마세요.
완전히 오프라인 상태이며, 원시적인 증거만 사용됨.¶
뷰어의 모든 페이지, 스타일, 스크립트는 obscli에 내장되어 있습니다. CDN, 외부 글꼴, 텔레메트리, 참조 이미지 또는 첨부 파일을 불러오지 않습니다. Markdown 링크, 이미지, HTML은 동작하지 않는 텍스트로 처리하며 코드 블록도 실행하지 않습니다.
보기 기능은 각 ZIP 항목의 CRC 체크를 수행하고, 원본 파일의 SHA-256 값을 표시합니다. 이 기능은 ZIP 파일을 수정하거나 압축을 풀지 않습니다. 경로 재규명, 중복된 항목, 예상치 못한 파일 유형, CRC 오류, 알 수 없는 스키마, 그리고 매니펫트의 불일치 등은 명시적으로 거부됩니다.
깊이 3 보고서는 매우 민감한 UNREDACTED 파일입니다. 업무 텍스트, 전체 프롬프트, 추론, 도구 데이터, 인라인 멀티모달 콘텐츠가 포함될 수 있습니다. 통제된 컴퓨터에서만 확인하고 조직의 민감한 자료 처리 정책에 따라 다루세요.
세션과 LLM 라운드¶
왼쪽에는 기록되지 않은 것으로 표시된 범위 항목을 포함한 세션 목록이 표시됩니다. 기본 화면은 한 세션의 채팅, 도구, 런타임 및 기록된 LLM 이벤트를 전체 날짜와 시간 순서로 통합합니다. 하위 에이전트는 부모 세션, 부모 호출 및 도구 호출 식별자를 유지합니다. 레인 확인란으로 현재 페이지의 하위 에이전트 이벤트를 접을 수 있습니다.
기본 시간대는 보고서 Agent의 시간대이며 UTC 또는 브라우저의 현지 시간으로 전환할 수 있습니다. 검색은 선택한 세션의 원본 이벤트와 디코딩된 공급자 바이트를 대상으로 하며 이벤트 유형, 시간 및 안정적인 원본 위치를 유지합니다.
페이지당 이벤트 수에는 제한이 있습니다. Raw를 펼쳐 JSON, 공급자 바이트 또는 형식화된 데이터를 페이지별로 보고, 현재 페이지나 선택한 증거를 복사할 수 있습니다. UTF-8 페이지 분할은 문자를 보존합니다. 디코딩할 수 없는 공급자 청크는 base64로 명확히 표시합니다.
LLM 라운드 / 차이에는 목적, 시도, 모델, 상태, 사용량, 총 지연 시간, 첫 바이트까지의 시간이 표시됩니다. 기록된 구성 요소에는 최종 시스템 텍스트와 섹션, 유효 메시지, 실제 마지막 사용자 프롬프트, 모델 매개변수, 도구 정의, 순서가 있는 응답 청크, 조합된 응답, 파싱 결과, 도구 증거 및 압축 기록이 포함됩니다. attempt_end는 사용 가능한 첫 바이트, 추론, 첫 콘텐츠 및 추론 토큰의 시간 정보를 기록합니다. 누락된 네트워크 구간 정보는 추정하지 않습니다.
동일한 세션에서 A와 B 세션을 선택하고, 구조화된 차이점을 표시하기 위한 컴포넌트를 선택하세요. JSON 포인터는 차이점을 식별하며, 배열 순서는 보존되며, 긴 값은 컴포넌트 또는 원시 보기에서 전체 내용을 확인할 수 있는 미리보기를 사용합니다.
기존 obsy-agent-bug-report@2 아카이브도 읽을 수 있습니다. 상세 증거는 llm-diagnostics@1이 있을 때만 표시됩니다. 공급자 요청, 섹션, 압축 전 기록 또는 단계별 지연 시간이 없으면 not recorded로 표시합니다. 대화 기록이나 유효 컨텍스트를 실제 공급자 요청으로 재구성하지 않습니다.
지표/측정값¶
메트릭 화면은 CPU ticks/s, heap/sys, goroutine, 파일 디스크립터, 가비지 수집 및 대기열 차트와 메트릭 및 레이블 검색을 제공합니다. LLM 및 도구 카운터와 히스토그램은 이름과 레이블로 선택할 수 있습니다.
카운터 변화율은 인접한 샘플을 사용하며 히스토그램 평균 지연 시간은 Δsum / Δcount를 사용합니다. 첫 샘플, 카운터 초기화, 시간 역전, 이전 값 누락 또는 새 호출이 없는 경우에는 구간 값을 만들지 않습니다. CPU ticks/s는 수집기의 tick 단위를 유지하며 오해를 유발하는 백분율로 표시하지 않습니다.
차트 범위를 드래그하여 현재 세션 타임라인을 필터링할 수 있습니다. 30 초 전후의 메트릭스를 확인하기 위해 특정 타임라인의 타임스탬을 선택할 수 있습니다. LLM 라운드의 경우, 시작부터 끝까지의 간격을 선택할 수 있습니다.
파일과 Go 프로필¶
파일들은 매니페스트, 환경/설정 정보, 로그 파일, 실행 데이터, JSON, 그리고 텍스트 정보를 트리 형태로 표시합니다. 텍스트는 페이지 단위로 분할되어 표시되며, 바이너리 항목들은 메타데이터만 표시됩니다. 이 파일을 저장하기 옵션을 사용하면, 명시적으로 선택된 항목만 다운로드되며, 파일을 대량으로 추출하는 것은 불가능합니다.
뷰어에는 Go 프로파일 또는 런타임 트레이스 분석기가 내장되어 있지 않습니다. 선택한 파일을 저장하고 설치된 Go 도구를 사용하세요. 예:
실제로 저장된 경로를 사용하세요. 전체 진단 디렉터리를 공개 분석 서비스에 업로드하지 마세요.