빠른 시작¶
이 문서는 HarmonyOS RUM SDK의 최단 연동 경로를 제공하여, 검증 가능한 데이터 보고를 빠르게 완료할 수 있도록 합니다.
앱은 Agent 자동 연동 및 수동 연동을 지원합니다. 다음 단계에서는 수동 연동의 최소 구성을 설명합니다.
사전 준비¶
- 실제 사용자 모니터링(RUM)에서 HarmonyOS 앱을 생성하고
RUM App ID를 가져옵니다. - 보고 방식을 확인합니다:
- 로컬 환경 배포:
datakitUrl을 준비합니다 - 공용 네트워크 DataWay:
datawayUrl및clientToken을 준비합니다
- 로컬 환경 배포:
- 설치 방식을 선택합니다:
- 타사 저장소가 구성된 경우:
ohpm을 통해@guancecloud/ft_sdk를 직접 설치합니다 - 로컬 HAR 사용:
ft_sdk.har를 다운로드하고oh-package.json5에서@guancecloud/ft_sdk를 의존성 이름으로 사용합니다
- 타사 저장소가 구성된 경우:
@kit.NetworkKit기반 HTTP 인터셉터 체인 기능을 사용하려면@guancecloud/ft_sdk_ext를 추가로 설치하거나ft_sdk_ext.har를 다운로드합니다. 이 기능은 HarmonyOS API 22 이상이 필요합니다.- Native Crash를 수집하려면
@guancecloud/ft_native를 추가로 설치하거나ft_native.har를 다운로드합니다. - 바이트코드 HAR을 사용하는 경우 프로젝트는 HarmonyOS API 12 이상을 사용해야 하며, 루트 디렉터리의
build-profile.json5에서useNormalizedOHMUrl을 활성화해야 합니다. 전체 구성 및 난독화 설명은 바이트코드 HAR 빌드 구성을 참조하십시오.
연동 단계¶
- 타사 저장소를 사용하는 경우
ohpm install @guancecloud/ft_sdk를 실행합니다. - 로컬 HAR을 사용하는 경우 HAR 파일을 프로젝트의
libs디렉터리에 배치하고oh-package.json5에서 scoped 의존성을 선언합니다.ft_sdk_ext.har도 함께 사용하는 경우 프로젝트 루트 디렉터리의oh-package.json5에서overrides를 통해@guancecloud/ft_sdk를 로컬 HAR로 재정의한 후ohpm install을 실행해야 합니다. - 앱 시작 시
FTSDKConfig를 초기화합니다. FTRUMConfig를 초기화하고 View, Action, Resource, ANR 및 Crash 수집을 활성화합니다.- 디버그 로그를 활성화하고 앱을 실행한 후 페이지 열기 또는 네트워크 요청을 한 번 트리거합니다.
- 콘솔로 돌아가 RUM 데이터가 성공적으로 보고되었는지 확인합니다.
최소 의존성 방식¶
- ohpm을 통해 핵심 SDK를 설치합니다:
- 로컬 HAR을 사용하는 경우
oh-package.json5에 최소 의존성을 추가합니다:
최소 의존성으로 먼저 연동하여 기본 데이터 보고가 정상 동작하는 것을 확인한 후, 필요에 따라 확장 패키지를 추가하는 것을 권장합니다.
최소 초기화 예시¶
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { FTSDK, FTSDKConfig, FTRUMConfig, EnvType, SDKLogLevel } from '@guancecloud/ft_sdk/Index';
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
// 로컬 환경 배포 시 FTSDKConfig.builder(datakitUrl)로 변경할 수 있습니다
const sdkConfig = FTSDKConfig.builder(datawayUrl, clientToken)
.setDebug(true)
.setSdkLogLevel(SDKLogLevel.D)
.setServiceName('Your-App-Name')
.setEnv(EnvType.PROD);
FTSDK.install(sdkConfig, this.context);
const rumConfig = new FTRUMConfig()
.setRumAppId('your-app-id')
.setSessionSamplingRate(100)
.setEnableTraceUserAction(true)
.setEnableTraceUserView(true)
.setEnableTraceUserResource(true)
.setEnableTrackAppANR(true)
.setEnableTrackAppCrash(true);
FTSDK.installRUMConfig(rumConfig);
}
}
연동 성공 여부 확인¶
setDebug(true)를 활성화한 상태로 유지합니다.- 페이지를 열거나 네트워크 요청을 한 번 발생시킵니다.
hilog에서[FT-SDK]를 검색하여 SDK 초기화 및 데이터 보고 흐름이 정상인지 확인합니다.- Guance 콘솔로 돌아가 해당 RUM 데이터가 나타나는지 확인합니다.
네트워크 요청을 검증할 때는 Resource 자동 추적에 따라 해당 RCP, Axios 또는 NetworkKit 인터셉터를 마운트해야 합니다. setEnableTraceUserResource(true)만 활성화해서는 모든 비즈니스 요청을 추적할 수 없습니다.
다음 단계¶
- 전체 연동 설명: 앱 연동을 참조하십시오.
- 기존 HAR 마이그레이션 설명: 기존 구성 마이그레이션을 참조하십시오.
- SDK 초기화 매개변수: SDK 초기화를 참조하십시오.
- RUM 상세 구성 및 수동 수집: RUM 구성을 참조하십시오.
- Log 및 Trace: Log 구성, Trace 구성을 참조하십시오.
- WebView 시나리오: WebView 데이터 모니터링을 참조하십시오.
- 세션 리플레이: HarmonyOS 세션 리플레이(실험적)를 참조하십시오.