빠른 시작¶
이 문서는 Unity RUM SDK의 가장 짧은 연동 경로를 제공하여 최소한의 단계로 검증 가능한 데이터 보고를 완료할 수 있도록 돕습니다.
앱은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 설정을 설명합니다.
사전 준비¶
시작하기 전에 다음 준비를 완료하세요:
- 실제 사용자 모니터링(RUM)에서 Unity Android 및 Unity iOS 앱을 각각 생성하고 해당
App ID를 확인하세요. - 보고 주소와 인증 방식을 확인하세요:
- 로컬 환경 배포:
datakitUrl준비 - 퍼블릭 DataWay:
datawayUrl및clientToken준비 - 프로젝트에
ft-sdk-unity.unitypackage가 임포트되었는지 확인하세요. - 프로젝트에
"com.unity.nuget.newtonsoft-json"이 설치되었는지 확인하세요.
연동 단계¶
FTSDK.prefab을 첫 번째 씬으로 드래그합니다.- 앱 시작 시
FTUnityBridge.Install(...)을 호출합니다. RUMConfig를 초기화하고 Android 및 iOS에 해당하는App ID를 전달합니다.- 필요에 따라
LogConfig및TraceConfig를 초기화합니다. - 앱을 실행하고 페이지 열기, 로그 출력 또는 네트워크 요청을 한 번 트리거합니다.
- Unity 콘솔과 Guance 플랫폼에서 데이터가 성공적으로 보고되었는지 확인합니다.
최소 초기화 예시¶
FTUnityBridge.Install(new SDKConfig
{
// 로컬 환경 배포 시 datakitUrl 사용
datakitUrl = "http://10.0.0.1:9529",
// 퍼블릭 DataWay 사용 시 datawayUrl + clientToken
// datawayUrl = "https://open.dataway.url",
// clientToken = "client-token",
env = "prod",
debug = true,
});
FTUnityBridge.InitRUMConfig(new RUMConfig
{
androidAppId = "androidAppId",
iOSAppId = "iOSAppId",
sampleRate = 1.0f,
});
datakitUrl과datawayUrl중 하나만 사용하면 됩니다. 퍼블릭 DataWay를 사용하는 경우clientToken도 함께 전달하세요.
선택 사항: Log 및 Trace 초기화¶
FTUnityBridge.InitLogConfig(new LogConfig
{
enableCustomLog = true,
enableLinkRumData = true,
sampleRate = 1.0f,
});
FTUnityBridge.InitTraceConfig(new TraceConfig
{
enableNativeAutoTrace = true,
enableLinkRumData = true,
sampleRate = 1.0f,
});
선택 사항: Unity 예외 리스너 추가¶
Unity 예외를 RUM Error로 변환하려면 Application.logMessageReceived를 구독할 수 있습니다:
void OnEnable()
{
Application.logMessageReceived += LogCallBack;
}
void OnDisable()
{
Application.logMessageReceived -= LogCallBack;
}
void LogCallBack(string condition, string stackTrace, LogType type)
{
if (type == LogType.Exception)
{
FTUnityBridge.AddError(stackTrace, condition);
}
}
연동 성공 여부 확인¶
debug = true를 활성화한 상태로 앱을 실행합니다.- 페이지를 열거나 네트워크 요청을 한 번 보냅니다.
- Unity 콘솔에서 SDK 초기화 및 데이터 동기화 관련 로그가 표시되는지 확인합니다.
- Guance 콘솔로 돌아가 앱에 해당 RUM 데이터가 표시되는지 확인합니다.
추가로 문제를 해결해야 하는 경우 문제 해결을 참조하세요.
다음 단계¶
- 전체 설치 및 초기화 안내는 앱 연동에서 계속 확인하세요.
- 모든 초기화 파라미터 설명은 SDK 초기화를 참조하세요.
- RUM, Log, Trace의 상세 설정은 RUM 설정, Log 설정, Trace 설정을 참조하세요.
- 프로젝트가 네이티브와 Unity 혼합 개발 방식인 경우 네이티브와 Unity 혼합 개발을 참조하세요.
- View, Action, Resource, Error, LongTask를 수동으로 수집해야 하는 경우 RUM 수동 트래킹을 참조하세요.