콘텐츠로 이동

빠른 시작

이 문서는 C++ RUM SDK의 최소 접근 경로를 제공하여, 최소한의 단계로 데이터 업로드를 확인할 수 있도록 돕습니다.

C++ SDK는 현재 자동 캡처 기능을 제공하지 않으므로, 초기화 완료 후 SDK 인터페이스를 수동으로 호출하여 View, Action, Resource, Error 또는 LongTask 데이터를 업로드해야 합니다.

사전 준비

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

  1. 실제 사용자 모니터링(RUM)에서 C++ 애플리케이션을 생성하고 RUM App ID를 획득합니다.
  2. DataKit이 설치되어 있고 RUM 수집기 구성이 완료되었는지 확인합니다.
  3. 현재 장치에서 setServerUrl에 구성된 DataKit 주소에 접근 가능한지 확인합니다.
  4. SDK 설치를 완료합니다. 자세한 방법은 애플리케이션 연동을 참조하세요.

연동 단계

  1. 프로젝트에 datakit-sdk-cpp를 설치합니다.
  2. FTSDKFactory.h를 참조합니다.
  3. FTSDKConfig를 초기화합니다.
  4. FTRUMConfig를 초기화합니다.
  5. SDK 인터페이스를 수동으로 호출하여 View, Action, Resource, Error 또는 LongTask 업로드를 트리거합니다.
  6. 콘솔에서 데이터가 성공적으로 연동되었는지 확인합니다.

최소 초기화 예제

#include "datakit-sdk-cpp/FTSDKFactory.h"


//...
auto sdk = FTSDKFactory::get();
sdk->init();

FTSDKConfig sdkConfig;
sdkConfig.setServerUrl("http://10.0.0.1:9529")
            .setEnableFileDBCache(true);
sdk->install(sdkConfig);

FTRUMConfig rumConfig;
rumConfig.setRumAppId("appid_xxxx");
sdk->initRUMWithConfig(rumConfig);

초기화 후 수동 SDK 호출

초기화가 완료되면 SDK는 페이지 전환, 클릭 동작 또는 네트워크 요청을 자동으로 수집하지 않습니다. 비즈니스 코드에서 수집 인터페이스를 직접 호출해야 합니다.

예시:

sdk->startView("main_view");
sdk->startAction("launch", "click");
sdk->stopAction();
sdk->stopView();

Resource, Error, LongTask 등의 데이터를 수동으로 수집하려면 사용자 정의 수집 규칙을 참조하세요.

선택 사항: Log 및 Trace 초기화

로그 수집 또는 분산 추적이 추가로 필요한 경우, 다음 초기화를 추가할 수 있습니다.

FTLogConfig logConfig;
logConfig.setEnableCustomLog(true)
         .setEnableLinkRumData(true);
sdk->initLogWithConfig(logConfig);

FTTraceConfig traceConfig;
traceConfig.setTraceType(TraceType::DDTRACE)
           .setEnableLinkRUMData(true);
sdk->initTraceWithConfig(traceConfig);

연동 성공 확인

  1. ft_sdk_config.json에서 enable_sdk_log를 활성화합니다.
  2. 프로그램을 실행하고 비즈니스 코드에서 View, Action, Resource, Error, LongTask 또는 Log 인터페이스를 수동으로 한 번 호출합니다.
  3. 장치에서 DataKit까지 네트워크 연결이 가능한지 확인합니다.
  4. 콘솔로 돌아가 해당 RUM 또는 로그 데이터가 나타나는지 확인합니다.

추가 문제 해결이 필요하면 문제 해결을 참조하세요.

다음 단계

문서 평가

이 페이지가 도움이 되었나요?