クイックスタート¶
この記事では、Unity RUM SDK の最短の導入手順を示し、最小限の手順で検証可能なデータ送信を1回完了できるようにします。
アプリは Agent 自動導入と手動導入に対応しています。以下の手順では、手動導入の最小設定について説明します。
事前準備¶
開始前に、以下の準備を完了してください:
- リアルユーザーモニタリング(RUM)で Unity Android と Unity iOS のアプリをそれぞれ作成し、対応する
App IDを取得します - 送信先アドレスと認証方式を確認します:
- ローカル環境デプロイ:
datakitUrlを準備します - パブリック DataWay:
datawayUrlとclientTokenを準備します - プロジェクトに
ft-sdk-unity.unitypackageがインポートされていることを確認します - プロジェクトに
"com.unity.nuget.newtonsoft-json"がインストールされていることを確認します
導入手順¶
FTSDK.prefabを最初のシーンにドラッグします- アプリ起動時に
FTUnityBridge.Install(...)を呼び出します RUMConfigを初期化し、Android と iOS に対応するApp IDを渡します- 必要に応じて
LogConfigとTraceConfigを初期化します - アプリを実行し、ページ表示、ログ出力、またはネットワークリクエストを一度発生させます
- Unity コンソールと Guance プラットフォームで、データが正常に送信されたことを確認します
最小初期化例¶
FTUnityBridge.Install(new SDKConfig
{
// ローカル環境デプロイでは datakitUrl を使用します
datakitUrl = "http://10.0.0.1:9529",
// パブリック DataWay では datawayUrl + clientToken を使用します
// datawayUrl = "https://open.dataway.url",
// clientToken = "client-token",
env = "prod",
debug = true,
});
FTUnityBridge.InitRUMConfig(new RUMConfig
{
androidAppId = "androidAppId",
iOSAppId = "iOSAppId",
sampleRate = 1.0f,
});
datakitUrlとdatawayUrlはいずれか一方を指定すれば十分です。パブリック DataWay を使用する場合は、clientTokenも併せて渡してください。
オプション:Log と Trace の初期化¶
FTUnityBridge.InitLogConfig(new LogConfig
{
enableCustomLog = true,
enableLinkRumData = true,
sampleRate = 1.0f,
});
FTUnityBridge.InitTraceConfig(new TraceConfig
{
enableNativeAutoTrace = true,
enableLinkRumData = true,
sampleRate = 1.0f,
});
オプション:Unity 例外監視の追加¶
Unity の例外を RUM Error に変換する場合は、Application.logMessageReceived を監視できます:
void OnEnable()
{
Application.logMessageReceived += LogCallBack;
}
void OnDisable()
{
Application.logMessageReceived -= LogCallBack;
}
void LogCallBack(string condition, string stackTrace, LogType type)
{
if (type == LogType.Exception)
{
FTUnityBridge.AddError(stackTrace, condition);
}
}
導入成功の確認¶
debug = trueを有効にしたまま、アプリを実行します- ページを開くか、ネットワークリクエストを一度発行します
- Unity コンソールに SDK の初期化とデータ同期に関するログが出力されることを確認します
- Guanceコンソールに戻り、アプリに対応する RUM データが表示されていることを確認します
さらに調査が必要な場合は、トラブルシューティング を参照してください。
次のステップ¶
- インストールと初期化の詳細な説明については、アプリの導入 を引き続きお読みください
- すべての初期化パラメーターの説明については、SDK の初期化 を参照してください
- RUM、Log、Trace の詳細な設定については、RUM 設定、Log 設定、Trace 設定 を参照してください
- プロジェクトがネイティブと Unity のハイブリッド開発である場合は、ネイティブと Unity のハイブリッド開発 を参照してください
- View、Action、Resource、Error、LongTask を手動で収集する必要がある場合は、RUM の手動トラッキング を参照してください