콘텐츠로 이동

SDK 초기화

이 문서는 C++ SDK 초기화, 기본 설정 및 런타임 기능에 대한 내용을 다룹니다.

헤더 파일 참조

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

SDK 초기화

auto sdk = FTSDKFactory::get();
sdk->init();
필드 타입 필수 설명
FTSDKFactory::get string 아니요 설정 파일 지정, 기본값은 ft_sdk_config.json

JSON 파일을 통한 시작 설정

FTSDKFactory를 사용하여 JSON 파일로 SDK 디버그 로그를 활성화할 수 있습니다.

{
  "general_config": {
    "enable_sdk_log": true
  }
}

enable_sdk_log는 디버그 로그를 활성화하며, 기본값은 비활성화(false)입니다.

기본 설정

FTSDKConfig gc;
gc.setServerUrl("http://10.0.0.1:9529")
  .setEnv(EnvType::PROD)
  .addGlobalContext("custom_key", "custom_value")
  .setEnableFileDBCache(true);
sdk->install(gc);
필드 타입 필수 설명
setServerUrl string 예 DataKit 접속 URL 주소, 예: http://10.0.0.1:9529, 포트 기본값은 9529입니다. SDK를 설치한 장치에서 해당 주소에 접근 가능해야 합니다
setEnv enum 아니요 환경 설정, 기본값은 EnvType::PROD
setAppVersion string 아니요 Windows에서는 기본적으로 가져오며, Linux에서는 직접 할당해야 합니다
setEnableFileDBCache bool 아니요 로컬 데이터베이스 캐시 활성화 여부, 기본값은 false
addGlobalContext dictionary 아니요 SDK 전역 속성 추가, 규칙은 사용자 정의 태그 및 충돌 필드 설명을 참조하세요
setServiceName string 아니요 로그 및 RUM의 service 필드 데이터에 영향을 줍니다. Windows 기본값은 df_rum_windows, Linux 기본값은 df_rum_linux

사용자 정보 바인딩 및 해제

/**
 * 사용자 데이터 바인딩
 *
 * @param config 사용자 데이터
 */
FTSDK&& bindUserData(UserData& config);

/**
 * 사용자 데이터 해제
 */
void unbindUserData();

예시:

UserData uc;
uc.init("username", "1001", "someone@email.com");
uc.addCustomizeItem("ft_key", "ft_value");
sdk->bindUserData(uc);

sdk->unbindUserData();

addCustomizeItem의 필드 이름 지정 시에도 충돌 필드 설명을 따르는 것이 좋습니다.

런타임 기능

SDK 종료

sdk->deinit();

deinit() 호출 시 리소스 정리 작업이 수행됩니다. 애플리케이션 프로세스가 계속 데이터를 수집해야 하는 경우, 초기화 및 설정을 다시 완료하세요.

문서 평가

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