녹화를 보고서로 만들어 조치 가능하게 하기
버그 화면 녹화를 불러옵니다. 재생하면서 중요한 일이 일어날 때마다 표시하세요. 타임스탬프가 캡처되고, 해당 순간의 비디오 프레임이 추출되어 단계가 번호가 매겨진 목록에 추가됩니다.
요약, 예상했던 것과 실제 발생한 일을 작성한 다음, 전체 내용을 GitHub용 Markdown, Jira 마크업 또는 일반 텍스트로 복사하세요. 브라우저 및 화면 세부 정보는 이미 채워져 있습니다.
녹화는 귀하의 장치를 벗어나지 않습니다. 로컬 파일에서 재생되고 프레임은 귀하의 장치에 그려지는데, 이는 버그가 미출시 빌드나 고객 계정에 있을 때 중요합니다.
이 기능이 AI를 사용하여 보고서를 작성하지 않는 이유
화면 녹화를 보는 모델은 자신이 보는 것을 설명할 수 있습니다. 하지만 사용자가 무엇을 보기를 기대했는지는 알 수 없으며, 이는 버그 보고서의 절반으로 누가 조치를 취할지 결정하는 부분입니다.
“확인 버튼을 클릭했는데, 인보이스 패널이 비어 있었습니다”는 관찰입니다. 그것이 버그인지 여부는 전적으로 거기에 무엇이 나타났어야 하는지에 달려 있으며, 그것을 아는 유일한 사람은 당신입니다. 비디오에서 예상되는 동작을 생성하는 도구는 추측하고 그 추측을 발견으로 제시하는데, 이는 필드를 비워두는 것보다 나쁩니다. 그럴듯하지만 잘못된 기대는 개발자를 잘못된 길로 이끌 수 있기 때문입니다.
따라서 여기서의 분리는 의도적입니다. 도구는 타임스탬프, 프레임, 환경, 서식, 번호 매기기와 같이 기계적인 작업을 정확히 수행합니다. 당신은 판단을 제공합니다. 이는 약 1분 정도 걸리며, 결과는 누구도 다시 당신에게 물어볼 필요가 없는 보고서입니다.
보고서에서 흔히 놓치는 세 가지
많은 부실한 버그 보고서를 읽어보면 동일한 간극이 반복되며, 이 세 가지 모두 어려운 것이 아니라 기계적인 것입니다.
타임스탬프. “첨부된 비디오 참조”라고만 된 보고서는 독자가 순간을 찾기 위해 4분을 시청하게 만듭니다. 1:12에 발생했다고 명시된 단계는 그렇지 않습니다.
환경. 브라우저, 운영 체제, 화면 크기. 모두 포함해야 한다는 것을 알지만, 생각을 하는 도중에 설정 패널을 열어야 하기 때문에 거의 아무도 포함하지 않습니다. 여기서는 브라우저에서 읽어와 보고서에 이미 채워져 있으며, 수정할 수 있습니다.
스틸 이미지. 오류 발생 순간의 프레임은 20개 문제 목록에서 스캔되는 것입니다. 비디오에서 프레임을 수동으로 추출하는 것은 너무 번거로워서 사람들이 건너뛰는 경향이 있으므로, 표시하는 각 단계에서 자동으로 발생합니다.
정확히 무엇이 캡처되는가
각 표시된 단계는 정확한 재생 시간과 그 시점의 비디오에서 추출된 JPEG 프레임을 기록하며, 보고서를 가볍게 유지하기 위해 축소됩니다. 프레임을 다운로드하여 문제에 첨부할 수 있습니다.
환경은 브라우저에서 가져옵니다: 브라우저 이름과 버전, 운영 체제, 픽셀 비율이 포함된 화면 크기, 그리고 뷰포트 크기. 브라우저는 예전보다 자신에 대한 정보를 적게 보고하므로, 일부는 알 수 없음으로 표시될 수 있으며, 모든 필드는 잠겨 있지 않고 편집 가능합니다.
픽셀에서 아무것도 추론되지 않습니다. 이 도구는 화면에서 오류 텍스트를 읽거나 사용자가 어떤 요소를 클릭했는지 추측하려고 시도하지 않습니다. 왜냐하면 그렇게 하는 것이 신뢰할 수 없을 경우 안 하는 것보다 더 나쁘기 때문입니다.
채워지는 구조
출력은 버그 보고서가 정착된 형태를 따릅니다. 트래커와 이를 읽는 사람들이 그 형태를 기대하기 때문입니다. 버그 보고서 템플릿을 찾고 있었다면, 이것은 붙여넣고 쳐다보는 것이 아니라 이미 채워진 상태로 도착하는 템플릿입니다.
요약이 한 줄로 먼저 나옵니다. 왜냐하면 그 한 줄이 서른 개의 문제 목록에서 누군가가 스캔하는 것이고, 오늘 당신의 문제가 열릴지 결정하기 때문입니다.
그런 다음 각 단계에 타임코드가 있는 번호 매겨진 단계, 예상되는 동작, 실제 동작, 그리고 환경이 나옵니다. 이 순서는 꾸밈이 아닙니다. 독자는 재현 가능한지 확인하기 위해 단계를 확인하고, 실제로 버그인지 확인하기 위해 예상과 실제를 짝지어 확인하며, 자신과 관련된 문제인지 확인하기 위해 환경을 확인합니다. 이 중 어느 하나라도 숨기면 왕복하는 데 비용이 듭니다.
빈 템플릿이 할 수 없는 것은 스스로 채워지는 것인데, 이것이 사람들이 템플릿을 건너뛰게 만드는 부분입니다. 여기서는 단계, 타임코드, 프레임 및 환경이 채워져 도착하며, 도구가 진정으로 알 수 없는 세 가지 필드를 당신이 작성합니다.
기록하기 전에
보고서는 녹화만큼만 유용하며, 두 가지 습관이 차이를 만듭니다.
알려진 상태에서 시작하세요. 세션 도중에 시작된 녹화는 독자가 이전에 무슨 일이 있었는지 추측하게 만들어 재현 가능한 단계가 아닙니다. 로그인 화면, 새 페이지 또는 설명된 시작 지점에서 시작하세요.
이동해서는 안 되는 모든 것을 화면에서 지우세요. URL 바의 토큰, 고객 이름, 다른 탭의 관련 없는 이메일, 개발자 도구 패널의 API 키 등. 버그 보고서는 팀 외부 사람들에게 전달되고, 채팅에 붙여넣어지고, 읽히며, 화면 녹화는 당시 화면에 있던 모든 것을 담고 있습니다. 이 도구는 비디오를 업로드하지 않지만, 보고서와 프레임은 사용자가 보내는 곳 어디든지 이동합니다.
기능
문제를 접수하지 않습니다. GitHub, Jira 또는 다른 어떤 것과도 연결되어 있지 않습니다. 보고서를 복사하여 해당 위치에 붙여넣기만 하면 됩니다. 이는 또한 다른 누구보다 먼저 보고서를 읽을 수 있다는 의미입니다.
로그, 네트워크 요청 또는 콘솔 출력을 캡처하지 않습니다. 이러한 것들은 개발자 도구에 있으며 일부 버그에 엄청나게 중요합니다. 콘솔을 촬영하는 대신 팀이 이미 사용하는 안전한 경로를 통해 첨부하세요.
그리고 아무것도 진단하지 않습니다. 원인, 어떤 구성 요소가 문제인지, 또는 이것이 기존 문제를 중복하는지 알려주지 않습니다. 누군가 작업할 수 있는 형태로 증거를 정리하는 것이 전부입니다.
버그를 처음부터 기록하기
여전히 문제를 캡처해야 한다면, 화면 녹화기가 브라우저에서 탭, 창 또는 전체 디스플레이를 기록합니다. 재현하는 동안 설명이 필요한 버그의 경우, 오디오와 함께 녹화하면 설명이 증거에 계속 첨부됩니다.
알아두면 좋은 두 가지 기능. 보고서 대신 단일 이미지를 원한다면, 비디오 프레임 추출기가 간격으로 프레임을 추출합니다. 그리고 녹화가 길고 음성 설명(walkthrough)을 텍스트로 원한다면, 스크립트 생성기가 설명을 검색 가능한 것으로 바꿔줍니다.
