버그 보고서 생성기

녹화 영상을 즉시 조치 가능한 리포트로 변환하세요

버그 화면 녹화 영상을 불러오세요. 영상을 재생하면서 중요한 동작이 발생할 때마다 표시를 남깁니다. 타임스탬프가 기록되고, 해당 시점의 비디오 프레임이 캡처되어 번호가 매겨진 단계별 목록에 추가됩니다.

요약, 예상했던 동작, 실제로 발생한 현상을 작성한 다음 GitHub용 Markdown, Jira 마크업 또는 일반 텍스트 형태로 전체 내용을 복사하세요. 브라우저 및 화면 세부 정보는 이미 자동으로 입력되어 있습니다.

녹화 영상은 절대 기기 외부로 전송되지 않습니다. 로컬 파일에서 재생되고 프레임 추출 또한 사용자의 기기에서 직접 이루어지므로, 아직 출시되지 않은 빌드나 고객 계정에서 발생한 버그를 다룰 때도 안전합니다.

이 기능이 AI를 사용하여 보고서를 작성하지 않는 이유

화면 녹화를 보는 모델은 자신이 보는 것을 설명할 수 있습니다. 하지만 사용자가 무엇을 보기를 기대했는지는 알 수 없으며, 이는 버그 보고서의 절반으로 누가 조치를 취할지 결정하는 부분입니다.

“확인 버튼을 클릭했는데, 인보이스 패널이 비어 있었습니다”는 관찰입니다. 그것이 버그인지 여부는 전적으로 거기에 무엇이 나타났어야 하는지에 달려 있으며, 그것을 아는 유일한 사람은 당신입니다. 비디오에서 예상되는 동작을 생성하는 도구는 추측하고 그 추측을 발견으로 제시하는데, 이는 필드를 비워두는 것보다 나쁩니다. 그럴듯하지만 잘못된 기대는 개발자를 잘못된 길로 이끌 수 있기 때문입니다.

따라서 여기서의 분리는 의도적입니다. 도구는 타임스탬프, 프레임, 환경, 서식, 번호 매기기와 같이 기계적인 작업을 정확히 수행합니다. 당신은 판단을 제공합니다. 이는 약 1분 정도 걸리며, 결과는 누구도 다시 당신에게 물어볼 필요가 없는 보고서입니다.

보고서에서 흔히 놓치는 세 가지

많은 부실한 버그 보고서를 읽어보면 동일한 간극이 반복되며, 이 세 가지 모두 어려운 것이 아니라 기계적인 것입니다.

타임스탬프. “첨부된 비디오 참조”라고만 된 보고서는 독자가 순간을 찾기 위해 4분을 시청하게 만듭니다. 1:12에 발생했다고 명시된 단계는 그렇지 않습니다.

환경. 브라우저, 운영 체제, 화면 크기. 모두 포함해야 한다는 것을 알지만, 생각을 하는 도중에 설정 패널을 열어야 하기 때문에 거의 아무도 포함하지 않습니다. 여기서는 브라우저에서 읽어와 보고서에 이미 채워져 있으며, 수정할 수 있습니다.

스틸 이미지. 오류 발생 순간의 프레임은 20개 문제 목록에서 스캔되는 것입니다. 비디오에서 프레임을 수동으로 추출하는 것은 너무 번거로워서 사람들이 건너뛰는 경향이 있으므로, 표시하는 각 단계에서 자동으로 발생합니다.

정확히 무엇이 캡처되는가

각 표시된 단계는 정확한 재생 시간과 그 시점의 비디오에서 추출된 JPEG 프레임을 기록하며, 보고서를 가볍게 유지하기 위해 축소됩니다. 프레임을 다운로드하여 문제에 첨부할 수 있습니다.

환경은 브라우저에서 가져옵니다: 브라우저 이름과 버전, 운영 체제, 픽셀 비율이 포함된 화면 크기, 그리고 뷰포트 크기. 브라우저는 예전보다 자신에 대한 정보를 적게 보고하므로, 일부는 알 수 없음으로 표시될 수 있으며, 모든 필드는 잠겨 있지 않고 편집 가능합니다.

픽셀에서 아무것도 추론되지 않습니다. 이 도구는 화면에서 오류 텍스트를 읽거나 사용자가 어떤 요소를 클릭했는지 추측하려고 시도하지 않습니다. 왜냐하면 그렇게 하는 것이 신뢰할 수 없을 경우 안 하는 것보다 더 나쁘기 때문입니다.

채워지는 구조

출력은 버그 보고서가 정착된 형태를 따릅니다. 트래커와 이를 읽는 사람들이 그 형태를 기대하기 때문입니다. 버그 보고서 템플릿을 찾고 있었다면, 이것은 붙여넣고 쳐다보는 것이 아니라 이미 채워진 상태로 도착하는 템플릿입니다.

요약이 한 줄로 먼저 나옵니다. 왜냐하면 그 한 줄이 서른 개의 문제 목록에서 누군가가 스캔하는 것이고, 오늘 당신의 문제가 열릴지 결정하기 때문입니다.

그런 다음 각 단계에 타임코드가 있는 번호 매겨진 단계, 예상되는 동작, 실제 동작, 그리고 환경이 나옵니다. 이 순서는 꾸밈이 아닙니다. 독자는 재현 가능한지 확인하기 위해 단계를 확인하고, 실제로 버그인지 확인하기 위해 예상과 실제를 짝지어 확인하며, 자신과 관련된 문제인지 확인하기 위해 환경을 확인합니다. 이 중 어느 하나라도 숨기면 왕복하는 데 비용이 듭니다.

빈 템플릿이 할 수 없는 것은 스스로 채워지는 것인데, 이것이 사람들이 템플릿을 건너뛰게 만드는 부분입니다. 여기서는 단계, 타임코드, 프레임 및 환경이 채워져 도착하며, 도구가 진정으로 알 수 없는 세 가지 필드를 당신이 작성합니다.

녹화 전 확인 사항

리포트의 품질은 녹화 영상에 달려 있으며, 두 가지 습관이 큰 차이를 만듭니다.

명확한 초기 상태에서 시작하세요. 세션 도중에 시작되는 녹화 영상은 보는 이로 하여금 이전 상황을 짐작하게 만들어 재현하기 어렵게 만듭니다. 로그인 화면, 새로 고침한 페이지 또는 명확히 설명된 시작 지점에서 녹화를 시작하세요.

외부로 유출되면 안 되는 내용은 화면에서 모두 정리하세요. URL 주소창의 토큰, 고객 이름, 다른 탭에 열려 있는 무관한 이메일, 개발자 도구 패널의 API 키 등이 해당됩니다. 버그 리포트는 다른 사람에게 전달되거나 채팅방에 공유되고 팀 외부 사람들도 보게 되는데, 화면 녹화에는 당시 화면에 있던 모든 것이 그대로 담깁니다. 이 도구는 비디오를 업로드하지 않지만, 생성된 리포트와 프레임 이미지는 전송하는 곳마다 공유됩니다.

지원하지 않는 기능

이 도구는 이슈를 자동으로 등록해주지 않습니다. GitHub, Jira 등과의 연동 기능은 제공되지 않습니다. 리포트를 복사하여 적절한 곳에 직접 붙여넣어야 하며, 이는 다른 사람이 보기 전에 리포트 내용을 먼저 검토할 수 있다는 의미이기도 합니다.

로그, 네트워크 요청 또는 콘솔 출력은 캡처하지 않습니다. 이러한 정보는 개발자 도구에 있으며 일부 버그를 해결하는 데 매우 중요합니다. 콘솔 화면을 직접 영상으로 찍기보다는 팀에서 이미 사용하는 안전한 방법을 통해 별도로 첨부하세요.

또한 버그를 진단하지 않습니다. 원인이 무엇인지, 어느 컴포넌트의 결함인지, 이미 등록된 이슈와 중복되는지 여부는 알려주지 않습니다. 이 도구의 역할은 누군가가 작업을 시작할 수 있도록 근거 자료를 체계적으로 정리해 주는 것뿐입니다.

애초에 버그를 녹화하는 방법

문제를 먼저 캡처해야 한다면 화면 녹화기를 사용하여 브라우저에서 탭, 창 또는 전체 화면을 녹화할 수 있습니다. 버그를 재현하면서 음성 설명이 필요한 경우, 오디오와 함께 녹화하면 설명이 증거 자료에 함께 포함됩니다.

함께 알아두면 좋은 두 가지 도구도 있습니다. 리포트 대신 개별 이미지만 필요한 경우 비디오 프레임 추출기를 사용하면 일정 간격으로 프레임을 추출할 수 있습니다. 또한 녹화 영상이 길어 음성 설명을 텍스트로 변환하고 싶다면 텍스트 변환기를 통해 음성을 검색 가능한 텍스트로 바꿀 수 있습니다.

녹화 영상에 버그에 대해 질문하기

이 페이지에서 진행되는 작업은 사용자 기기에서 직접 실행되며 계정이 필요하지 않습니다. 녹화 영상에서 어떤 말이 오갔는지 또는 무엇이 표시되었는지에 대한 답변이 필요하다면 ScreenApp에 업로드하세요. 질문을 클릭하면 해당 질문이 준비된 상태로 ScreenApp이 열립니다.

ScreenApp에서는 스크립트의 순간을 클릭하면 플레이어가 녹음의 해당 지점으로 이동합니다. 기능이 제공되므로, 어떤 답변이든 녹화 영상과 대조하여 확인할 수 있습니다.

각 요금제의 기능

이 페이지의 도구는 무료이며 앞으로도 계속 무료로 제공됩니다. 계정은 이 도구를 사용하기 전 단계나 사용한 후 단계를 위한 것입니다.