버그 리포트
502 화면의 스크린샷 대신, 실패한 요청, 워커 종료, 이슈, 마지막으로 실패한 명령 같은 증거를 첨부해 Runlot에 문제를 보냅니다.
runlot bug-report플래그 없이 실행하면 한 줄 설명을 묻고, 연결된 프로젝트의 최근 1시간 동안의 실패한 요청, 워커 종료, 열린 이슈를 첨부합니다. 보내기 전에 첨부할 내용(개수와 미리 보기)을 출력하고 확인을 받습니다.
runlot bug-report --request 4bf92f3577b34da6a3ce929d0e0e4736 --message "checkout returns 502 since v42"
runlot bug-report --since 30m
runlot bug-report --last| 플래그 | 하는 일 |
|---|---|
--request <id> | ID로 요청을 첨부합니다. ID는 Runlot-Request-Id 헤더, 오류 페이지, 대시보드에서 얻습니다. 여러 번 지정할 수 있으며 최대 20개입니다 |
--since <window> | 실패한 요청, 워커 종료, 이슈를 찾을 기간입니다. 30m, 2h처럼 쓰며 최대 24h입니다. 기본값 1h |
--message "…" | 설명입니다. 생략하면 터미널에서 묻고, 터미널이 없으면 필수입니다 |
--last | 이 컴퓨터에서 가장 최근에 실패한 runlot 명령을 첨부합니다 |
--no-logs | 로그 줄 없이 요청 기록과 워커 종료만 첨부합니다 |
--dry-run | 보낼 내용을 그대로 출력하고 멈춥니다 |
--yes, -y | 묻지 않고 보냅니다 |
runlot 명령이 서버 오류나 예상하지 못한 문제로 실패하면, 마지막에 runlot bug-report --last를 실행하라는 안내를 출력합니다.
보내는 내용
CLI는 로그 내용이 아니라 참조를 보냅니다. 요청 ID, 기간, 그리고 --last이면 실패한 명령입니다. Runlot이 이를 풀어 리포트와 함께 스냅샷을 보관하므로, 증거는 3일 또는 7일의 보관 기간보다 오래 남습니다.
- 지정한 요청과 그 로그, 스팬, 원인이 된 프로세스 종료,
- 기간 안의 실패한 요청과 워커 종료,
- Runlot Errors의 열린 이슈,
- 현재 배포와 이전 배포, 최근 빌드.
컴퓨터에서는 CLI 버전, OS, 아키텍처, Node 버전, 그리고 runlot.json을 추가합니다. 비밀처럼 보이는 값이나 비밀 같은 이름 아래의 값은 CLI에서 한 번, 서버에서 다시 한 번 바꿔 넣습니다. --last이면 명령의 인자는 모든 값을 제거하고 명령어만 남기며, 여기에 종료 상태, 오류 출력의 끝부분, 명령이 받은 API 응답의 요청 ID를 더합니다.
보낸 뒤
리포트 ID(BR-…)가 담긴 이메일을 받습니다. 후속 문의에서는 이 ID를 알려 주세요. 답변은 이메일과 리포트에 도착합니다. 멤버는 누구나 볼 수 있는 프로젝트에 대해 리포트를 보낼 수 있습니다. 조직 관리자는 조직의 리포트 목록을 보고 리포트를 삭제할 수 있으며, 삭제하면 스냅샷도 함께 삭제됩니다.
Runlot 직원이 스냅샷을 조회할 때마다 프로젝트의 감사 기록에 나타납니다.