クイックスタート¶
この記事では、C++ RUM SDK の最短の導入手順を示し、最小限のステップで検証可能なデータ送信を 1 回完了できるようにします。
C++ SDK は現在、自動キャプチャ機能を提供していないため、初期化後は SDK インターフェースを手動で呼び出して View、Action、Resource、Error、LongTask のデータを送信する必要があります。
アプリケーションは Agent による自動導入と手動導入をサポートしています。以下の手順では、手動導入の最小構成について説明します。
前提条件¶
開始前に、次の準備を完了してください。
- RUM で C++ アプリケーションを作成し、
RUM App IDを取得します - DataKit がインストール済みで、RUM コレクター の設定が完了していることを確認します
- 現在のデバイスから
setServerUrlに設定した DataKit アドレスにアクセスできることを確認します - SDK のインストールを完了します。具体的な方法はアプリケーションの導入を参照してください。
導入手順¶
- プロジェクトに
datakit-sdk-cppをインストールします FTSDKFactory.hをインクルードしますFTSDKConfigを初期化しますFTRUMConfigを初期化します- SDK インターフェースを手動で呼び出して、
View、Action、Resource、Error、またはLongTaskの送信を 1 回トリガーします - コンソールでデータが正常に取り込まれたことを確認します
最小限の初期化例¶
#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 データまたはログデータが表示されていることを確認します
さらにトラブルシューティングが必要な場合は、トラブルシューティングを参照してください。