콘텐츠로 이동

사용자 정의 환경 변수¶

핵심 필드¶

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]`. 기본값은 설정되지 않습니다.
`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 멈춤(블로킹) 감지 활성화 여부입니다. 기본값은 `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"].
`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 멈춤(블로킹) 감지 활성화 여부입니다. 기본값은 `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`입니다.

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, React Native) 원격 설정 적용 규칙:

핫 리로드 가능: SDK를 다시 초기화하지 않고도 모바일 SDK가 원격 설정을 동기화한 후 즉시 적용됩니다. 주로 속도 제한 시나리오에 대응합니다.
설정 삭제: 다음 시작 시 적용됩니다.
매개변수 형식 설정 오류: 매개변수가 해당 데이터 타입에 맞게 설정되지 않았거나 구문 분석 중 오류가 발생하면 무효한 설정으로 간주되어 아무런 효과도 나타내지 않습니다.