디버깅을 위한 지원 로그 번들 수집 WorkSpaces

WorkSpaces 문제를 해결할 때는 해당 WorkSpaces 클라이언트와 클라이언트가 설치된 호스트에서 로그 번들을 수집해야 합니다. WorkSpace 로그에는 두 가지 기본 범주가 있습니다.

• 서버측 로그: 이 시나리오에서는 서버가 서버이므로 자체적으로 존재하는 로그입니다. WorkSpace WorkSpace

• 클라이언트측 로그: 최종 사용자가 연결하는 데 사용하는 장치의 로그입니다. WorkSpace

• Windows 및 macOS 클라이언트만 로컬에서 로그를 기록합니다.

• Zero 클라이언트와 iOS 클라이언트는 로그하지 않습니다.

• Android 로그는 로컬 스토리지에서 암호화되어 WorkSpaces 클라이언트 엔지니어링 팀에 자동으로 업로드됩니다. 해당 팀만 Android 기기의 로그를 검토할 수 있습니다.

WSP 서버측 로그

모든 WSP 구성 요소는 로그 파일을 다음 두 폴더 중 하나에 기록합니다.

• 기본 위치: C:\ProgramData\Amazon\WSP\ 및 C:\ProgramData\NICE\dcv\log\

• 아카이브 위치: C:\ProgramData\Amazon\WSP\TRANSMITTED\

Windows에서 로그 파일 상세 정보 표시 변경하기

로그 상세 수준 그룹 정책 설정을 구성하여 WSP Windows의 로그 파일 세부 정보 표시 수준을 WorkSpaces 대규모로 구성할 수 있습니다.

개별 WorkSpaces 로그 파일의 상세 정보를 변경하려면 Windows 레지스트리 편집기를 사용하여 키를 구성하십시오. h_log_verbosity_options

1. Windows 레지스트리 편집기를 관리자 권한으로 엽니다.

2. \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon로 이동합니다.

3. WSP키가 없는 경우 마우스 오른쪽 버튼을 클릭하고 새로 만들기 > 키를 선택하고 이름을 지정합니다. WSP

4. \HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Amazon\WSP로 이동합니다.

5. h_log_verbosity_options값이 없는 경우 마우스 오른쪽 버튼을 클릭하고 새로 만들기 > DWORD를 선택하고 이름을 지정합니다. h_log_verbosity_options

6. 새 h_log_verbosity_options DWORD를 클릭하고 필요한 세부 정보 수준에 따라 값을 다음 숫자 중 하나로 변경합니다.

   • 0 — 오류

   • 1 — 경고

   • 2 — 정보

   • 3 — 디버그

7. 확인을 선택하고 Windows 레지스트리 편집기를 닫습니다.

8. 를 다시 시작합니다. WorkSpace

PCoIP 서버측 로그

모든 PCoIP 구성 요소는 로그 파일을 다음 두 폴더 중 하나에 기록합니다.

• 기본 위치: C:\ProgramData\Teradici\PCoIPAgent\logs

• 아카이브 위치: C:\ProgramData\Teradici\logs

복잡한 문제를 처리할 AWS Support 때 PCoIP Server 에이전트를 자세한 로깅 모드로 설정해야 하는 경우가 있습니다. 이 기능을 활성화하려면:

1. 다음 레지스트리 키를 엽니다. HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\PCoIP\pcoip_admin_defaults

2. pcoip_admin_defaults키에서 다음과 같은 32비트 DWORD를 생성합니다. pcoip.event_filter_mode

3. 의 값을 “3" (12/16진수) pcoip.event_filter_mode 로 설정합니다.

참고로 다음은 이 DWORD에서 정의할 수 있는 로그 임계값입니다.

• 0 — (중요)

• 1 — (오류)

• 2 — (정보)

• 3 — (디버그)

pcoip_admin_defaultDWORD가 존재하지 않는 경우 기본적으로 로그 레벨이 설정됩니다2. 더 이상 자세한 로그가 필요하지 않은 후에는 값을 2 DWORD로 복원하는 것이 좋습니다. DWORD는 크기가 훨씬 크고 디스크 공간을 불필요하게 소비하기 때문입니다.

WebAccess 서버측 로그

PCoIP 및 WSP (버전 1.0+) 의 WorkSpaces 경우 WorkSpaces 웹 액세스 클라이언트는 STXHD 서비스를 사용합니다. 웹 액세스 로그는 에 저장됩니다. WorkSpaces C:\ProgramData\Amazon\Stxhd\Logs

WSP (버전 2.0+) 의 WorkSpaces 경우 WorkSpaces 웹 액세스 로그는 에 저장됩니다. C:\ProgramData\Amazon\WSP\

클라이언트측 로그

이러한 로그는 사용자가 연결하는 WorkSpaces 클라이언트에서 생성되므로 최종 사용자의 컴퓨터에 기록됩니다. Windows 및 Mac의 로그 파일 위치는 다음과 같습니다.

• Windows: "%LOCALAPPDATA%\Amazon Web Services\Amazon WorkSpaces\Logs"

• macOS: ~/Library/"Application Support"/"Amazon Web Services"/"Amazon WorkSpaces"/logs

• Linux: ~/.local/share/Amazon Web Services/Amazon WorkSpaces/logs

사용자가 겪을 수 있는 문제를 해결하는 데 도움이 되도록 모든 Amazon WorkSpaces 클라이언트에서 사용할 수 있는 고급 로깅을 활성화하십시오. 고급 로깅은 비활성화될 때까지 모든 후속 클라이언트 세션에 대해 활성화됩니다.

1. 에 연결하기 전에 최종 사용자는 WorkSpaces 클라이언트에 대한 고급 로깅을 활성화해야 합니다. WorkSpace

2. 그런 다음 최종 사용자는 평소와 같이 연결하여 사용하고 문제를 재현해 봐야 합니다. WorkSpace

3. 고급 로깅은 상세 성능 데이터를 비롯하여 진단 정보와 디버깅 수준 세부 정보가 포함된 로그 파일을 생성합니다.

이 설정은 명시적으로 해제할 때까지 유지됩니다. 사용자가 자세한 로그온 문제를 성공적으로 재현한 후에는 로그 파일이 커지므로 이 설정을 사용하지 않도록 설정해야 합니다.

Windows용 자동 서버측 로그 번들 수집

Get-WorkSpaceLogs.ps1스크립트는 서버 측 로그 번들을 빠르게 수집하는 데 유용합니다. AWS Support 지원 사례에서 AWS Support 요청하여 스크립트를 요청할 수 있습니다.

1. 클라이언트를 사용하거나 RDP (원격 데스크톱 프로토콜) 를 사용하여 연결합니다. WorkSpace

2. 관리 명령 프롬프트를 시작합니다 (관리자 권한으로 실행).

3. 명령 프롬프트에서 다음 명령을 사용하여 스크립트를 실행합니다.

   powershell.exe -NoLogo -ExecutionPolicy RemoteSigned -NoProfile -File "C:\Program Files\Amazon\WorkSpacesConfig\Scripts\Get-WorkSpaceLogs.ps1"
         

4. 스크립트는 사용자 데스크톱에 로그 번들을 생성합니다.

   스크립트는 다음 폴더가 포함된 zip 파일을 만듭니다.

   • C — 스카이라이트, EC2Config, Teradici ProgramData, 이벤트 뷰어 및 Windows 로그 (Panther 및 기타) 와 관련된 프로그램 파일, 프로그램 파일 (x86) 및 Windows의 파일을 포함합니다.

   • cliXML — 대화형 필터링에 사용하여 Powershell에서 가져올 수 있는 XML 파일을 포함합니다. Import-CliXML 가져오기-Clixml을 참조하십시오.

   • Config - 수행된 각 검사에 대한 세부 로그

   • ScriptLogs— 스크립트 실행에 대한 로그 (조사와는 관련이 없지만 스크립트가 수행하는 작업을 디버깅하는 데 유용함).

   • tmp —임시 폴더 (비어 있어야 함)

   • 추적 - 로그 수집 중에 수행된 패킷 캡처입니다.