빠른 시작¶

이 문서는 Unity RUM SDK를 가장 짧은 경로로 연동하는 방법을 설명하여, 최소한의 단계로 데이터 업로드가 실제로 이루어지는지 검증할 수 있도록 돕습니다.

사전 준비¶

시작 전에 다음 준비를 완료하세요.

실제 사용자 모니터링(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 수동 계측을 참조하세요.