오류 보고서를 사용하면 서버와 클라이언트 모두에 대한 최신 Luau 시스템 오류 및 경고를 확인할 수 있습니다. 게임을 업데이트하기 전후에 오류 보고서를 모니터링하여 잠재적인 문제를 조기에 식별하세요.
오류 보고서 보기
게임의 오류 보고서를 보려면:
- Creator Dashboard의 Creations 페이지로 이동하여 게임을 선택합니다.
- 모니터링 아래에서 오류 보고서를 선택합니다.
개별 경험 또는 그룹 소유 경험에 대한 분석을 볼 수 있습니다. 후자의 경우, 분석에 대한 그룹 권한이 필요합니다.
오류 및 경고 모니터링
다음 필터와 토글을 오류 보고서에 적용할 수 있습니다:
- 날짜 범위 — 마지막 1시간, 마지막 1일, 마지막 7일 또는 마지막 30일로 필터링합니다.
- 장소 — 장소로 필터링합니다.
- 버전 표시 — 오류 및 경고 차트에 장소 버전 주석을 추가합니다.
- 심각도 — 오류, 경고 또는 둘 다 표시하도록 필터링합니다.
- 플랫폼 — 특정 장치에서의 클라이언트 오류를 표시하도록 필터링합니다.
- 운영 체제 — 특정 운영 체제에서의 클라이언트 오류를 표시하도록 필터링합니다.
- 이후 새 오류 — 특정 버전 이후에만 새 오류 및 경고를 표시하도록 필터링합니다.
필터와 토글 아래에 차트가 표시되어 서버, 클라이언트 및 전체 오류와 경고의 숫자가 나타납니다. 이 차트를 사용하여 시간이 지남에 따라 오류와 경고의 증가를 확인하세요. 오류와 경고에서 큰 급등이 보이면 오류 보고서 테이블을 사용하여 문제를 해결합니다.
오류 및 경고 문제 해결
오류 및 경고 테이블에는 다음 열이 있습니다:
| 열 | 설명 |
|---|---|
| 개수 | 오류 또는 경고의 수. |
| 심각도 | 오류 또는 경고 레이블. |
| 유형 | 서버 또는 클라이언트 레이블. |
| 메시지 | 오류 또는 경고 메시지. |
| 처음 확인 시간 | 메시지가 처음 나타난 타임스탬프. |
| 첫 번째 확인 버전 | 장소가 선택된 경우에만 사용 가능. 메시지가 기록된 첫 번째 버전을 표시합니다. |
오류 또는 경고에 대한 스택 추적 보기
오류 또는 경고에서 드롭다운을 볼 수 있는 경우 클릭하여 확장하고 해당 스택 추적을 확인합니다. 스택 추적은 예외가 발생했을 때 게임이 수행하고 있던 호출 목록입니다. 이를 통해 무엇이 잘못되었는지 파악할 수 있습니다.
사용자 정의 규칙
사용자 정의 규칙을 사용하면 정규 표현식 또는 정확한 문자열 패턴을 정의하여 자동으로 오류 및 경고를 무시하거나 그룹화할 수 있습니다. 이를 통해 오류 보고서의 신호 대 잡음 비율을 관리할 수 있습니다. 경험당 최대 100개의 규칙을 만들 수 있습니다. 규칙은 우선 순위 순서로 위에서 아래로 평가됩니다. 오류가 규칙과 일치하면 추가 처리가 중지됩니다.
규칙 작업
각 규칙에는 두 가지 작업 중 하나가 있습니다:
| 작업 | 동작 |
|---|---|
| 무시 | 차트와 테이블에서 일치하는 오류를 숨깁니다. 피할 수 없는 엔진 소리 오류나 레거시 인쇄 문구와 같은 영구적인 잡음에 사용합니다. |
| 그룹화 | 지정한 사용자 정의 그룹 이름(예: "네트워크 문제", "오디오 스팸")으로 모든 일치하는 오류를 통합합니다. 그룹 이름은 테이블에서 단일 행으로 표시됩니다. |
규칙 만들기
규칙을 만드는 방법에는 두 가지가 있습니다:
오류 테이블에서 (인라인):
- 오류 행의 컨텍스트 메뉴(점 세 개)를 클릭합니다.
- 무시를 선택합니다.
규칙 탭에서:
- 오류 보고서 페이지의 규칙 탭으로 이동합니다.
- 규칙 만들기를 클릭합니다.
- 패턴(정확한 문자열 또는 정규 표현식)을 입력합니다.
- 작업 선택: 무시 또는 그룹화 → [그룹 이름].
- 규칙을 저장합니다.
규칙 생성 필드
| 필드 | 설명 |
|---|---|
| 패턴 | 오류 메시지와 대조할 정확한 문자열 또는 정규 표현식입니다. |
| 동작 | 무시(오류 숨기기) 또는 그룹화 → 사용자 정의 그룹 이름 입력을 선택합니다. |
규칙은 규칙 탭의 우선 순위 순서에 따라 위에서 아래로 평가됩니다. 오류가 규칙과 일치하면 해당 규칙의 작업이 실행되고 그 오류에 대해 추가 규칙이 평가되지 않습니다. 이는 오류가 하나의 규칙에 의해 그룹화된 다음 후속 규칙에 의해 무시되는 것과 같은 충돌을 방지합니다.
규칙은 저장된 후에 기록된 오류에만 영향을 미칩니다. 규칙이 수정되면 차트에 주석이 표시됩니다.
정규 표현식 기본 사항
정규 표현식(정규식)은 텍스트와 일치하는 패턴입니다:
| 구문 | 의미 | 예시 |
|---|---|---|
| . | 임의의 단일 문자 | H.t는 "Hat", "Hit", "Hot"와 일치합니다. |
| * | 이전 문자의 0회 이상 반복 | go*d는 "gd", "god", "good"과 일치합니다. |
| + | 이전 문자의 1회 이상 반복 | go+d는 "god", "good"과 일치하지만 "gd"와는 일치하지 않습니다. |
| .* | 임의의 문자 시퀀스(와일드카드) | Failed.*load는 "Failed to load" 및 "Failed xyz load"와 일치합니다. |
| \d | 모든 숫자(0-9) | v\d+는 "v1", "v123", "v4488"과 일치합니다. |
| \w | 모든 단어 문자(문자, 숫자, 밑줄) | \w+는 "Player123", "my_var"와 일치합니다. |
| ^ | 문자열 시작 | ^HTTP는 "HTTP"로 시작하는 오류와 일치합니다. |
| \/ | 이스케이프된 슬래시 | rbxassetid:\/\/는 "rbxassetid://"와 일치합니다. |
| \[ 및 \] | 이스케이프된 대괄호(정확한 일치) | \[Knit\]는 "[Knit]"와 일치합니다. |
| (a|b) | "a" 또는 "b"와 일치 | (Error|Warning):.*는 "Error: ..." 및 "Warning: ..." 모두와 일치합니다. |
빠른 팁:
- 특정 오류 하나만 잡고 싶다면 정확한 일치(전체 오류 문자열)로 시작하세요.
- 유사한 오류 모음을 잡고 싶다면 정규 표현식을 사용하세요(예: 자산 ID에 관계없이 모든 사운드 로딩 실패).
- 저장하기 전에 실제 오류 문자열 몇 가지와 패턴을 테스트하여 기대하는 대로 잘 잡히는지 확인하세요.
시스템은 정규 표현식 패턴에 대해 두 가지 규칙을 적용합니다:
- 반복 그룹 안에 반복자(+ 또는 *)를 넣을 수 없습니다. 예를 들어, (a+)* 또는 (\w+)+는 거부됩니다.
- 고정된 텍스트로 시작해야 합니다: 패턴은 .* 또는 .+와 같은 와일드카드로 시작할 수 없습니다. 패턴은 구체적인 문자 또는 고정(anchor)으로 시작해야 합니다(예: ^ 또는 리터럴 문자열).
오류 보고서를 정리하기 위한 규칙 예시
수십 개의 개별 오류 행을 보는 대신 관련 오류를 하나의 그룹 이름 아래에 통합하세요:
| 사용 사례 | 예시 오류 | 패턴 | 동작 |
|---|---|---|---|
| 모든 네트워크 오류 | HttpError: ConnectFail, HttpError: Timedout | HttpError:.* | 그룹화 → "네트워크 문제" |
| 데이터 저장소 경고 | DataStore request was added to queue, DataStoreService: ... | DataStore | 그룹화 → "데이터 저장소 경고" |
| 플레이어 GUI 오류 | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | 그룹화 → "PlayerGui 오류" |
| 사용자 정의 UI 프레임워크 | [UIManager] Button render failed, [UIManager] Layout overflow | \[UIManager\].* | 그룹화 → "UI 시스템" |
오류 추적 한계
시스템은 최대 500개의 고유 오류와 500개의 고유 경고를 수(카운트)와 버전별로 최대 100개의 새로운 오류를 추적합니다. 이 수치는 6시간마다 초기화됩니다. 이러한 제한 내에서 유용한 오류 추적을 극대화하려면:
- 사용자 ID, 좌표 또는 타임스탬프와 같은 오류 메시지에서 고유 식별자를 제거하세요. Player 12345 failed to load 및 Player 67890 failed to load와 같은 오류는 두 개의 별도 항목으로 계산됩니다. 이를 Player failed to load로 기록하면 더 높은 수치의 하나의 항목으로 통합됩니다.
- 동적 값에만 달라지는 관련 오류를 그룹화하려면 사용자 정의 규칙을 사용하세요.
오류 및 경고 해결
오류 보고서 페이지에서 오류를 조사할 때 다음 접근 방식을 사용하세요:
- 스택 추적 검토 — 오류 행을 확장하여 호출 경로를 확인하고 오류가 발생한 정확한 스크립트와 줄 번호를 식별합니다.
- 최근 업데이트 확인 — 가장 최근 업데이트 이후의 새로운 오류를 모니터링합니다.
- 내장 도구 사용:
- 개발자 콘솔 (F9 인게임): 실시간으로 발생하는 오류를 보고 수정 사항을 테스트합니다.
- 스크립트 프로파일러: 값비싼 작업으로 인한 성능 관련 오류를 식별합니다.
- 스튜디오의 출력 창 — 게시하기 전에 개발 중 오류를 포착합니다.
- 세부 정보 사용 — 오류가 특정 플랫폼(데스크탑, 모바일, 콘솔) 또는 운영 체제(Windows, macOS, iOS, Android)에 제한된 것인지를 확인합니다.
- 커뮤니티 피드백 수집 — 커뮤니티 Discord나 DevForum 게시물이 있는 경우 플레이어가 문제를 보고하고 어떤 장치나 지역에 영향을 받는지 확인합니다.