사용자 지정 환경 변수¶
주요 필드¶
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) 시나리오에 대응합니다.
-
구성 삭제: 다음 시작 시 적용됩니다.
-
파라미터 형식 설정 오류: 파라미터가 해당 데이터 타입에 맞게 설정되지 않았거나 파싱 오류가 발생하면 무효한 구성으로 간주되어 아무런 효과도 없습니다.