Teams에서 모니터링 및 문제 해결을 위한 로그 파일 구성

• 적용 대상:

  Microsoft Teams

클라이언트에서 자동으로 생성되는 세 가지 유형의 로그 파일이 있으며, 이를 활용하여 Teams 모니터링 및 문제 해결을 지원할 수 있습니다.

• 로그 디버그
  • 연속 디버그/웹 로그
• 미디어 로그
• 데스크톱 로그

이 문서에서는 이러한 로그와 로그를 사용하는 방법을 설명합니다. 특정 문제 해결에 대한 자세한 내용은 Teams 문제 해결을 참조하세요.

Microsoft Teams 룸 디바이스에서 로그를 수집하는 방법에 대한 자세한 내용은 디바이스 로그 다운로드를 참조하세요.

지원에 문의하는 방법에 대한 자세한 내용은 지원 받기를 참조하세요.

참고

이 문서에서 는 디버그 로그 (웹 로그라고도 함)라는 용어는 문제 해결에 사용되는 로그를 나타냅니다. 그러나 이러한 로그에 대해 생성된 파일에는 이름에 진단 로그 라는 용어가 포함됩니다.

로그 개요

문제가 발생하는 즉시 로그를 수집하는 것이 중요합니다.

Microsoft 지원 사용하여 지원 요청을 만들 때 지원 엔지니어는 디버그 로그가 필요합니다. 지원 요청을 만들기 전에 디버그 로그를 사용하면 Microsoft에서 신속하게 문제 해결을 시작할 수 있습니다. 미디어 또는 데스크톱 로그는 Microsoft에서 요청하는 경우에만 필요합니다.

로그 컬렉션

디버그/웹, 데스크톱 및 미디어 로그는 다운로드 디렉터리에 배치될 MSTeams 진단 로그 <로컬 날짜 및 시간을> 사용하여 한 폴더에 수집됩니다. Microsoft 지원 사용하여 지원 요청을 열 때 이 폴더를 압축하고 공유할 수 있습니다. 폴더에는 데스크톱, 모임(미디어) 및 디버그(웹)에 대한 폴더가 포함됩니다.

Windows에 대한 로그를 수집하려면 다음을 수행합니다.

• 시스템 트레이에서 Microsoft Teams 아이콘을 선택한 다음 지원 파일 수집을 선택합니다.

Mac용 로그를 수집하려면 다음을 수행합니다.

• Microsoft Teams에서 도움말 메뉴를 선택한 다음 지원 파일 수집을 선택합니다.

Linux에 대한 로그를 수집하려면 다음을 수행합니다.

• 시스템 트레이에서 Microsoft Teams 아이콘을 선택한 다음 로그 가져오기를 선택합니다.

Windows 및 Linux: Ctrl + Alt + Shift1 Mac: 옵션 + 명령 + Shift + + 1 바로 가기 키를 사용하여 파일을 수집할 수도 있습니다.

특정 모임 또는 라이브 이벤트에서 문제가 발생하는 경우 모임과 연결된 URL을 사용하는 것이 좋습니다. URL은 로그에서 정확한 모임 또는 라이브 이벤트를 정확히 파악하는 데 도움이 되는 추가 정보를 제공합니다. 이 정보는 모임 참가자나 라이브 이벤트의 발표자 또는 프로듀서로부터 수집할 수 있습니다. 이 URL은 조인 URL을 마우스로 가리키고 하이퍼링크 복사를 선택하여 캡처할 수 있습니다.

다음 표에서는 다양한 클라이언트 및 관련 로그에 대해 간략하게 설명합니다. 로그 파일은 수집되기 전에 Teams 앱 폴더에 저장되며 폴더의 위치는 클라이언트 및 운영 체제와 관련이 있습니다.

• Windows: %appdata%\Microsoft\Teams\
• Mac: ~/Library/Application Support/Microsoft/Teams/
• 리눅스: ~/.config/Microsoft/Microsoft Teams/

클라이언트	디버그	연속 디버그	데스크톱	미디어
Web	X	-	-	-
Windows	X	X	X	X
Mac OSX	X	X	X	X
iOS	-	-	-	-
Android	-	-	-	-

지원되는 운영 체제 및 브라우저의 전체 목록은 Microsoft Teams용 클라이언트 가져오기를 참조하세요.

로그 디버그

디버그 로그(웹 로그라고도 함)는 Windows 및 Mac 데스크톱 클라이언트와 브라우저 기반 클라이언트에서 생성됩니다. 로그는 텍스트 기반이며 아래에서 위로 읽습니다. 텍스트 기반 편집기를 사용하여 읽을 수 있으며 클라이언트에 로그인할 때 새 로그가 만들어집니다.

디버그 로그에는 다음 데이터 흐름이 표시됩니다.

• 로그인
• 중간 계층 서비스에 대한 연결 요청
• 통화/대화

연속 디버그 로그

연속 디버그 로깅(연속 웹 로깅이라고도 함)은 메모리에서 파일 시스템으로 로그를 연속 방식으로 자동으로 전송하여 로그 데이터를 캡처하는 데 도움이 되는 기능입니다. 평균적으로 사용 가능한 경우 하루 종일 사용할 수 있는 로그 데이터가 있습니다. 로그는 위에서 아래로 읽습니다.

CPU가 다음과 같은 경우 컴퓨터용 Teams 데스크톱에서 연속 디버그/웹 로깅이 기본적으로 켜져 있습니다.

• Intel Core i3 및 Core i5(10세대 이상), 코어 i7 및 코어 i9(모든 세대)는 U, Y, G1-G7, UE, UL, M 및 QM 접미사를 제외합니다.
• Intel Xeon
• AMD Ryzen 5, 7, 9 및 TR 시리즈(U 접미사 제외)
• Apple 실리콘

그렇지 않으면 기본적으로 꺼져 있습니다.

관리 구성

최종 사용자에 대한 지속적인 디버그/웹 로깅을 관리하면 특히 문제가 간헐적으로 발생하는 경우 원활한 문제 해결 환경을 제공합니다. 관리자는 TeamsMediaLoggingPolicy cmdlet을 사용하여 사용자를 위한 연속 디버그/웹 로깅을 사용하도록 설정하고 관리할 수 있습니다.

PowerShell cmdlet 에 대한 Grant-CsTeamsMediaLoggingPolicy 및 자세한 내용을 참조하세요.

미디어 로그

미디어 로그에는 Teams 모임의 오디오, 비디오 및 화면 공유에 대한 진단 데이터가 포함됩니다. 통화 관련 문제와 연결된 지원 사례에 필요합니다.

CPU가 다음과 같은 경우 컴퓨터에 대해 미디어 로깅이 기본적으로 켜져 있습니다.

• 모든 Apple M1
• 모든 Intel Xeon
• U, G7, M 및 MQ 시리즈를 제외한 모든 Intel i9
• U, G7, M 및 MQ 시리즈를 제외한 6세대 이상 Intel i7

그렇지 않으면 기본적으로 꺼져 있습니다. Teams 모임에 대한 진단 데이터를 기록하는 방법에는 두 가지가 있습니다.

• 관리 구성 - 최종 사용자의 미디어 로그를 관리할 수 있습니다.
• 최종 사용자 구성 - 최종 사용자가 미디어 로그를 켤 수 있습니다.

참고

미디어 로그는 WebRTC 기반 플랫폼(Teams 브라우저 클라이언트 및 최적화된 미디어가 있는 VDI용 클래식 Teams)에서 사용할 수 없습니다. 브라우저 클라이언트에서 추가 WebRTC 로그를 수집하는 방법에 대한 지침은 Teams용 브라우저 로그 및 추적 을 참조하세요. VDI용 Teams를 사용할 때 WebRTC 로그를 수집하는 방법에 대한 지침은 VDI 공급자에게 문의하세요.

관리 구성

최종 사용자에 대한 미디어 로그를 관리하면 특히 문제가 간헐적으로 발생하는 경우 원활한 문제 해결 환경을 제공합니다. 관리자는 TeamsMediaLoggingPolicy cmdlet을 사용하여 사용자에 대한 미디어 로깅을 사용하도록 설정하고 관리할 수 있습니다.

PowerShell cmdlet 에 대한 Grant-CsTeamsMediaLoggingPolicy 및 자세한 내용을 참조하세요.

최종 사용자 구성

최종 사용자가 Teams 모임에 대한 진단 데이터를 기록하려면 Teams 클라이언트에서 옵션을 설정해야 합니다. 설정>일반으로 이동하여 미디어 로그 사용(오디오, 비디오 및 화면 공유에 대한 진단 데이터) 검사 상자를 선택하고 문제를 재현합니다.

참고

사용자가 Teams에서 로그아웃하면 미디어 로깅이 기본값으로 다시 설정됩니다.

데스크톱 로그

부트스트래퍼 로그라고도 하는 데스크톱 로그에는 데스크톱 클라이언트와 브라우저 간에 발생하는 로그 데이터가 포함됩니다. 미디어 로그와 마찬가지로 이러한 로그는 Microsoft에서 요청하는 경우에만 필요합니다. 로그는 텍스트 기반이며 하향식 형식의 텍스트 기반 편집기를 사용하여 읽을 수 있습니다.

관련 항목

Teams 문제 해결

Teams용 브라우저 로그 및 추적