Trace 設定¶
Trace の初期化設定¶
let traceConfig: FTTraceConfig = {
traceSamplingRate: 100,
enableNativeAutoTrace: true,
};
await FTReactNativeTrace.setConfig(traceConfig);
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
| traceSamplingRate | number | いいえ | サンプリング率(%)。範囲は [0,100] で、小数をサポートします。デフォルトは 100 です。sampleRate より優先され、明示的に 0 に設定した場合も同様です。SDK 0.4.3 以降でサポート。 |
| sampleRate | number | いいえ | SDK 0.4.3 以降では非推奨、互換性のために保持。範囲は [0,1] で、デフォルトは 1 です。traceSamplingRate が設定されていない場合にのみ有効です。traceSamplingRate の使用を推奨します |
| traceType | enum TraceType | いいえ | トレースタイプ。デフォルトは TraceType.ddTrace です。TraceType.ddTrace、TraceType.zipkinMulti、TraceType.zipkinSingle、TraceType.traceparent、TraceType.skywalking、TraceType.jaeger をサポートします |
| enableLinkRUMData | boolean | いいえ | RUM データに関連付けるかどうか。デフォルトは false です |
| enableNativeAutoTrace | boolean | いいえ | ネイティブネットワークの自動トレース(iOS NSURLSession、Android OKhttp)を有効にするかどうか。React Native のネットワークリクエストは iOS、Android 側でシステム API を使用して実装されているため、有効にすると React Native の HTTP(S) リクエストもまとめてトレースできます。iOS の WebSocket では、さらに FTRUMConfig.enableIOSWebSocketResource を有効にする必要があります。詳細は WebSocket ハンドシェイクの収集 を参照してください |
SDK 0.4.3 以降、小数のパーセントサンプリングをサポートしています。traceSamplingRate: 12.5 は 12.5%、1 は 1%、100 は全量収集を表します。移行ルールについては サンプリング設定 を参照してください。
Tracer によるネットワークトレース¶
SDK の初期化時に Trace 設定 で自動ネットワークトレースを有効にできます。また、ユーザーによるカスタム収集もサポートしています。
使用方法¶
/**
* trace HTTP リクエストヘッダーデータを取得します。
* @deprecated use getTraceHeaderFields() replace.
*/
getTraceHeader(key: String, url: String): Promise<object>;
/**
* trace HTTP リクエストヘッダーデータを取得します。
*/
getTraceHeaderFields(url: String, key?: String): Promise<object>;
使用例¶
import { FTReactNativeTrace } from '@cloudcare/react-native-mobile';
async function getHttp(url: string) {
const key = Utils.getUUID();
const traceHeader = await FTReactNativeTrace.getTraceHeaderFields(url);
const fetchOptions = {
method: 'GET',
headers: Object.assign(
{
Accept: 'application/json',
'Content-Type': 'application/json',
},
traceHeader,
),
};
fetch(url, fetchOptions);
}