콘텐츠로 이동

C++ 애플리케이션 연동


C++ 애플리케이션의 메트릭 데이터를 수집하여 애플리케이션 성능을 시각화해 분석합니다. 현재 C++ SDK는 Windows 및 Linux 플랫폼을 지원합니다.

읽기 경로

사전 조건

주의

이미 RUM Headless 서비스를 활성화한 경우 사전 조건이 자동으로 구성되어 있으므로 애플리케이션을 바로 연동할 수 있습니다.

로컬 환경에 배포하는 경우 다음 데이터 수신 측 구성을 완료해야 합니다. 공용 네트워크 DataWay를 사용하는 경우 DataKit을 직접 배포할 필요가 없습니다.

애플리케이션 연동

Guance 콘솔에 로그인하고 실제 사용자 모니터링(RUM) 페이지로 이동한 뒤 왼쪽 상단의 새 애플리케이션 생성 을 클릭하면 새 애플리케이션을 생성할 수 있습니다.

생성이 완료되면 해당 애플리케이션의 RUM App ID를 기록해 두세요. 이후 FTRUMConfig를 초기화할 때 필요합니다.

연동 방식 선택

애플리케이션 설정 페이지에서 「Agent 자동 연동」 또는 「수동 연동」을 선택한 다음 「연동 설정」을 완료합니다. 이미 애플리케이션이 있는 경우 설정 페이지로 바로 이동하여 연동을 계속할 수 있습니다.

연동 방식 사용 사례 작업 경로
Agent 자동 연동 코딩 어시스턴트가 프로젝트를 분석하고 SDK 연동을 완료하도록 하려는 경우 콘솔에서 생성된 프롬프트를 복사하여 애플리케이션 코드 저장소에서 코딩 어시스턴트에게 전달해 실행
수동 연동 SDK를 직접 설치하고 파라미터를 구성하려는 경우 데이터 보고 방식을 확인한 후 이 문서와 빠른 시작에 따라 구성을 완료

Agent 자동 연동

  1. 현재 애플리케이션의 설정 페이지에서 「Agent 자동 연동」을 선택합니다.
  2. 「연동 설정」의 전체 프롬프트를 복사하고, 현재 애플리케이션의 연동 정보가 사용되는지 확인합니다.
  3. 애플리케이션 코드 저장소에서 코딩 어시스턴트를 열고 프롬프트를 붙여넣으면 Agent가 연동 가이드에 따라 프로젝트를 분석하고 SDK 구성을 완료합니다.
  4. 애플리케이션을 빌드하고 실행하여 페이지 방문 등의 작업을 트리거한 뒤, 현재 애플리케이션의 탐색기에서 데이터 수신을 확인합니다.

페이지에 개인 API Key 또는 임시 인증 코드가 준비되지 않았다는 메시지가 표시되면 안내에 따라 보완한 후 프롬프트를 다시 복사하세요.

수동 연동

애플리케이션 설정 페이지에서 「수동 연동」을 선택하고 데이터 보고 방식을 확인합니다.

  • 공용 네트워크 DataWay: 현재 애플리케이션의 연동 설정에서 보고 주소와 Client Token을 가져오며, DataKit을 직접 배포할 필요가 없습니다.
  • 로컬 환경 배포: 이미 배포된 DataKit을 사용하여 데이터를 수신하고, 애플리케이션이 해당 보고 주소에 액세스할 수 있는지 확인합니다.

아래 설치 및 빠른 시작에 따라 SDK 설치, 초기화 및 검증을 완료합니다. 이미 SDK 구성이 있는 경우 먼저 확인 후 재사용하여 중복 초기화를 피해야 합니다.

설치

소스 코드 주소: https://github.com/GuanceCloud/datakit-cpp

Demo 주소: https://github.com/GuanceCloud/datakit-cpp/ft-sdk-sample

git clone https://github.com/microsoft/vcpkg
cd vcpkg

# 사용자 정의 registries 구성 파일 다운로드
curl -o vcpkg-configuration.json https://static.guance.com/ft-sdk-package/vcpkg_config/vcpkg-configuration.json 

bootstrap-vcpkg.bat
vcpkg install datakit-sdk-cpp:x64-windows
vcpkg integrate install
git clone https://github.com/microsoft/vcpkg

#apt install ninja-build
#apt install pkg-config

./vcpkg/bootstrap-vcpkg.sh
cd vcpkg

# 사용자 정의 registries 구성 파일 다운로드
curl -o vcpkg-configuration.json https://static.guance.com/ft-sdk-package/vcpkg_config/vcpkg-configuration.json 

# ARM 64인 경우 VCPKG_FORCE_SYSTEM_BINARIES를 추가해야 합니다
#export VCPKG_FORCE_SYSTEM_BINARIES=1

./vcpkg install datakit-sdk-cpp:x64-linux

# 빌드 환경에서 VCPKG_ROOT 변수를 참조합니다
export VCPKG_ROOT= [ your_vcpkg_root_dir ]

CMake 구성 추가

cmake_minimum_required(VERSION 3.0)

project(ft-sdk-reference-sample VERSION 1.0.0 LANGUAGES CXX C)

add_definitions(-fPIC -g -Werror=return-type)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++17 -O1 -ftree-vectorize -ffast-math ")
set(CMAKE_CXX_STANDARD 17)

if(DEFINED ENV{VCPKG_ROOT})
if (EXISTS "$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")
    include ("$ENV{VCPKG_ROOT}/scripts/buildsystems/vcpkg.cmake")
  set(VCPKG_CMAKE_SHARE "$ENV{VCPKG_ROOT}/installed/${VCPKG_TARGET_TRIPLET}/share"
      CACHE STRING "TEST")
endif ()
else ()
message(STATUS "please set the system environment variable : VCPKG_ROOT" $ENV{VCPKG_ROOT})
endif ()

#Guance SDK 참조 추가
find_path(FT-SDK_INCLUDE_DIR datakit-sdk-cpp/FTSDK.h)
find_library(FT-SDK_LIBRARY ft-sdk "${FT-SDK_INCLUDE_DIR}/../lib/")
include_directories(${FT-SDK_INCLUDE_DIR})

file(GLOB PROJECT_SOURCE "*.cpp")
file(GLOB PROJECT_HEADER "../include/*.h" "*.h")

add_executable (${PROJECT_NAME} ${PROJECT_SOURCE} ${PROJECT_HEADER})

# SDK 링크
target_link_libraries(${PROJECT_NAME} PRIVATE ${FT-SDK_LIBRARY})

헤더 포함

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

초기화 설명

최소 초기화 예시는 빠른 시작을 참고하세요.

전체 초기화 및 런타임 기능 설명은 SDK 초기화를 참고하세요.

상세 설정 항목

고급 시나리오

자주 묻는 질문

필드 충돌을 방지하기 위해 변수 추가

사용자 정의 필드와 SDK 데이터의 충돌을 방지하려면 태그 이름에 프로젝트 약어 접두사를 추가하는 것이 좋습니다. 예: custom_tag_name. 프로젝트에서 사용하는 예약 key는 소스 코드에서 확인할 수 있습니다.

SDK 전역 변수에 RUM, Log와 동일한 필드가 있으면 RUM, Log의 동일 이름 필드가 SDK의 전역 변수를 덮어씁니다.

연동 성공 여부를 빠르게 확인하는 방법

빠른 시작에 따라 최소 초기화를 완료하고 enable_sdk_log 디버그 로그를 활성화한 뒤, View, Action 또는 Log 보고를 한 번 수동으로 트리거하고 콘솔에서 데이터가 표시되는지 확인하세요.

초기화 후 데이터가 없으면 어떻게 해야 하나요

다음 항목을 우선 확인하세요:

  • setServerUrl에 구성한 DataKit 주소에 현재 기기에서 액세스할 수 있는지
  • setRumAppId가 올바르게 입력되었는지
  • 사전 조건의 DataKit 및 RUM 수집기 구성을 완료했는지
  • 현재 플랫폼이 C++ SDK에서 지원하는 Windows 또는 Linux인지

그래도 문제를 파악할 수 없으면 문제 해결을 확인하세요.

문서 평가

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