コンテンツにスキップ

クイックスタート

この記事では、C++ RUM SDK の最短の導入手順を示し、最小限のステップで検証可能なデータ送信を 1 回完了できるようにします。

C++ SDK は現在、自動キャプチャ機能を提供していないため、初期化後は SDK インターフェースを手動で呼び出して View、Action、Resource、Error、LongTask のデータを送信する必要があります。

アプリケーションは Agent による自動導入と手動導入をサポートしています。以下の手順では、手動導入の最小構成について説明します。

前提条件

開始前に、次の準備を完了してください。

  1. RUM で C++ アプリケーションを作成し、RUM App ID を取得します
  2. DataKit がインストール済みで、RUM コレクター の設定が完了していることを確認します
  3. 現在のデバイスから setServerUrl に設定した DataKit アドレスにアクセスできることを確認します
  4. SDK のインストールを完了します。具体的な方法はアプリケーションの導入を参照してください。

導入手順

  1. プロジェクトに datakit-sdk-cpp をインストールします
  2. FTSDKFactory.h をインクルードします
  3. FTSDKConfig を初期化します
  4. FTRUMConfig を初期化します
  5. SDK インターフェースを手動で呼び出して、View、Action、Resource、Error、または LongTask の送信を 1 回トリガーします
  6. コンソールでデータが正常に取り込まれたことを確認します

最小限の初期化例

#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);

導入が成功したことを確認する

  1. ft_sdk_config.json で enable_sdk_log を有効にします
  2. プログラムを実行し、業務コード内で View、Action、Resource、Error、LongTask、または Log インターフェースを一度手動で呼び出します
  3. デバイスから DataKit へのネットワーク到達性を確認します
  4. コンソールに戻り、対応する RUM データまたはログデータが表示されていることを確認します

さらにトラブルシューティングが必要な場合は、トラブルシューティングを参照してください。

次のステップ

フィードバック

このページは役に立ちましたか?