콘텐츠로 이동

사용자 지정 환경 변수


주요 필드

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에 저장할 key를 정의합니다. 기본값은 비어 있으며 자동 생성됩니다.
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], 기본값은 설정하지 않음.
rumSampleRate float ✅ RUM 샘플링 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다. Android: ft-sdk > 1.6.16
rumSessionOnErrorSampleRate float ✅ 오류 수집 비율을 설정합니다. 세션이 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가 변경되지 않는 한 IP를 한 번만 생성합니다.
rumEnableTrackAppUIBlock bool ❌ UI 멈춤(Freeze) 감지 활성화 여부. 기본값 false.
rumBlockDurationMs int ❌ UI 멈춤 감지 임계값을 설정합니다. 값 범위 [100,∞), 단위 밀리초, 기본값 1초.
rumEnableTrackAppCrash bool ❌ App 크래시 로그 업로드 여부. 기본값 false.
rumEnableTrackAppANR bool ❌ ANR 감지 활성화 여부. 기본값 false.
rumEnableTraceWebView bool ❌ webview 데이터 모니터링 활성화 여부. 기본값 true.
rumAllowWebViewHost string json array ❌ 데이터 추적을 허용할 webview host 주소를 설정합니다. 기본적으로 필터링하지 않습니다. 예: ["10.0.0.1"].
logSampleRate float ✅ Log 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. Android: ft-sdk > 1.6.16
logLevelFilters string json array ✅ 로그 레벨 필터를 설정합니다. 기본값은 설정하지 않음. 예: ["info","warn"].
logEnableConsoleLog bool ✅ 콘솔 로그 업로드 여부. Android에서만 지원합니다.
logEnableCustomLog bool ✅ 사용자 지정 로그 업로드 여부. 기본값 false.
traceSampleRate float ✅ trace 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. Android: ft-sdk > 1.6.16
traceEnableAutoTrace bool ❌ 자동 http trace 활성화 여부를 설정합니다. 현재 OKhttp의 자동 추적만 지원하며 기본값은 false입니다.
traceType string ❌ 분산 추적 유형을 설정합니다. 기본값 DDTrace.
sessionReplaySampleRate float ❌ session replay 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1.
sessionReplayOnErrorSampleRate float ❌ 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않았을 때, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 0.

iOS/tvOS

파라미터 이름
데이터 타입 즉시 적용 설명
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], 기본값은 설정하지 않음.
rumSampleRate float ✅ RUM 샘플링 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다. iOS: ft-sdk > 1.5.21
rumSessionOnErrorSampleRate float ✅ 오류 수집 비율을 설정합니다. 세션이 rumSampleRate로 샘플링되지 않았을 때, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 0. 적용 범위는 rumSampleRate와 동일합니다. 즉시 적용: iOS: ft-sdk > 1.5.21
rumEnableTraceUserAction bool ❌ 사용자 Action 동작 추적 여부. 기본값 false.
rumEnableTraceUserView bool ❌ 사용자 View 동작 추적 여부. 기본값 false.
rumEnableTraceUserResource bool ❌ 사용자 네트워크 요청 추적 여부. 기본값 false.
rumEnableResourceHostIP bool ❌ 요청 대상 도메인 주소의 IP를 수집할지 여부. >= iOS 13.0, >= tvOS 13.0에서 지원합니다.
rumEnableTrackAppUIBlock bool ❌ UI 멈춤(Freeze) 감지 활성화 여부. 기본값 false.
rumBlockDurationMs int ❌ UI 멈춤 감지 임계값을 설정합니다. 값 범위 [100,∞), 단위 밀리초, 기본값 250ms.
rumEnableTrackAppCrash bool ❌ 크래시 로그 수집 여부. 기본값 false.
rumEnableTrackAppANR bool ❌ ANR 감지 활성화 여부. 기본값 false.
rumEnableTraceWebView bool ❌ webview 데이터 모니터링 활성화 여부. 기본값 true.
rumAllowWebViewHost string json array ❌ 데이터 추적을 허용할 webview host 주소를 설정합니다. 기본적으로 필터링하지 않습니다. 예: ["10.0.0.1"].
logSampleRate float ✅ Log 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. iOS: ft-sdk > 1.5.19
logLevelFilters string json array ✅ 로그 레벨 필터를 설정합니다. 기본값은 설정하지 않음. 예: ["info","warn"].
logEnableCustomLog bool ✅ 사용자 지정 로그 업로드 여부. 기본값 false.
traceSampleRate float ✅ trace 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. iOS: ft-sdk > 1.5.19
traceEnableAutoTrace bool ❌ 자동 http trace 활성화 여부를 설정합니다. 현재 NSURLSession만 지원하며 기본값은 false입니다.
traceType string ❌ 분산 추적 유형을 설정합니다. 기본값 DDTrace.
sessionReplaySampleRate float ❌ session replay 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1.
sessionReplayOnErrorSampleRate float ❌ 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않았을 때, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 0.

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 멈춤(Freeze) 감지 활성화 여부. 기본값 false. 새 값은 다음 SDK 초기화 시 적용됩니다.
rumBlockDurationMs int ❌ UI 멈춤 임계값, 단위 밀리초, 최소 100, 기본값 1000. rumEnableTrackAppUIBlock와 함께 설정해야 다음 초기화 시 적용됩니다.
rumEnableTrackAppCrash bool ❌ App 크래시 모니터링 활성화 여부. 기본값 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

파라미터 이름
데이터 타입 즉시 적용 설명
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], 기본값은 설정하지 않음.
rumSampleRate float ✅ RUM 샘플링 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1. 적용 범위는 동일한 session_id 아래의 모든 View, Action, LongTask, Error 데이터입니다.
rumSessionOnErrorSampleRate float ✅ 오류 수집 비율을 설정합니다. 세션이 rumSampleRate로 샘플링되지 않았을 때, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 0. 적용 범위는 rumSampleRate와 동일합니다.
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"].
logSampleRate float ✅ Log 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1.
logLevelFilters string json array ✅ 로그 레벨 필터를 설정합니다. 기본값은 설정하지 않음. 예: ["info","warn"].
logEnableCustomLog bool ✅ 사용자 지정 로그 업로드 여부. 기본값 false.
traceSampleRate float ✅ trace 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1.
traceEnableAutoTrace bool ❌ 네이티브 네트워크 자동 추적(iOS NSURLSession, Android OKhttp) 활성화 여부를 설정합니다. 기본값 false.
traceType string ❌ 분산 추적 유형을 설정합니다. 기본값은 ddTrace, zipkinMultiHeader, zipkinSingleHeader, traceparent, skywalking, jaeger입니다.
sessionReplaySampleRate float ❌ session replay 수집 비율을 설정합니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 1.
sessionReplayOnErrorSampleRate float ❌ 오류 수집 비율을 설정합니다. 세션이 sessionReplaySampleRate로 샘플링되지 않았을 때, 세션 중 오류가 발생하면 오류 발생 전 1분 범위의 데이터를 수집할 수 있습니다. 값 범위 [0,1], 0은 수집 안 함, 1은 전체 수집, 기본값 0.

모바일(Android, iOS/tvOS, HarmonyOS, React Native) 원격 구성 적용 규칙:

  • 즉시 적용: SDK를 다시 초기화하지 않고도 모바일 SDK가 원격 구성을 동기화한 후 바로 적용할 수 있습니다. 주로 요청 제한(rate limiting) 시나리오에 대응합니다.

  • 구성 삭제: 다음 시작 시 적용됩니다.

  • 파라미터 형식 설정 오류: 파라미터가 해당 데이터 타입에 맞게 설정되지 않았거나 파싱 오류가 발생하면 무효한 구성으로 간주되어 아무런 효과도 없습니다.

문서 평가

이 페이지가 도움이 되었나요?