tracethat.dev

리포터의 핵심 동작은 함수를 감싸 모든 호출이 함수 추적 이벤트로 기록되게 하는 것이다. JavaScript에서는 가벼운 JavaScript 디버거로, Python에서는 실행 중인 코드에 들어가는 Python 디버거로 동작한다. JavaScript에서는 traceThat(hello)("world")라고 쓰면 도구가 인자, 반환값, 호출에 걸린 시간, 호출 스택, 던져진 예외를 가져온다. Python은 @tracethat 데코레이터로 같은 발상을 쓴다. print 한 줄 없이 이 모든 걸 얻는다.

이벤트는 새로고침을 기다리지 않는다. 웹 클라이언트는 서버와 소켓을 유지하며 새 이벤트가 생길 때마다 방으로 밀어 넣는다. 호출을 펼쳐 세부 정보를 모두 보고, 관심 없는 것은 접고, 특정 값으로 걸러낼 수 있다. 스크롤 버퍼가 아니라 추려낸 이벤트 목록을 읽도록 설계됐다.

토큰은 방 식별자와 암호화 키 역할을 겸한다. 리포터는 이벤트가 앱을 떠나기 전에 암호화하고, 웹 클라이언트는 같은 토큰을 받아야만 복호화할 수 있다. 방은 토큰의 SHA-256 해시로 식별되므로, 서버는 그 세션에 해당하는 이벤트만 넘겨준다.

JavaScript/TypeScript, Python, Go용 리포터가 있다. JS 리포터는 npm에서 설치하며 단순한 script 태그로도 돌아가서 빌드 파이프라인이 없을 때 편하다. Python은 PyPI에서, Go는 GitHub에서 바로 설치한다. 모두 같은 서버와 같은 UI와 통신하므로 기술 스택이 섞여도 한곳에 모인다.

함수 전체를 감싸고 싶지 않을 때는 한 지점에 표시를 남길 수 있다. tracethat.log('hello function started')가 이벤트를 기록하며, 추가 데이터도 함께 넘길 수 있다. 리포터가 함수를 일반적으로 감쌀 수 없는 Go에서 으뜸으로 쓰는 방법이고, 두 줄 사이에 점검 지점을 두고 싶은 사람에게도 맞는다.

서버는 이벤트를 영구 저장소에 쓰지 않고 메모리에 두었다가 한동안 지나면 지운다. 설정은 가볍게 유지되고 관리할 로그도 남지 않는다. 동시에 이벤트는 라이브 디버깅을 위한 것이지 지난주에 무슨 일이 있었는지 되짚는 용도가 아니라는 뜻이기도 하다.