クイックスタート¶
本記事では、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 の収集を有効にします- デバッグログを有効にし、アプリケーションを実行して、ページを 1 回開くかネットワークリクエストを 1 回発生させます
- コンソールに戻り、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)を有効にしたままにします- ページを開くか、ネットワークリクエストを 1 回発行します
hilogで[FT-SDK]を検索し、SDK の初期化とデータ送信の流れが正常であることを確認します- Guance コンソールに戻り、対応する RUM データが表示されることを確認します
ネットワークリクエストを検証する場合、Resource 自動追跡に従って、対応する RCP、Axios または NetworkKit インターセプターを組み込む必要があります。setEnableTraceUserResource(true) を有効にするだけでは、すべての業務リクエストは追跡されません。
次のステップ¶
- 完全な接続説明:アプリケーション接続を参照
- 旧 HAR のマイグレーション説明:旧設定のマイグレーションを参照
- SDK 初期化パラメーター:SDK 初期化を参照
- RUM の詳細設定と手動収集:RUM 設定を参照
- Log と Trace:Log 設定、Trace 設定を参照
- WebView シナリオ:WebView データモニタリングを参照
- セッションリプレイ:HarmonyOS セッションリプレイ(実験的)を参照