데스크톱 앱에서만 생기는 문제는 로그로 확인합니다
컴퓨터에 설치한 데스크톱 앱에서 문제가 생기면 지원 로그 번들을 내보낼 수 있습니다. 브라우저에서 로그인했는데 앱에 반영되지 않는 경우, 앱이 빈 화면으로 열리는 경우, 업데이트가 끝나지 않고 반복되는 경우, 탭이 복원되지 않는 경우가 대표적입니다. 알림이 이상하게 동작하거나 같은 캔버스가 브라우저와 데스크톱 앱에서 다르게 동작할 때도 로그가 도움이 됩니다.
로그는 지원팀이 요청했거나 데스크톱 앱 버그를 신고할 때만 내보내세요. 계정, 결제, 권한, 사라진 작업에 관한 일반 문의라면 스크린샷과 링크만으로 충분할 수 있습니다.
지원 범위
| 항목 | 내용 |
|---|---|
| 지원 환경 | macOS, Windows 데스크톱 앱 |
| 저장 위치 | 직접 선택합니다. 보통 다운로드 폴더에 저장합니다. |
| 파일 형식 | .allo-logbundle 파일 1개 |
| 보안 | ALLO 지원팀이 확인할 수 있도록 암호화됩니다. |
| 보내는 사람 | 데스크톱 앱 문제를 직접 겪고 있는 사용자 |
로그 번들 내보내기
- ALLO 데스크톱 앱을 엽니다.
- 도움말 → 로그 내보내기를 선택합니다.
- 저장 위치를 묻는 창이 나오면 원하는 폴더를 선택합니다.
- 내보내기가 끝날 때까지 기다립니다.
- 만들어진
.allo-logbundle파일 하나를 지원팀에 보냅니다.
지원팀이 따로 요청하지 않았다면 파일 이름을 바꾸지 마세요. 번들을 풀어서 안에 든 파일을 하나씩 보내지도 마세요. 번들은 파일 하나 그대로 보내야 지원팀이 안전하게 열어 확인할 수 있습니다.
번들에 담기는 정보
상황에 따라 조금씩 다르지만, 데스크톱 로그 번들에는 보통 다음 정보가 들어갑니다.
| 정보 | 지원팀이 확인하는 내용 |
|---|---|
| 데스크톱 앱 로그 | 컴퓨터에서 발생한 오류, 업데이트 과정, 앱 상태 |
| 운영체제 정보 | 사용 중인 macOS나 Windows 버전에 알려진 문제가 있는지 |
| 디스플레이와 창 정보 | 빈 화면, 창 조절 버튼, 레이아웃 문제의 원인 |
| 네트워크와 로딩 기록 | 앱 콘텐츠를 불러오지 못했는지 |
| 탭과 화면 이동 상태 | 탭 복원, 캔버스 열기, 페이지 이동이 어떻게 처리됐는지 |
로그 번들을 보낼 때 비밀번호를 함께 알려 줄 필요는 없습니다. 데스크톱 앱 문제를 진단하는 데 비밀번호, 카드 번호 전체, 은행 인증 정보, 복구 코드, 워크스페이스의 기밀 정보는 필요하지 않습니다.
개인정보와 보안
내보낸 번들은 ALLO 지원팀만 열 수 있도록 암호화됩니다. .allo-logbundle 파일은 지금 문의하고 있는 지원 채널로 보내세요. 지원팀이 로그의 일부만 짧게 요청한 경우가 아니라면 긴 로그 원문을 채팅에 붙여 넣지 마세요.
민감한 워크스페이스 콘텐츠와 관련된 문제라면 스크린샷이나 파일을 보내기 전에 지원팀에 먼저 알리세요. 로그 번들은 진단용으로 만들어지지만, 스크린샷이나 재현 영상에는 화면에 보이는 캔버스 내용이 그대로 담깁니다.
지원팀이 로그를 요청하는 경우
지원팀은 다음과 같은 문제에서 로그 번들을 요청합니다.
| 문제 | 로그로 확인할 수 있는 것 |
|---|---|
| 브라우저에서 로그인한 뒤 데스크톱 앱에 반영되지 않음 | 앱이 브라우저에서 넘어온 로그인 정보를 받았는지 |
| 앱이 빈 화면으로 열리거나 멈춤 | 로딩, 네트워크, 앱 오류 |
| 업데이트 안내가 계속 나타남 | 업데이트 진행 상황과 실패 지점 |
| 탭이 복원되지 않음 | 저장된 데스크톱 상태와 복원 시도 기록 |
| 알림이나 배지가 동작하지 않음 | 앱 상태 문제인지, 운영체제 권한 문제인지 |
| 같은 캔버스가 데스크톱 앱과 브라우저에서 다르게 열림 | 데스크톱 탭에서 캔버스를 불러오는 과정 |
문의하기 전에 준비할 내용은 지원팀에 문의할 때 필요한 정보를 참고하세요.
로그를 내보낼 수 없을 때
다음 순서로 확인하세요.
- 데스크톱 앱을 다시 시작합니다.
- 도움말 → 로그 내보내기를 다시 선택합니다.
- 선택한 폴더에 ALLO가 파일을 저장할 수 있는지 확인합니다.
- 네트워크 드라이브에 저장되지 않으면 다운로드 폴더나 바탕화면에 저장합니다.
- 로그를 내보낼 수 있을 만큼 앱이 열리지 않는다면 그 상황을 지원팀에 알립니다.
회사에서 관리하는 컴퓨터라면 보안 프로그램이 번들 파일 저장이나 첨부를 막을 수 있습니다. 필요하면 IT 관리자에게 로그 내보내기를 허용해 달라고 요청하세요.
번들과 함께 보낼 내용
로그 번들이 있어도 지원팀은 어떤 상황이었는지 알아야 합니다. 다음 내용을 함께 적어 보내세요.
| 항목 | 예시 |
|---|---|
| 발생한 문제 | "브라우저에는 로그인이 완료됐다고 나오는데 데스크톱 앱은 계속 로그인 화면입니다." |
| 발생 시점 | 날짜, 시각, 시간대 |
| 시도한 방법 | 재시작, 업데이트, 브라우저에서 비교, 재설치 |
| 계정 이메일 | ALLO에 로그인한 이메일 |
| 워크스페이스나 링크 | 문제가 생긴 워크스페이스, 캔버스, 대시보드, 페이지 주소 |
| 운영체제와 앱 버전 | macOS나 Windows 버전, 확인할 수 있다면 ALLO 버전 |
비밀번호, 카드 번호 전체, 개인 키, 문제와 관련 없는 기밀 문서는 보내지 마세요.
로그 내보내기 문제 해결
| 증상 | 예상 원인 | 해결 방법 |
|---|---|---|
| 내보내기 메뉴가 없음 | 데스크톱 앱이 아니라 브라우저에서 ALLO를 쓰고 있을 수 있습니다. | ALLO 데스크톱 앱에서 메뉴를 찾고 있는지 확인하세요. |
| 내보내기에 실패함 | 저장 위치를 사용할 수 없거나 앱이 그 위치에 파일을 쓸 수 없습니다. | 다운로드 폴더나 바탕화면을 선택해 다시 시도하세요. |
| 파일이 커서 첨부되지 않음 | 지원 채널의 첨부 용량 제한 | 지원팀에 다른 업로드 방법을 요청하세요. |
| 지원팀이 파일을 열 수 없음 | 번들을 풀었거나 파일 이름을 잘못 바꿨습니다. | 처음 만들어진 .allo-logbundle 파일을 그대로 보내세요. |
| 앱이 열리지 않음 | 일반적인 방법으로는 로그를 내보낼 수 없습니다. | 지원팀에 문의해 앱이 시작되지 않는 상황을 설명하세요. |
