데이터 수집 사용자 정의 규칙¶

이 문서에서는 Cocos Creator가 View, Action, Resource 및 Console Log를 자동 수집할 때의 기본 규칙과, 이름이나 필터 범위를 사용자 정의해야 할 때의 처리 방식을 설명합니다. RUM 수동 계측은 RUM 설정에서 함께 설명하며, 사용자 정의 로그 기록은 Log 설정에서 함께 설명합니다.

View¶

autoTrack.scenes를 활성화하면 SDK는 Cocos 씬 이름을 View 이름으로 사용합니다. 씬이 전환되면 이전 View를 종료한 후 새 씬에 대한 View를 시작합니다.

현재 Cocos Creator SDK는 자동 View 이름 변환이나 필터 콜백을 제공하지 않습니다. View 이름을 사용자 정의하거나 일부 씬을 건너뛰어야 한다면 autoTrack.scenes를 비활성화하고 guanceSdk.rum.startView() 및 stopView()를 통해 View를 수동으로 관리하세요.

Action¶

autoTrack.actions를 활성화하면 전역 TOUCH_END 이벤트에서 Action이 생성됩니다.

• 이벤트 대상 노드 이름을 우선적으로 Action 이름으로 사용합니다.
• 대상 노드에 이름이 없으면 CocosTouch를 사용합니다.
• Action 유형은 click입니다.
• 추가 속성에는 터치 위치 x, y가 포함됩니다.

현재 Cocos Creator SDK는 자동 Action 이름 변환이나 필터 콜백을 제공하지 않습니다. 이름, 속성 또는 수집 범위를 사용자 정의해야 한다면 autoTrack.actions를 비활성화하고 guanceSdk.rum.addAction() 또는 startAction()으로 수동으로 보고하세요.

Resource¶

autoTrack.network를 활성화하면 SDK는 현재 JavaScript 런타임의 fetch와 XMLHttpRequest를 자동 수집하고 URL, HTTP 메서드, 요청 헤더, 응답 헤더, 상태 코드, 요청 소요 시간을 기록합니다.

현재 Cocos Creator SDK는 URL 필터 또는 Resource 콘텐츠 처리 콜백을 제공하지 않습니다. 요청을 제외하거나 사용자 정의 속성을 추가하거나 사용자 정의 네트워크 스택을 사용해야 한다면 autoTrack.network를 비활성화하고 guanceSdk.rum.startResource() 및 stopResource()와 addResource()를 통해 수동으로 수집하세요. Trace Header를 주입해야 할 때는 guanceSdk.trace.getHeaders()를 사용하세요.

Console Log¶

autoTrack.console을 활성화하면 SDK는 console.log/info/warn/error를 래핑하여 Log에 기록합니다. 현재 Console 콘텐츠 필터 또는 변환 콜백은 제공되지 않습니다. 로그 콘텐츠를 필터링해야 한다면 autoTrack.console을 비활성화하고 guanceSdk.logger.log()로 비즈니스 필터를 거친 사용자 정의 로그를 기록하세요.