Repository navigation
KO Roll out your team
윤혁준 edited this page Jul 10, 2026
·
1 revision
toard는 서버 한 대와 각 개발자 머신의 shim으로 동작합니다. 서버를 준비한 다음, 팀원은 자신의 계정과 token으로 수집기를 연결합니다.
관리자는 팀원이 접속할 수 있는 toard 주소를 공유합니다. 공개망을 통과한다면 TLS를 사용하고, 프록시 환경에서 수집용 공개 주소가 다르면 배포 설정의 TOARD_PUBLIC_URL을 확인하세요.
팀원은 자신의 계정으로 로그인합니다. 수집 이벤트는 개인 token의 소유자에게 귀속되므로, 공용 계정을 쓰기보다 각자 계정을 쓰는 편이 추적과 폐기에 유리합니다.
Settings → Install & tokens에서 개인 ingest token을 발급하고, 해당 화면이 제공하는 한 줄 설치 명령을 사용합니다. token은 비밀번호처럼 다루고 채팅, 이슈, 셸 히스토리에 남기지 마세요.
설치 스크립트는 현재 OS와 아키텍처에 맞는 shim을 설치하고, 로컬 자격 증명과 PATH를 설정합니다. 이후 shim은 로컬 세션 파일에서 사용량을 수집합니다.
같은 설정 화면의 receive check로 서버가 실제 이벤트를 받았는지 확인합니다. 수신이 보이지 않으면 KO-Troubleshooting의 "No received events" 항목부터 확인하세요.
사용량 수집이 연결됐다고 해서 프롬프트나 응답 본문이 저장되는 것은 아닙니다. 본문 수집은 서버와 사용자 양쪽의 명시적 선택이 필요합니다. 결정 전에 KO-Privacy-and-security을 읽어 보세요.