クイックスタート¶
本ガイドは、C++ RUM SDK の最短の導入パスを提供し、最小限の手順で検証可能なデータ送信を実現します。
C++ SDK は現時点では自動取得機能を提供していないため、初期化後は SDK のインターフェースを手動で呼び出して View、Action、Resource、Error、または LongTask のデータを送信する必要があります。
事前準備¶
開始する前に、以下の準備を完了してください。
- リアルユーザーモニタリング(RUM) で C++ アプリケーションを作成し、
RUM App IDを取得します。 - DataKit がインストールされ、RUM コレクター の設定が完了していることを確認します。
- 現在のデバイスから
setServerUrlで設定した DataKit のアドレスにアクセスできることを確認します。 - SDK のインストールを完了します。詳細は アプリ接続 を参照してください。
導入手順¶
- プロジェクトに
datakit-sdk-cppをインストールします。 FTSDKFactory.hをインクルードします。FTSDKConfigを初期化します。FTRUMConfigを初期化します。- SDK のインターフェースを手動で呼び出し、
View、Action、Resource、Error、またはLongTaskの送信をトリガーします。 - コンソールでデータが正常に取り込まれたことを確認します。
最小初期化例¶
#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);
接続の確認¶
ft_sdk_config.jsonでenable_sdk_logを有効にします。- プログラムを実行し、業務コード内で
View、Action、Resource、Error、LongTask、またはLogのインターフェースを手動で一度呼び出します。 - デバイスから DataKit へのネットワーク到達性を確認します。
- コンソールに戻り、対応する RUM またはログデータが表示されていることを確認します。
さらに詳細な確認が必要な場合は、トラブルシューティング を参照してください。