사용자 정의 환경 변수¶
주요 필드¶
Web¶
Web SDK의 초기화 파라미터에서 remoteConfiguration: true를 설정하여 원격 구성을 활성화합니다. Browser SDK 3.3.25 이상 버전에서는 애플리케이션 코드에서 원격 응답 처리 완료, 로컬 구성 폴백, SDK 초기화 실패를 구분할 수 있습니다. 자세한 내용은 Web 애플리케이션 연동을 참조하세요.
파라미터 이름 |
데이터 유형 | 설명 |
|---|---|---|
sessionSampleRate |
number | 데이터 보고 샘플링 비율, 100은 전체 수집, 0은 수집하지 않음을 의미합니다. |
service |
string | Web 애플리케이션의 서비스 이름입니다. |
env |
string | Web 애플리케이션의 현재 환경(예: prod: 프로덕션 환경; gray: 그레이 환경; pre: 사전 출시 환경; common: 일반 환경; local: 로컬 환경). |
version |
string | Web 애플리케이션의 버전 번호입니다. |
tracingSampleRate |
number | 트레이스 데이터 샘플링 비율: 100은 전체 수집, 0은 수집하지 않음을 의미합니다. |
usePartitionedCrossSiteSessionCookie |
boolean | 교차 사이트 쿠키 사용 여부, 서드파티 쿠키의 교차 파티션 구현을 활성화합니다. 기본적으로 교차 사이트는 허용되지 않습니다. |
storeContextsToLocal |
boolean | 공용 데이터를 localstorage에 저장할지 여부, 기본적으로 저장하지 않습니다. |
storeContextsKey |
string | localstorage에 저장할 키를 정의합니다. 기본값은 비어 있으며 자동으로 생성됩니다. |
sendContentTypeByJson |
boolean | 데이터를 application/json 방식으로 전송합니다. 기본값은 text입니다. |
allowFallbackToLocalStorage |
boolean | 쿠키를 사용할 수 없는 경우 이 옵션을 활성화하여 데이터를 localstorage에 저장할 수 있습니다. |
sessionOnErrorSampleRate |
number | 오류 세션 보상 샘플링 비율: 세션이 샘플링되지 않은 경우 세션 중 오류가 발생하면 이 비율에 따라 수집합니다. 100은 오류 세션 전체 수집, 0은 오류 세션 무시를 의미합니다. |
sessionReplaySampleRate |
number | Session Replay 전체 수집 샘플링 비율: 모든 세션 리플레이의 전체 데이터 수집 비율을 제어합니다. 100은 전체 수집, 0은 수집하지 않음을 의미합니다. |
sessionReplayOnErrorSampleRate |
number | 오류 세션 리플레이 보상 샘플링 비율: 세션이 샘플링되지 않은 경우 세션 중 오류가 발생하면 이 비율에 따라 수집합니다. 100은 전체 수집, 0은 수집하지 않음을 의미합니다. |
trackUserInteractions |
boolean | 사용자 행동 수집 활성화 여부입니다. |
compressIntakeRequests |
boolean | RUM 데이터 요청 내용을 압축하여 대량 데이터 전송 시 대역폭 사용량을 줄입니다. 압축은 Worker 스레드에서 수행됩니다. |
traceType |
TraceType | 분산 추적 도구 유형을 구성합니다. 기본값은 ddtrace입니다. 현재 ddtrace, zipkin, skywalking_v3, jaeger, zipkin_single_header, w3c_traceparent 6가지 데이터 유형을 지원합니다. |
Android¶
파라미터 이름 |
데이터 유형 | 실시간 적용 가능 | 설명 |
|---|---|---|---|
env |
string |
❌ | 환경 구성, 기본값 prod, 임의의 문자, 단일 단어 사용 권장, 예: test. |
serviceName |
string |
❌ | 소속 비즈니스 또는 서비스 이름을 설정하며 Log 및 RUM의 service 필드 데이터에 영향을 줍니다. 기본값 df_rum_android. |
autoSync |
bool |
✅ | 데이터 수집 후 서버로 자동 동기화할지 여부, 기본값 true. |
compressIntakeRequests |
bool |
✅ | 업로드 동기화 데이터에 deflate 압축을 적용합니다. 기본적으로 비활성화됩니다. |
syncPageSize |
int |
✅ | 동기화 요청 항목 수를 설정합니다. 범위 [5,∞)입니다. 주의: 요청 항목 수가 클수록 데이터 동기화에 더 많은 컴퓨팅 리소스가 사용됩니다. |
syncSleepTime |
int |
✅ | 동기화 간격 시간을 설정합니다. 단위는 밀리초입니다. 범위 [0,5000], 기본적으로 설정하지 않습니다. |
sessionSamplingRate |
float |
✅ | RUM 샘플링 백분율을 설정합니다. 범위 [0,100], 기본값 100; 소수를 지원하며 예를 들어 0.1은 0.1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집을 의미합니다. ft-sdk >= 1.7.6에서 지원됩니다. |
rumSampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. RUM 샘플링 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다. Android: ft-sdk > 1.6.16 |
sessionOnErrorSamplingRate |
float |
✅ | 오류 세션 보상 샘플링 백분율, 범위 [0,100], 기본값 0, 소수 지원; 명시적 새 필드가 우선합니다. ft-sdk >= 1.7.6에서 지원됩니다. |
rumSessionOnErrorSampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 rumSampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. 적용 범위는 rumSampleRate와 동일합니다. Android: ft-sdk > 1.6.16 |
rumEnableTraceUserAction |
bool |
❌ | 사용자 작업을 자동 추적할지 여부, 현재 사용자 시작 및 클릭 작업만 지원하며 기본값은 false입니다. |
rumEnableTraceUserView |
bool |
❌ | 사용자 페이지 작업을 자동 추적할지 여부, 기본값은 false입니다. |
rumEnableTraceUserResource |
bool |
❌ | 사용자 네트워크 요청을 자동 추적할지 여부, OkHttp만 지원하며 기본값은 false입니다. |
rumEnableResourceHostIP |
bool |
❌ | 요청 대상 도메인 주소의 IP를 수집할지 여부. 적용 범위: EnableTraceUserResource가 true인 기본 수집에만 영향을 줍니다. Android: 단일 Okhttp는 동일 도메인에 대한 IP 캐시 메커니즘이 있으며, 동일한 OkhttpClient는 연결 대상 서버 IP가 변경되지 않는 한 한 번만 생성합니다. |
rumEnableTrackAppUIBlock |
bool |
❌ | UI 끊김 감지를 활성화할지 여부, 기본값은 false입니다. |
rumBlockDurationMs |
int |
❌ | UI 끊김 감지 임계값을 설정합니다. 값 범위는 [100,∞), 단위는 밀리초, 기본값은 1초입니다. |
rumEnableTrackAppCrash |
bool |
❌ | 앱 크래시 로그를 보고할지 여부, 기본값은 false입니다. |
rumEnableTrackAppANR |
bool |
❌ | ANR 감지를 활성화할지 여부, 기본값은 false입니다. |
rumEnableTraceWebView |
bool |
❌ | webview 데이터 모니터링을 활성화할지 여부, 기본값은 true입니다. |
rumAllowWebViewHost |
string json array |
❌ | 데이터 추적을 허용할 webview host 주소를 구성합니다. 기본적으로 필터링하지 않습니다. 예: ["10.0.0.1"]. |
logSamplingRate |
float |
✅ | Log 샘플링 백분율을 설정합니다. 범위 [0,100], 기본값 100; 소수를 지원하며 예를 들어 0.1은 0.1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집을 의미합니다. ft-sdk >= 1.7.6에서 지원됩니다. |
logSampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. Log 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. Android: ft-sdk > 1.6.16 |
logLevelFilters |
string json array |
✅ | 레벨 로그 필터링을 설정합니다. 기본적으로 설정하지 않습니다. 예: ["info","warn"]. |
logEnableConsoleLog |
bool |
✅ | 콘솔 로그를 보고할지 여부, Android에서만 지원됩니다. |
logEnableCustomLog |
bool |
✅ | 사용자 정의 로그를 업로드할지 여부, 기본값은 false입니다. |
traceSamplingRate |
float |
✅ | Trace 샘플링 백분율을 설정합니다. 범위 [0,100], 기본값 100; 소수를 지원하며 예를 들어 0.1은 0.1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집을 의미합니다. ft-sdk >= 1.7.6에서 지원됩니다. |
traceSampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. trace 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. Android: ft-sdk > 1.6.16 |
traceEnableAutoTrace |
bool |
❌ | 자동 http trace 활성화 여부를 설정합니다. 현재 OKhttp의 자동 추적만 지원하며 기본값은 false입니다. |
traceType |
string |
❌ | 분산 추적 유형을 설정합니다. 기본값은 DDTrace입니다. |
sessionReplaySamplingRate |
float |
✅ | Session Replay 일반 샘플링 백분율, 범위 [0,100], 기본값 100, 소수 지원; 명시적 새 필드가 우선합니다. ft-sdk >= 1.7.6에서 지원됩니다. 새 Replay 로컬 구성을 사용할 때는 ft-session-replay >= 0.1.9가 함께 필요합니다. |
sessionReplaySampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. session replay 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. |
sessionReplayOnErrorSamplingRate |
float |
✅ | Session Replay 오류 보상 샘플링 백분율, 범위 [0,100], 기본값 0, 소수 지원; 명시적 새 필드가 우선합니다. ft-sdk >= 1.7.6에서 지원됩니다. 새 Replay 로컬 구성을 사용할 때는 ft-session-replay >= 0.1.9가 함께 필요합니다. |
sessionReplayOnErrorSampleRate |
float |
✅ | ft-sdk 1.7.6부터 폐기되었으며 0~1 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. |
iOS/tvOS¶
활성화 및 가져오기 방식은 iOS 동적 구성을 참조하세요. WebView 및 Session Replay 관련 필드는 iOS에만 적용됩니다.
파라미터 이름 |
데이터 유형 | 실시간 적용 가능 | 설명 |
|---|---|---|---|
env |
string |
❌ | 환경 구성, 기본값 prod, 임의의 문자, 단일 단어 사용 권장, 예: test. |
serviceName |
string |
❌ | 소속 비즈니스 또는 서비스 이름을 설정하며 Log 및 RUM의 service 필드 데이터에 영향을 줍니다. 기본값 df_rum_ios. |
autoSync |
bool |
✅ | 데이터 수집 후 서버로 자동 동기화할지 여부, 기본값 true. |
compressIntakeRequests |
bool |
✅ | 업로드 동기화 데이터에 deflate 압축을 적용합니다. 기본적으로 비활성화됩니다. |
syncPageSize |
int |
✅ | 동기화 요청 항목 수를 설정합니다. 범위 [5,∞)입니다. 주의: 요청 항목 수가 클수록 데이터 동기화에 더 많은 컴퓨팅 리소스가 사용됩니다. |
syncSleepTime |
int |
✅ | 동기화 간격 시간을 설정합니다. 단위는 밀리초입니다. 범위 [0,5000], 기본적으로 설정하지 않습니다. |
sessionSamplingRate |
float |
✅ | RUM 세션 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 100입니다. 기존 원격 필드 rumSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
rumSampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. RUM 샘플링 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다. iOS SDK > 1.5.19 |
sessionOnErrorSamplingRate |
float |
✅ | RUM 오류 세션 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 0입니다. 기존 원격 필드 rumSessionOnErrorSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
rumSessionOnErrorSampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 rumSampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. 적용 범위는 rumSampleRate와 동일합니다. iOS SDK > 1.5.19 |
rumEnableTraceUserAction |
bool |
❌ | 사용자 Action 작업을 추적할지 여부, 기본값은 false입니다. |
rumEnableTraceUserView |
bool |
❌ | 사용자 View 작업을 추적할지 여부, 기본값은 false입니다. |
rumEnableTraceUserResource |
bool |
❌ | 사용자 네트워크 요청을 추적할지 여부, 기본값은 false입니다. |
rumEnableTraceURLConnectionResource |
bool |
✅ | SDK 1.6.8+: NSURLConnection Resource 자동 수집을 제어합니다. 기본값 false이며 URLSession을 제어하는 rumEnableTraceUserResource와 독립적입니다. 변경 사항은 이후 요청에 영향을 줍니다. |
rumEnableResourceHostIP |
bool |
❌ | 요청 대상 도메인 주소의 IP를 수집할지 여부, >= iOS 13.0, >= tvOS 13.0에서 지원됩니다. |
rumEnableTrackAppUIBlock |
bool |
❌ | UI 끊김 감지를 활성화할지 여부, 기본값은 false입니다. |
rumBlockDurationMs |
int |
❌ | UI 끊김 감지 임계값을 설정합니다. 값 범위는 [100,∞), 단위는 밀리초, 기본값은 250ms입니다. |
rumEnableTrackAppCrash |
bool |
❌ | 크래시 로그를 수집할지 여부, 기본값은 false입니다. |
rumEnableTrackAppANR |
bool |
❌ | ANR 감지를 활성화할지 여부, 기본값은 false입니다. |
rumEnableTraceWebView |
bool |
❌ | webview 데이터 모니터링을 활성화할지 여부, 기본값은 true입니다. |
rumAllowWebViewHost |
string json array |
❌ | WebView host 허용 목록을 구성합니다. 기본적으로 필터링하지 않습니다. 원본 구성은 JSON 배열 문자열(예: ["example.com"])이며, 콜백 모델 속성은 배열(NSArray / [String])이므로 다시 인코딩할 필요가 없습니다. SDK 1.6.8+에서는 공유 RUM, Log 및 Native Visitor ID Bridge에 적용됩니다. []는 모두 금지하며, 원격 구성이 로컬 구성보다 우선합니다. 허용 목록 설명을 참조하세요. |
logSamplingRate |
float |
✅ | Log 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 100입니다. 기존 원격 필드 logSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
logSampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. Log 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. iOS SDK > 1.5.19 |
logLevelFilters |
string json array |
✅ | 레벨 로그 필터링을 설정합니다. 기본적으로 설정하지 않습니다. 예: ["info","warn"]. |
logEnableCustomLog |
bool |
✅ | 사용자 정의 로그를 업로드할지 여부, 기본값은 false입니다. |
logEnableWebViewLog |
bool |
✅ | SDK 1.6.8+: Native가 WebView Browser Logs SDK 로그를 수신하도록 제어합니다. 기본값 false입니다. Native 사용자 정의 로그 스위치와 독립적이며, 페이지는 여전히 Web 로그 SDK를 연동해야 합니다. |
traceSamplingRate |
float |
✅ | Trace 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 100입니다. 기존 원격 필드 traceSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
traceSampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. trace 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. iOS SDK > 1.5.19 |
traceEnableAutoTrace |
bool |
❌ | 자동 http trace 활성화 여부를 설정합니다. 현재 NSURLSession만 지원하며 기본값은 false입니다. |
traceEnableAutoTraceURLConnection |
bool |
✅ | SDK 1.6.8+: NSURLConnection Trace 자동 주입을 제어합니다. 기본값 false이며 URLSession을 제어하는 traceEnableAutoTrace와 독립적입니다. 변경 사항은 이후 요청에 영향을 줍니다. |
traceType |
string |
❌ | 분산 추적 유형을 설정합니다. 기본값은 DDTrace입니다. |
sessionReplaySamplingRate |
float |
✅ | Session Replay 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 100입니다. 기존 원격 필드 sessionReplaySampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
sessionReplaySampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. session replay 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. sessionReplaySamplingRate 사용을 권장합니다. |
sessionReplayOnErrorSamplingRate |
float |
✅ | Session Replay 오류 세션 샘플링 비율(백분율), 범위 [0,100], 소수 지원, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 수집하지 않음, 100은 전체 수집, 기본값 0입니다. 기존 원격 필드 sessionReplayOnErrorSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. 유효하지 않은 값은 기존 구성을 덮어쓰지 않습니다. SDK 1.6.8부터 지원됩니다. |
sessionReplayOnErrorSampleRate |
float |
✅ | SDK 1.6.8부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. sessionReplayOnErrorSamplingRate 사용을 권장합니다. |
HarmonyOS¶
파라미터 이름 |
데이터 유형 | 실시간 적용 가능 | 설명 |
|---|---|---|---|
env |
string |
❌ | 환경 구성, 기본값 prod. 새 값은 다음 SDK 초기화 시 캐시에서 병합됩니다. |
serviceName |
string |
❌ | Log, RUM, Trace의 service 필드를 설정합니다. 기본값 df_rum_harmonyos; 새 값은 다음 SDK 초기화 시 적용됩니다. |
autoSync |
bool |
✅ | 데이터 수집 후 서버로 자동 동기화할지 여부, 기본값 true. 비활성화하면 FTSDK.flushSyncData()를 통해 수동으로 업로드할 수 있습니다. |
compressIntakeRequests |
bool |
✅ | 이후 업로드 요청에 zlib로 래핑된 deflate 압축을 사용할지 여부, 기본값 true; 압축을 사용할 수 없으면 일반 텍스트 업로드로 폴백합니다. |
syncPageSize |
int |
✅ | 이후 단일 동기화 항목 수를 설정합니다. 소수는 내림 처리되며, 동적 업데이트 시 [1,500]로 제한됩니다. |
syncSleepTime |
int |
✅ | 연속 동기화 요청 간격을 설정합니다. 단위는 밀리초, 범위 [0,5000], 기본값 0. |
rumSampleRate |
float |
✅ | RUM 샘플링 비율을 설정합니다. 값 범위 [0,1], 0은 수집하지 않음, 1은 전체 수집, 기본값 1. 동일한 session_id의 View, Action, LongTask, Error 데이터에 적용됩니다. |
rumSessionOnErrorSampleRate |
float |
✅ | 오류 세션 보상 샘플링 비율을 설정합니다. 값 범위 [0,1], 기본값 0. 세션이 rumSampleRate로 수집되지 않았고 오류가 발생한 경우 해당 비율에 따라 오류 발생 전 1분 범위의 데이터를 보상 수집합니다. |
rumEnableTraceUserAction |
bool |
❌ | 자동 Action 수집 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableTraceUserView |
bool |
❌ | 자동 View 수집 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableTraceUserResource |
bool |
❌ | 자동 Resource 수집 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableResourceHostIP |
bool |
❌ | 요청 대상 도메인의 IP를 수집할지 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableTrackAppUIBlock |
bool |
❌ | UI 끊김 감지 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumBlockDurationMs |
int |
❌ | UI 끊김 임계값, 단위 밀리초, 최소 100, 기본값 1000; rumEnableTrackAppUIBlock과 함께 구성해야 다음 초기화 시 적용됩니다. |
rumEnableTrackAppCrash |
bool |
❌ | 앱 크래시 모니터링 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableTrackAppANR |
bool |
❌ | ANR 모니터링 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumEnableTraceWebView |
bool |
❌ | WebView 데이터 모니터링 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
rumAllowWebViewHost |
string json array |
❌ | 수집을 허용할 WebView Host를 구성합니다. 기본적으로 필터링하지 않습니다. 예: ["10.0.0.1"]; 새 값은 다음 SDK 초기화 시 적용됩니다. |
logSampleRate |
float |
✅ | Log 샘플링 비율을 설정합니다. 값 범위 [0,1], 기본값 1. |
logLevelFilters |
string json array |
✅ | 로그 레벨 필터링을 설정합니다. 기본적으로 설정하지 않습니다. 예: ["info","warn"]. |
logEnableCustomLog |
bool |
✅ | 사용자 정의 로그 업로드 여부, 기본값 false. |
logEnableConsoleLog |
bool |
✅ | console.*, hilog.* 자동 로그 수집 활성화 여부; 해당 HarmonyOS 컴파일 플러그인을 함께 연동하고 활성화해야 합니다. ft_sdk 0.1.17 이상 버전에서 지원됩니다. |
traceSampleRate |
float |
✅ | Trace 샘플링 비율을 설정합니다. 값 범위 [0,1], 기본값 1. |
traceEnableAutoTrace |
bool |
❌ | 자동 HTTP Trace 활성화 여부, 기본값 false; 새 값은 다음 SDK 초기화 시 적용됩니다. |
traceType |
string |
❌ | Trace 유형을 설정합니다. 기본값 ddtrace. ddtrace, zipkin_multi_header, zipkin_single_header, traceparent, skywalking, jaeger 지원; 새 값은 다음 SDK 초기화 시 적용됩니다. |
sessionReplaySampleRate |
float |
❌ | session replay 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집하지 않음, 1은 전체 수집, 기본값 1. |
sessionReplayOnErrorSampleRate |
float |
❌ | 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집하지 않음, 1은 전체 수집, 기본값 0. |
React Native¶
SDK 0.4.3부터 소수 백분율 샘플링 필드를 지원하며, 기존 확률 샘플링 필드는 폐기되었지만 호환성을 위해 유지됩니다.
활성화 및 가져오기 방식은 React Native 동적 구성을 참조하세요.
파라미터 이름 |
데이터 유형 | 실시간 적용 가능 | 설명 |
|---|---|---|---|
env |
string |
❌ | 환경 구성, 기본값 prod, 임의의 문자, 단일 단어 사용 권장, 예: test. |
serviceName |
string |
❌ | 소속 비즈니스 또는 서비스 이름을 설정하며 Log 및 RUM의 service 필드 데이터에 영향을 줍니다. 기본값: df_rum_ios, df_rum_android. |
autoSync |
bool |
✅ | 데이터 수집 후 서버로 자동 동기화할지 여부, 기본값 true. |
compressIntakeRequests |
bool |
✅ | 업로드 동기화 데이터에 deflate 압축을 적용합니다. 기본적으로 비활성화됩니다. |
syncPageSize |
int |
✅ | 동기화 요청 항목 수를 설정합니다. 범위 [5,∞)입니다. 주의: 요청 항목 수가 클수록 데이터 동기화에 더 많은 컴퓨팅 리소스가 사용됩니다. |
syncSleepTime |
int |
✅ | 동기화 간격 시간을 설정합니다. 단위는 밀리초입니다. 범위 [0,5000], 기본적으로 설정하지 않습니다. |
sessionSamplingRate |
float |
✅ | RUM 세션 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 100. 동일한 Session 아래의 RUM 데이터에 적용됩니다. 기존 필드 rumSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
rumSampleRate |
float |
✅ | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. RUM 샘플링 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다. sessionSamplingRate 사용을 권장합니다. |
sessionOnErrorSamplingRate |
float |
✅ | RUM 오류 세션 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 0. 일반 세션 샘플링에 선택되지 않은 세션에 사용됩니다. 오류 발생 시 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 기존 필드 rumSessionOnErrorSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
rumSessionOnErrorSampleRate |
float |
✅ | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 rumSampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. 적용 범위는 rumSampleRate와 동일합니다. sessionOnErrorSamplingRate 사용을 권장합니다. |
rumEnableTraceUserAction |
bool |
❌ | Native Action 추적 여부, 기본값 false. |
rumEnableTraceUserView |
bool |
❌ | Native View 자동 추적 여부, 기본값 false. |
rumEnableTraceUserResource |
bool |
❌ | Native Resource 자동 추적 활성화 여부, 기본값 false. |
rumEnableResourceHostIP |
bool |
❌ | 요청 대상 도메인 주소의 IP를 수집할지 여부. 적용 범위: enableNativeUserResource가 true인 기본 수집에만 영향을 줍니다. iOS: >= iOS 13에서 지원됩니다. Android: 동일한 OkhttpClient에 IP 캐시 메커니즘이 있습니다. |
rumEnableTrackAppUIBlock |
bool |
❌ | Native Freeze를 수집할지 여부, 기본값 false. |
rumBlockDurationMs |
int |
❌ | Native Freeze 끊김 임계값을 설정합니다. 값 범위 [100,∞), 단위 밀리초. iOS 기본값 250ms, Android 기본값 1000ms. |
rumEnableTrackAppCrash |
bool |
❌ | Android Java Crash 및 OC/C/C++ 크래시 모니터링 활성화 여부, 기본값 false. |
rumEnableTrackAppANR |
bool |
❌ | Native ANR 모니터링 활성화 여부, 기본값 false. |
rumEnableTraceWebView |
bool |
❌ | webview 데이터 모니터링을 활성화할지 여부, 기본값은 true입니다. |
rumAllowWebViewHost |
string json array |
❌ | 데이터 추적을 허용할 webview host 주소를 구성합니다. 기본적으로 필터링하지 않습니다. 예: ["10.0.0.1"]. SDK 0.4.3부터 WebView RUM과 로그에 동시에 적용되며, 로컬 FTMobileConfig.allowWebViewHost 및 기존 RUM 구성보다 우선합니다. |
logSamplingRate |
float |
✅ | Log 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 100. 기존 필드 logSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
logSampleRate |
float |
✅ | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. Log 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. logSamplingRate 사용을 권장합니다. |
logLevelFilters |
string json array |
✅ | 레벨 로그 필터링을 설정합니다. 기본적으로 설정하지 않습니다. 예: ["info","warn"]. |
logEnableCustomLog |
bool |
✅ | 사용자 정의 로그를 업로드할지 여부, 기본값은 false입니다. |
logEnableWebViewLog |
bool |
✅ | WebView에서 Browser Logs SDK가 생성한 로그를 수신할지 여부, 기본값 false, 로컬 FTLogConfig.enableWebViewLog를 덮어씁니다. 사용자 정의 로그 스위치와 독립적이며, 페이지는 여전히 Browser Logs SDK를 연동해야 합니다. SDK 0.4.3부터 지원됩니다. |
traceSamplingRate |
float |
✅ | Trace 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 100. 기존 필드 traceSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
traceSampleRate |
float |
✅ | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. trace 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. traceSamplingRate 사용을 권장합니다. |
traceEnableAutoTrace |
bool |
❌ | 네이티브 네트워크 자동 추적 활성화 여부, iOS NSURLSession, Android OKhttp, 기본값 false. |
traceType |
string |
❌ | 분산 추적 유형을 설정합니다. 기본값은 ddTrace, zipkinMultiHeader, zipkinSingleHeader, traceparent, skywalking, jaeger입니다. |
sessionReplaySamplingRate |
float |
✅ | Session Replay 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 100. RUM 세션 샘플링을 기반으로 Replay 샘플링을 수행합니다. 기존 필드 sessionReplaySampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
sessionReplaySampleRate |
float |
✅ (SDK 0.4.3부터 지원) | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. session replay 수집 비율을 설정합니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 1입니다. sessionReplaySamplingRate 사용을 권장합니다. |
sessionReplayOnErrorSamplingRate |
float |
✅ | Session Replay 오류 세션 샘플링 백분율, 범위 [0,100], 소수 지원, 1은 1%, 0은 수집하지 않음, 100은 전체 수집, 기본값 0. 일반 Replay 샘플링에 선택되지 않은 세션에 사용됩니다. 오류 발생 시 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 기존 필드 sessionReplayOnErrorSampleRate와 동시에 유효한 경우 0을 포함하여 이 필드가 우선합니다. SDK 0.4.3부터 지원됩니다. |
sessionReplayOnErrorSampleRate |
float |
✅ (SDK 0.4.3부터 지원) | SDK 0.4.3부터 폐기되었으며 [0,1] 단위 호환성을 유지합니다. 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않은 경우 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위는 [0,1]이며, 0은 수집하지 않음, 1은 전체 수집을 의미하고 기본값은 0입니다. sessionReplayOnErrorSamplingRate 사용을 권장합니다. |
Flutter¶
Flutter SDK 0.5.7부터 원격 구성을 지원하며, SDK 0.5.8부터 다음 백분율 샘플링 필드 및
logEnableWebViewLog를 지원합니다. Flutter Session Replay 샘플링 필드를 사용하려면ft_session_replay_flutter0.1.1 또는 이후 호환 버전을 설치하고 초기화해야 합니다.
활성화 및 업데이트 방식은 Flutter 동적 구성을 참조하세요. 아래 표는 서버 측 원격 구성 필드이며, 필드 이름은 네이티브 SDK를 따릅니다. 설정하지 않은 필드는 기존 구성을 따르며, 표의 기본값은 로컬 또는 원격 구성을 수행하지 않았을 때의 SDK 기본값을 의미합니다.
샘플링, 로그 필터링 및 데이터 업로드 등 공통 구성은 Flutter 데이터에 영향을 줍니다. 네이티브 View, Action, Resource, 끊김 등의 수집 스위치는 해당 네이티브 수집만 제어하며 Dart 측 구성을 수정하지 않습니다. rumEnableTraceUserView는 Flutter 자동 라우팅을 제어하지 않고, rumEnableTraceUserResource는 enableUserResource를 수정하지 않으며, traceEnableAutoTrace는 Dart 네트워크 추적의 enableAutoTrace를 수정하지 않습니다. Flutter LongTask의 enableLongTask 및 dartLongTaskThreshold는 현재 원격 구성을 지원하지 않습니다.
파라미터 이름 |
데이터 유형 | 실시간 적용 가능 | 설명 |
|---|---|---|---|
env |
string |
❌ | 환경, 기본값 prod, 단일 단어 사용 권장, 예: test. |
serviceName |
string |
❌ | 비즈니스 또는 서비스 이름, Log 및 RUM의 service 필드에 영향을 줍니다. iOS 기본값 df_rum_ios, Android 기본값 df_rum_android. |
autoSync |
bool |
✅ | 수집 데이터 자동 업로드 여부, 기본값 true. |
compressIntakeRequests |
bool |
✅ | 업로드 데이터에 deflate 압축을 적용할지 여부. Flutter SDK 0.5.7부터 기본값 true, 이전 기본값 false. |
syncPageSize |
int |
✅ | 배치당 업로드 항목 수, 값은 5 이상, 기본값 10; 항목 수가 많을수록 동기화에 필요한 컴퓨팅 리소스가 많아집니다. |
syncSleepTime |
int |
✅ | 배치 간 동기화 간격, 단위 밀리초, 범위 [0,5000], 기본값 0. |
sessionSamplingRate |
float |
✅ | RUM 세션 샘플링 백분율, 범위 [0,100], 기본값 100, 동일 세션의 Flutter 및 네이티브 RUM 데이터에 영향을 줍니다. SDK 0.5.8부터 지원됩니다. |
rumSampleRate |
float |
✅ | 기존 RUM 세션 샘플링 확률 호환, 범위 [0,1], 기본값 1. sessionSamplingRate 사용을 권장합니다. |
sessionOnErrorSamplingRate |
float |
✅ | 정상 RUM 세션 샘플링에 선택되지 않은 경우의 오류 보상 샘플링 백분율, 범위 [0,100], 기본값 0. SDK 0.5.8부터 지원됩니다. |
rumSessionOnErrorSampleRate |
float |
✅ | 기존 RUM 오류 보상 샘플링 확률 호환, 범위 [0,1], 기본값 0. sessionOnErrorSamplingRate 사용을 권장합니다. |
rumEnableTraceUserAction |
bool |
❌ | 네이티브 Action 자동 수집 여부, 기본값 false. Flutter 수동 보고 Action은 제어하지 않습니다. |
rumEnableTraceUserView |
bool |
❌ | 네이티브 View 자동 수집 여부, 기본값 false. Flutter 라우팅 View는 제어하지 않습니다. |
rumEnableTraceUserResource |
bool |
❌ | 네이티브 네트워크 Resource 자동 수집 여부, 기본값 false. Dart HttpClient 또는 WebSocket 수집은 제어하지 않습니다. |
rumEnableResourceHostIP |
bool |
❌ | 네이티브 Resource 요청의 Host IP 수집 여부, 기본값 false. 네이티브 네트워크 자동 수집에만 영향을 줍니다. |
rumEnableTrackAppUIBlock |
bool |
❌ | 네이티브 메인 스레드 끊김 수집 여부, 기본값 false. Flutter Dart 메인 Isolate의 LongTask 감지는 제어하지 않습니다. |
rumBlockDurationMs |
int |
❌ | 네이티브 메인 스레드 끊김 임계값, 단위 밀리초, 값은 100 이상; iOS 기본값 250, Android 기본값 1000. |
rumEnableTrackAppCrash |
bool |
❌ | 네이티브 크래시 모니터링 활성화 여부, 기본값 false. |
rumEnableTrackAppANR |
bool |
❌ | 네이티브 ANR 모니터링 활성화 여부, 기본값 false. |
rumEnableTraceWebView |
bool |
❌ | WebView RUM 데이터 수집 여부, 기본값 true. |
rumAllowWebViewHost |
string json array |
❌ | 데이터 수집을 허용할 WebView Host 목록, 기본적으로 필터링하지 않음, 예: ["example.com"], []는 모두 금지. SDK 0.5.8부터 WebView RUM과 로그에 동시에 적용되며, FTMobileFlutter.sdkConfig(allowWebViewHost: ...) 및 기존 RUM 구성보다 우선합니다. |
logSamplingRate |
float |
✅ | Log 샘플링 백분율, 범위 [0,100], 기본값 100. SDK 0.5.8부터 지원됩니다. |
logSampleRate |
float |
✅ | 기존 Log 샘플링 확률 호환, 범위 [0,1], 기본값 1. logSamplingRate 사용을 권장합니다. |
logLevelFilters |
string json array |
✅ | 로그 레벨 필터링, 기본적으로 필터링하지 않음, 예: ["info","error"]. |
logEnableCustomLog |
bool |
✅ | FTLogger 등 인터페이스를 통해 보고된 사용자 정의 로그 업로드 여부, 기본값 false. |
logEnableConsoleLog |
bool |
✅ | Android에서만 지원되며, 네이티브 콘솔 로그 수집을 제어합니다. Dart print() 자동 수집을 의미하지 않습니다. |
logEnableWebViewLog |
bool |
✅ | WebView에서 Browser Logs SDK가 생성한 로그를 수신할지 여부, 기본값 false, 사용자 정의 로그 스위치와 독립적입니다. 페이지는 여전히 Browser Logs SDK를 연동해야 하며 WebView 로그 수집을 참조하세요. SDK 0.5.8부터 지원됩니다. |
traceSamplingRate |
float |
✅ | Trace 샘플링 백분율, 범위 [0,100], 기본값 100. SDK 0.5.8부터 지원됩니다. |
traceSampleRate |
float |
✅ | 기존 Trace 샘플링 확률 호환, 범위 [0,1], 기본값 1. traceSamplingRate 사용을 권장합니다. |
traceEnableAutoTrace |
bool |
❌ | 네이티브 네트워크 자동 추적 활성화 여부, iOS는 NSURLSession, Android는 OkHttp, 기본값 false. Dart 네트워크 추적의 enableAutoTrace는 제어하지 않습니다. |
traceType |
string |
❌ | 분산 추적 유형, 예: ddTrace, traceparent, jaeger, 기본값 ddTrace. |
sessionReplaySamplingRate |
float |
✅ | RUM 세션 샘플링을 기반으로 한 Replay 샘플링 백분율, 범위 [0,100], 기본값 100. Core SDK 0.5.8, Replay SDK 0.1.1부터 지원됩니다. |
sessionReplaySampleRate |
float |
✅ | 서버 호환 기존 Replay 샘플링 확률, 범위 [0,1], 기본값 1. sessionReplaySamplingRate 사용을 권장합니다. |
sessionReplayOnErrorSamplingRate |
float |
✅ | 정상 Replay 샘플링에 선택되지 않은 경우의 오류 보상 샘플링 백분율, 범위 [0,100], 기본값 0. Core SDK 0.5.8, Replay SDK 0.1.1부터 지원됩니다. |
sessionReplayOnErrorSampleRate |
float |
✅ | 서버 호환 기존 Replay 오류 보상 샘플링 확률, 범위 [0,1], 기본값 0. sessionReplayOnErrorSamplingRate 사용을 권장합니다. |
백분율 필드는 모두 소수를 지원하며, 0.1은 0.1%, 1은 1%를 의미합니다. 0은 샘플링하지 않음, 100은 전체 샘플링을 의미합니다. 동일한 항목에 유효한 신규 필드와 기존 필드가 동시에 설정된 경우 명시적 0을 포함하여 신규 백분율 필드가 우선합니다. 기존 확률 값을 마이그레이션할 때는 환산이 필요하며, 예를 들어 0.125는 12.5에 대응하며 둘 다 12.5%를 의미합니다.
모바일(Android, iOS/tvOS, HarmonyOS, React Native, Flutter) 원격 구성 적용 규칙:
-
실시간 적용 가능: 모바일 SDK가 원격 구성을 동기화한 후 SDK를 다시 초기화하지 않고 즉시 적용할 수 있으며, 주로 속도 제한 상황에 대응하기 위한 것입니다.
-
구성 삭제: 다음 시작 시 적용됩니다.
-
파라미터 형식 구성 오류: 파라미터를 해당 데이터 유형에 맞게 설정하지 않았거나 파싱 중 오류가 발생하면 유효하지 않은 구성으로 간주되어 아무런 효과도 없습니다.