Crash and Exception Reporting 설정
Enable Crash and Exception Reporting in the Unity Editor, and configure advanced custom metadata for detailed crash reports.
읽는 시간 1분최근 업데이트: 한 달 전
프로젝트에서 Crash and Exception Reporting을 설정하기에 앞서 시작하기 가이드의 기본 설정 요구 사항을 따랐는지 확인합니다. 프로젝트 ID를 Unity Dashboard의 프로젝트에 연결하는 것이 중요합니다. 대시보드가 기본 프로젝트 자격 증명으로 설정되면 Unity 에디터에서 프로젝트에 대한 Crash and Exception Reporting을 활성화할 수 있습니다. Crash and Exception Reporting 활성화 방법:
- Unity 에디터에서 프로젝트를 엽니다.
- Unity 에디터 메뉴에서 Window > General > Services를 선택하여 Services 창을 엽니다.
- Services 창에서 Cloud Diagnostics를 선택합니다.
- Crash and Exception Reporting 옆의 토글을 선택하여 서비스를 켭니다.
Advanced Cloud Diagnostics로 커스터마이즈된 리포트 설정
기본적으로 크래시 및 예외 리포트는 디바이스 OS 등 표준 메타데이터와 함께 구성됩니다. Advanced Cloud Diagnostics를 활용하면 더 많은 디버깅 용량에 대해 커스텀 메타데이터를 추가할 수 있습니다. 이 커스텀 메타데이터는 게임이 처음 시작될 때, 새 레벨을 로드할 때, 플레이어가 특정 행동을 수행할 때 등 언제든 캡처될 수 있습니다. 크래시 및 예외 리포트는 크래시 리포트와 커스텀 메타데이터 구성을 위해 CrashReportHandler 클래스를 포함합니다. SetUserMetadata 메서드를 사용하여 최대 64개의 커스텀 메타데이터 엔트리를 리포트에 추가할 수 있습니다. 다음 구문으로 트래킹할 새 메타데이터를 요청합니다.UnityEngine.CrashReportHandler.CrashReportHandler.SetUserMetadata(“key”, “value”);
테스트 리포트 트리거
리포트를 트리거하여 Unity Dashboard에서 보면서 Cloud Diagnostics 서비스를 테스트합니다. 예외를 일으키거나 Debug.LogException() 메서드를 통해 예외 메시지를 로깅하여 리포트를 생성합니다. 그렇게 하려면 첫 화면 로드 시 실행되는 스크립트 등 예외 발생을 테스트할 C# 스크립트 내에서 메서드를 찾고 다음 줄을 추가합니다.스크립트를 저장하고 게임을 플레이 모드에서 실행합니다. Debug.LogException 메시지를 에디터 내 콘솔에서 볼 수 있을 것입니다.Debug.LogException(new Exception(“Testing Cloud Diagnostics reports”));
테스트 리포트 보기
Unity Dashboard에서 Cloud Diagnostics 리포트를 보려면 다음 단계를 따릅니다.- Unity Dashboard를 엽니다.
- 상단 내비게이션 메뉴의 프로젝트 선택자에서 Cloud Diagnostics가 활성화된 프로젝트를 선택합니다.
- 메인 내비게이션 메뉴에서 Suites > DevOps > Cloud Diagnostics > Crash and Exception Reporting으로 이동합니다.
- 테스트 리포트는 Problems 섹션에 있을 것입니다. 테스트 리포트의 제목을 선택하여 데이터를 봅니다.
새 리포트에 대한 알림 설정
Cloud Diagnostics는 개발 워크플로를 Unity가 아닌 툴과 연결할 수 있도록 연동을 통한 리포트 알림을 지원합니다. 새 문제가 리포트되었는지 확인하기 위해 대시보드를 수동으로 확인하는 대신 이메일, Slack, Discord, Trello 등 타사 연동을 통해 알림을 받을 수 있습니다. 리포트 알림을 설정하려면 다음 단계를 따릅니다.- Unity Dashboard를 엽니다.
-
상단 내비게이션 메뉴의 프로젝트 선택자에서 프로젝트를 선택합니다.
- 참고: 리포트 알림을 설정하기 전에 이 프로젝트에 대해 Crash and Exception Reporting을 활성화했는지 확인하십시오.
- 메인 내비게이션 메뉴에서 Projects를 선택합니다.
- 펼친 드롭다운 목록에서 Project settings > Integrations를 선택합니다.
- New Integration 버튼을 선택하고 팝업 모달에서 가이드를 따릅니다.