Proxyman으로 버그를 효과적으로 제보하는 방법
Proxyman은 요청과 응답의 내용을 확인하는 데뿐만 아니라 버그를 제보하는 데에도 유용한 도구입니다.
보통 QA 담당자는 티켓을 통해 버그를 개발자에게 전달합니다. 하지만 이 과정은 시간이 많이 걸리고, 개발자는 결국 버그를 직접 재현해야 하는 경우가 많습니다.
아래는 저희가 버그를 제보할 때 사용하는 방법입니다. 개발자와 QA 모두에게 더 편리할 것이라고 생각합니다.
** 참고로 아래의 버그는 설명을 위해 저희가 임의로 만든 것입니다.
1. 버그 발견
이런 상황을 가정해 보겠습니다. 저는 iPhone에서 Unsplash 앱을 테스트하고 있었는데, 어떤 이유에서인지 이미지가 전혀 보이지 않았습니다. 응답을 확인해 보니 액세스 토큰이 유효하지 않다는 예상치 못한 오류가 있었습니다.
버그인 것 같아서 개발자에게 전달해 더 자세히 조사해 달라고 하려고 했습니다.
그렇다면 이 버그를 어떻게 제보하는 것이 가장 좋을까요?
2. “flow” 내보내기
Proxyman에는 현재 flow를 내보내 나중에 다시 열 수 있는 “Export” 기능이 있습니다. 현재 URL에서 마우스 오른쪽 버튼을 클릭한 뒤 “Export this flow”를 선택하고 “Save”을 누르면 됩니다.
3. 내보낸 flow를 Jira, Trello, GitHub 등에 첨부
내보낸 파일은 개발자와 소통하는 가장 쉬운 방법 중 하나입니다. Jira, Trello, GitHub의 티켓에 파일을 첨부한 뒤 개발자에게 전달하면 됩니다. 아래는 저희가 개발자에게 제보한 티켓의 예시입니다(모든 정보는 가상의 내용입니다).
4. 내보낸 “flow” 열기
담당 개발자가 파일을 열면 제가 본 것과 같은 flow를 바로 확인할 수 있습니다. 다시 말해, 개발자는 자신의 기기에서 버그를 직접 재현하지 않아도 요청과 응답의 내용을 바탕으로 곧바로 조사를 시작할 수 있습니다(저희도 꽤 멋지다고 생각했습니다 xD).
5. Edit and Repeat
유용할 수 있는 또 다른 기능은 “Edit and Repeat”입니다. 현재 flow에서 마우스 오른쪽 버튼을 클릭한 뒤 “Edit and Repeat”을 선택하면 요청의 Header와 Body를 “Edit”으로 수정하고 “Re-send”로 다시 보낼 수 있습니다…
… 버그를 조사하는 개발자에게 도움이 될 수 있습니다.
마무리
지금까지 저희가 버그를 제보할 때 사용하는 방법을 살펴봤습니다. 여러분은 어떠신가요? 개발자와 소통할 때 가장 좋아하는 도구는 무엇인가요? 아이디어를 자유롭게 공유해 주세요. 더 나은 글을 쓸 수 있도록 댓글도 남겨 주시면 감사하겠습니다.
로그를 공유하기 전에
내보낸 로그를 한 번 열어 액세스 토큰, 쿠키, 이메일 주소, 고객의 개인 정보가 포함되어 있는지 확인하세요. 받는 사람이 필요하지 않은 정보는 삭제하거나 가려 주세요. 좋은 티켓에는 실패가 발생한 시간, 앱 버전, 기대한 결과, 그리고 문제를 보여 주는 요청도 함께 포함하는 것이 좋습니다.
Proxyman에 관심이 있으시다면 여기에서 최신 버전을 다운로드하실 수 있습니다.
즐거운 디버깅 되세요! :)
Proxyman은 iOS 기기, iOS 시뮬레이터, Android 기기에서 앱과 도메인의 HTTP/HTTPS 요청을 캡처하고 검사할 수 있게 해 주는 고성능 macOS 앱입니다.
https://proxyman.com에서 받아보실 수 있습니다.
