빠른 시작¶
이 문서는 UniApp RUM SDK의 최단 연동 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 전송을 완료할 수 있도록 돕습니다.
사전 준비¶
시작하기 전에 다음 준비를 완료하세요.
- 실제 사용자 모니터링(RUM) 에서 UniApp Android 및 UniApp iOS 애플리케이션을 각각 생성하고 각각의
RUM App ID를 획득하세요. - 전송 주소와 인증 방식을 확인하세요.
- 로컬 환경 배포:
datakitUrl을 준비하세요. -
공용 네트워크 DataWay:
datawayUrl과clientToken을 준비하세요. -
datakit-uniapp-native-plugin을 다운로드하여
GCUniPlugin과GC-JSPlugin을 준비하세요.
연동 단계¶
GCUniPlugin을 프로젝트의nativeplugins에 복사하고manifest.json에서 로컬 플러그인을 활성화하세요.GC-JSPlugin을 프로젝트의uni_modules에 복사하세요.App.vue에서sdkConfig를 호출하여 SDK 초기화를 완료하세요.rum.setConfig를 호출하여 Android 및 iOS의App ID를 구성하세요.- 페이지, 오류 또는 요청을 자동으로 수집하려면
GC-JSPlugin의 해당 기능을 연동하세요. debug를 활성화하고 애플리케이션을 실행하여 데이터가 성공적으로 전송되는지 확인하세요.
최소 초기화 예시¶
<script>
var ftModule = uni.requireNativePlugin("GCUniPlugin-MobileAgent");
var rum = uni.requireNativePlugin("GCUniPlugin-RUM");
export default {
onLaunch: function() {
ftModule.sdkConfig({
datawayUrl: "https://open.dataway.url",
clientToken: "client-token",
debug: true,
env: "common"
});
rum.setConfig({
androidAppId: "YOUR_ANDROID_APP_ID",
iOSAppId: "YOUR_IOS_APP_ID"
});
}
}
</script>
View 자동 수집 예시¶
다음은 Vue 2 호출 방식입니다. Vue 3는 gcViewTracking.startTracking(app)을 호출해야 합니다. 전체 예시는 RUM View 자동 수집을 참조하세요.
Resource 자동 수집 예시¶
uni.request를 처음 호출하기 전에 전역 수집기를 시작하면 이후에는 원래 요청 메서드를 교체할 필요가 없습니다.
import { gcResourceTracking } from '@/uni_modules/GC-JSPlugin';
gcResourceTracking.startTracking();
uni.request({
url: 'https://example.com/api'
});
iOS에서 rum.setConfig({ enableNativeUserResource: true })를 통해 네이티브 Resource 수집을 이미 활성화한 경우, 중복 수집을 방지하기 위해 gcResourceTracking.startTracking({ enableIOS: false })를 호출하세요. 자세한 내용은 RUM Resource 자동 수집을 참조하세요.
연동 성공 확인¶
debug: true를 활성화한 상태로 애플리케이션을 실행하세요.- 페이지를 열거나,
gcResourceTracking을 활성화한 후 표준uni.request를 통해 네트워크 요청을 한 번 보내세요. - 디버그 환경에서 SDK 초기화 및 데이터 동기화 로그가 정상적으로 출력되는지 확인하세요.
- 콘솔로 돌아가서 애플리케이션에 해당 플랫폼의 RUM 데이터가 나타나는지 확인하세요.