コンテンツにスキップ

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

フィードバック

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