이 글을 통해 알 수 있는 것
- 페이지콜의 특정 미팅에 참가한 사용자의 로그와 네트워크 환경을 해석하는 방법
이럴 때 사용해보세요
- 특정 미팅을 분석하고, 근거를 토대로 사용자에게 오류 상황을 안내하고 싶은 경우
이렇게 사용하세요
미팅 로그 분석의 주요 지표 해석하기
페이지콜의 미팅 로그 분석 기능을 통해 페이지콜 미팅 내부에서 일어난 각종 이벤트들을 점검하고, 오류 상황을 진단할 수 있습니다. 미팅 로그 분석에 대한 설명은 다음 헬프센터 문서를 참고해 주세요.
미팅 로그 분석 이용하기 →
미팅 로그 분석에서는 다양한 지표와 이벤트들이 기록됩니다. 다음 예시와 같은 지표나 이벤트들이 나타난다면, 사용자는 설명에 적힌 오류 증상을 겪었을 확률이 있습니다. 이는 크게 네트워크 환경에 대한 문제와 하드웨어 장치에 대한 문제로 구분해 볼 수 있습니다.
네트워크가 불안정할때 나타날 수 있는 증상 알아보기
1. 불안정한 네트워크 환경
네트워크 환경은 손실과 지연 수치를 통해 문제 상황을 확인할 수 있습니다.
- 파란색 그래프는 네트워크 손실을, 보라색 그래프는 네트워크 지연을 나타냅니다.
- 다음 수치를 넘는 지점이 존재한다면, 사용자가 해당 시점에 문제를 겪었을 확률이 높습니다.
- 네트워크 손실이 50% 이상 일어났을 때
- 네트워크 지연이 100ms 이상 발생했을 때
- 또한, 사용자가 페이지콜을 사용하던 중 네트워크를 변경했을 경우 (다른 WIFI로 전환 혹은 WIFI에서 셀룰러 데이터(LTE, 5G)로 전환), 네트워크 손실이 100%로 기록되며, 문제를 겪었을 수 있습니다.
- 다음 수치를 넘는 지점이 존재한다면, 사용자가 해당 시점에 문제를 겪었을 확률이 높습니다.
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 미팅룸 접속 불가
- 미팅룸 접속 이후 튕김
- 서로의 영상/음성이 간헐적으로 끊김
- 서로의 카메라가 보이지 않음
- 서로 말하는 소리가 들리지 않음
- 화이트보드에 필기 불가
- 필기가 그려졌다가 사라짐
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 공유기와 사용 기기 사이를 가깝게 유지해 주세요.
- 와이파이 신호는 벽을 통과하기 힘들어서 공유기와 기기 사이에 벽이 있거나 사각지대가 존재할 경우
실시간 통신에 어려움이 있을 수 있습니다. 공유기와 기기 사이에 벽이 없는 장소에서 더욱 원활한
미팅(수업)을 진행할 수 있습니다.
- 공유기와 기기 사이에 벽과 같은 장애물이 있는 경우, 와이파이 이름에5G
표기가 없는 것을 시용해 주시기
바랍니다. 5G는 속도가 더 빠르지만, 중간에 장애물이 있는 경우 연결 신호가 더 불안정한 특성이 있습니다.
▶︎ 강의실과 관계 없는 다른 기기들의 Wi-Fi를 잠시 꺼주세요.
▶︎ 강의실과 관계 없는 다른 프로그램들을 종료해 주세요. (예. 보안, 공인인증서 프로그램 등등)
▶︎ 기기를 완전 종료 후 재시작해 주세요.
- 오랫동안 기기의 전원이 켜져 있으면 성능 저하가 발생할 수 있습니다.
기기의 전원을 완전히 종료하고 다시 켜주시면 문제가 해결되는 경우가 많습니다.
▶︎ 공유기를 재시작해 주세요.
- 공유기 전원을 해제한 후 30초 대기하고 다시 전원을 연결해 주세요.
▶︎ 인터넷 속도 저하가 있지는 않은지 확인해 주세요.
- https://fast.com/와 같은 서비스를 이용해 인터넷의 속도를 점검해 주세요.
10Mbps 이상의 인터넷 속도와 75ms 이하의 지연 시간에서 강의실을 원활하게 사용하실 수 있습니다.
인터넷 속도에 문제가 있는 경우, 통신사 혹은 인터넷 제공 업체에 문의해 주세요.
실시간 커뮤니케이션 서비스에서 가장 많이 겪을 수 있는 문제 증상의 원인이 불안정한 네트워크 환경인 만큼, 안정적인 네트워크 환경에서 서비스를 이용하는 것이 중요합니다. 자세한 내용은 아래의 헬프센터 글을 참조해 주세요.
페이지콜 접속을 위한 네트워크(인터넷 속도, 공유기) 권장 사양 확인하기 →
네이버나 유튜브는 잘 되는데 왜 페이지콜은 끊기나요? →
→ 아래에서 설명하게 될 지표들이 불안정한 네트워크 환경의 양상과 함께 나타난다면, 대부분 네트워크 환경이 주요 원인일 확률이 높습니다. 때문에 사용자에게 네트워크 환경의 개선을 안내할 수 있습니다.
만약 네트워크 환경이 정상임에도 아래의 지표들이 나타날 경우, 페이지콜 팀에 기술 지원을 요청해 주세요.
1-a. 음성 송수신 실패
음성 수신/송출 실패는 나의 마이크 소리를 상대방에게 전달하지 못했거나, 상대방의 마이크 소리를 가져오지 못했을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 나의 음성을 상대방에게 보내지 못함
- 내가 상대방의 음성을 받지 못함
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 상대방의 소리가 들리지 않음
- 상대방이 나의 소리가 들리지 않는다는 이야기를 함
1-b. 페이지 동기화 실패
페이지 동기화 실패는 나 혹은 상대방의 필기 데이터가 적절히 동기화되지 않았을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 나의 필기를 상대방과 동기화 하지 못함
- 상대방의 필기를 가져오지 못함
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 상대방의 필기가 보이지 않음
- 나의 필기가 그려졌다가 사라짐
- 내가 필기가 불가능한 상태가 됨
하드웨어 장치에 문제가 있을 때 나타날 수 있는 증상 알아보기
1. 마이크 꺼짐
마이크 꺼짐 기록은 사용자가 페이지콜 내에 마이크 버튼을 눌러 마이크를 껐을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 사용자가 마이크 버튼을 눌러 마이크를 끔
사용자가 의도적으로 마이크를 끈 경우, 이는 문제 상황이 아닙니다.
→ 그러나, 마이크를 끈 상황에서 '마이크가 작동하지 않는다, 내 소리가 상대방에게 들리지 않는다'는 문의 접수가 있을 수 있습니다. 해당 정보를 통해 사용자의 마이크 꺼짐/켜짐 여부를 파악할 수 있습니다.
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 마이크가 꺼져있는지 확인해 주세요. 마이크가 꺼져있을 경우 버튼으로 표시됩니다.
2. 카메라/마이크 연결/전환/해제
장치에 대한 연결/전환/해제 기록은 사용자의 기기가 변경되었을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 사용자가 카메라/마이크를 처음 연결
- 연결된 장치가 여러 개인 경우, 최초 장치에서 새로운 장치로 전환
- 장치를 물리적으로 제거 또는 연결 해제
사용자의 의도적인 기기 연결/전환/해제는 문제 상황이 아닙니다.
→ 그러나, 작동하지 않거나, 문제가 있는 기기를 연결한 채로 페이지콜에 접속할 경우, 카메라/마이크를 원활하게 사용할 수 없습니다. 해당 정보를 통해 정상적인 기기로 연결을 시도했는지 파악할 수 있습니다.
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 정상적인 기기가 선택된 상태인지 확인해 주세요.
의도하지 않은 기기가 선택된 경우, 카메라가 표시되지 않거나, 나의 목소리가 상대방에게 들리지 않을 수 있습니다.
- 버튼을 눌러 설정 창으로 진입하면, 비디오, 오디오 탭에서
현재 선택되어 있는 기기를 확인할 수 있습니다.
3. 카메라/마이크 장치 접근 권한 거부
장치 접근 권한 거부는 사용자가 장치 사용 권한을 거절했을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- (데스크탑) 브라우저에서 카메라/마이크 사용을 거부
- (태블릿, 모바일) 페이지콜을 사용 중인 앱 또는 브라우저에서 카메라/마이크 사용을 거부
→ 사용자가 장치 접근 권한을 거부하고 페이지콜에 입장할 경우, 해당 카메라/마이크 장치를 사용할 수 없습니다.
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 브라우저, 앱에서 카메라/마이크 사용 권한을 허용해 주세요.
기타 원인으로 나타날 수 있는 증상 알아보기
1. 백그라운드 모드 전환
백그라운드 모드는 사용자가 페이지콜을 사용 중 잠시 이탈했을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
-
- (데스크탑) 사용 중인 브라우저를 최소화
- (태블릿, 모바일) 페이지콜을 사용 중인 앱 또는 브라우저에서 홈화면으로 나감
- (태블릿, 모바일) 다른 앱으로 전환
백그라운드 모드에 진입하는 것 자체는 문제 상황이 아닙니다.
→ 그러나, 다음과 같은 상황이 함께 일어날 경우 문제가 생길 수 있습니다.
- 다른 앱으로 전환했을 때, 전환한 앱이 카메라나 마이크 사용을 점유한 상태로 페이지콜로 복귀
- 백그라운드 환경에서 불안정한 네트워크 환경이 된 채로 페이지콜로 복귀
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 나의 카메라를 사용할 수 없음
- 나의 마이크를 사용할 수 없음
- 미팅룸 접속 이후 필기 불가
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 사용하지 않는 앱이나 브라우저 창을 모두 닫아주세요. 강의실 사용과 동시에 다른 앱에서
카메라/마이크 사용이 일어날 경우 충돌을 일으킬 수 있습니다.
- 강의실 외의 브라우저나 앱 종료 이후, 새로고침을 통해 문제가 해결되었는지 확인해 주세요.
2. 페이지 내 필기 데이터 과부하
페이지 내 권장 획수 초과는 한 페이지에 쓰는 것을 권장하는 데이터량을 초과했을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 한 페이지 내에서 필기 데이터가 1000획을 초과하는 경우
사용자 기기의 성능에 따라, 이 상황은 문제가 되지 않을 수 있습니다.
→ 그러나, 1000획을 초과하는 페이지가 생길 경우 상대적으로 사양이 낮은 기기에서 문제 상황을 겪을 수 있습니다.
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 더 이상 필기가 불가능해질 정도로 느려짐
- 나의 필기가 그려졌다가 사라짐
- '오류가 발생하였습니다.' 라는 오류 화면을 마주함
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 한 페이지 내에서 과도하게 많은 양의 필기를 사용할 경우, 과부하가 생길 수 있습니다.
한 페이지 내에서 너무 많은 필기를 기록하지 않도록 주의해 주세요. 다음 페이지에 필기하거나, 서브 페이지
3. 펜모드 활성화
펜모드 활성화는 스타일러스 펜(애플 펜슬, S-pen 등) 사용에 최적화된 펜모드(손바닥 터치 방지)가 활성화되었을 때 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 사용자의 펜 사용이 감지되어 손바닥 터치 방지가 자동으로 켜짐
- 사용자가 손바닥 터치 방지를 직접 켬
또한 펜모드 사용 중 터치가 10회 이상 감지되면 기록됩니다. 다음과 같은 상황에 표시됩니다.
- 손바닥 터치 방지를 사용 중에 화이트보드 영역에 손으로 필기를 10회 이상 시도할 경우
펜으로 필기를 하는 일반적인 경우에, 이는 문제 상황이 아닙니다.
→ 손바닥 터치 방지가 활성화 되어 있을 때는 손으로 터치하여 필기하는 기능이 자동으로 비활성화 되기 때문에, '터치가 되지 않는다'는 문의 접수가 있을 수 있습니다. 해당 정보를 통해 사용자의 손바닥 터치 방지 꺼짐/켜짐 여부를 확인해 주시기 바랍니다.
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
▶︎ 스타일러스 펜(애플펜슬, S-pen)을 사용하지 않을 경우, 손바닥 터치 방지 기능을 비활성화 해주세요.
툴바의 펜 버튼을 클릭해 나타나는 메뉴에서 해당 기능을 비활성화 할 수 있습니다.
▶︎ 애플 펜슬의 경우, 펜의 배터리가 충분한지 확인해 주세요.
▶︎ 애플 펜슬의 경우, 아이패드와 연결이 잘 되어있는지 확인해 주세요.
4. 파일 변환, 콘텐츠를 불러오기 실패
업로드 파일 변환 실패와 콘텐츠 불러오기 실패의 경우, 페이지콜에 띄우려는 자료가 잘못되었을 경우 기록됩니다. 다음과 같은 상황에 로그로 표시됩니다.
- 사용자가 직접 업로드한 파일에 문제가 있을 경우
- Create pages를 통해 직접 추가한 파일에 문제가 있어서 불러오지 못한 경우
이 경우, 사용자가 경험할 수 있는 증상은 다음과 같습니다.
- 업로드한 파일을 불러오지 못함
- 업로드한 파일 영역에 새로고침 버튼만 지속적으로 보임
사용자에게는 다음과 같은 해결책을 안내해 볼 수 있습니다.
업로드한 파일을 불러오지 못할 경우
▶︎ 해당 파일에 문제가 없는지 확인해 주세요. 만약 정상적으로 열리는데도 문제가 있는 경우,
다시 변환해서 업로드했을 때 문제가 해결될 수 있습니다.
- iLovePDF(https://www.ilovepdf.com/)와 같은 서비스를 통해 pdf 파일 압축 후, 업로드를 시도해 주세요.
Create pages를 통한 파일 추가에 문제가 있는 경우,
이 경우, 사용자에게 직접 안내하는 것 보다 고객사에서 사용하는 파일의 URL이 문제가 없는지 먼저 확인이 필요합니다.
CORS 문제, 잘못된 파일 주소, 유효하지 않은 파일 등이 원인이 될 수 있습니다.
기술 지원 접수하기
로그 분석의 결과에도 오류 원인이 명확하지 않거나, 해당 시점에 특이 사항이 있을 경우, 다음 헬프센터 문서를 참고하여 기술 지원을 접수할 수 있습니다.