Calls 로깅

Mattermost v11.11번역일: 2026-09-02원본 보기

Mattermost Calls의 문제를 해결할 때는 분석에 필요한 로그 파일을 적절히 수집하는 것이 매우 중요합니다. 필요한 로그는 다음과 같습니다.

RTCD 로그

RTCD(실시간 통신 데몬) 로그 파일의 위치는 RTCD config.toml 파일의 설정에 따라 결정됩니다. 통합형 RTCD로 Calls를 실행 중이라면 이 로그는 표준 Mattermost 서버 로그에 포함됩니다.

클라이언트 로그

/call logs 슬래시 명령을 실행하면 가장 최근 통화의 로그를 출력해 기본적인 클라이언트 로그를 얻을 수 있습니다. 다만 JavaScript 콘솔 로그를 수집하는 편이 대체로 더 유용합니다. 이 로그를 수집하는 방법은 클라이언트에 따라 다릅니다.

  • 데스크톱 앱: 통화가 진행되는 동안 View > Developer Tools > Developer Tools for Call Widget으로 이동합니다. Filter 필드 옆의 로그 수준 드롭다운 메뉴에서 Verbose를 선택하면 디버그 출력을 볼 수 있습니다. 로그를 저장하려면 콘솔 안에서 마우스 오른쪽 버튼을 클릭한 뒤 Save as...를 선택합니다.

Developer Tools for Call Widget

  • Chrome 브라우저: 주소 표시줄 옆의 More menu(세로 점 3개)를 선택한 다음 More Tools > Developer Tools로 이동합니다. Console 탭을 선택하면 출력을 볼 수 있습니다. Filter 필드 옆의 로그 수준 드롭다운 메뉴에서 Verbose를 선택하면 디버그 출력을 볼 수 있습니다. 로그를 저장하려면 콘솔 안에서 마우스 오른쪽 버튼을 클릭한 뒤 Save as...를 선택합니다.

클라이언트 통계

/call stats 슬래시 명령을 실행하면 클라이언트 측 통화 통계를 수집할 수 있습니다. 통화 중에도 실행할 수 있지만, 통화가 끝난 직후에 실행하는 것이 가장 좋습니다. 이 명령은 클라이언트와 RTCD 사이에 협상된 연결에 관한 정보와 함께, 전송·유실된 미디어 패킷 통계를 제공합니다.

Mattermost 서버 로그

Mattermost 서버 로그에는 Calls 플러그인과 관련된 항목이 포함되는 경우가 많습니다. 외부 RTCD 인스턴스를 사용 중이라면 이 로그는 일반적으로 RTCD 로그나 클라이언트 로그보다 중요도가 낮습니다.

참고

통화 설정 과정의 ICE(Interactive Connectivity Establishment) 협상에서는 예상 범위 내의 정상적인 실패나 오류 메시지가 자주 기록되기 때문에, RTCD 로그와 클라이언트 로그를 해석하기 어려울 수 있습니다. 전체 로그 묶음을 Mattermost 지원팀에 전달해 분석을 의뢰하시기를 강력히 권장합니다.