설정

sophonz-config.json의 전체 항목과 Gradle sophonz 확장 블록의 옵션, 수집기 주소와 앱 키를 지정하는 방법을 정리합니다.

설정은 두 곳에 나뉘어 있습니다. 무엇을 수집할지는 sophonz-config.json이, 바이트코드를 어떻게 손댈지는 Gradle의 sophonz 블록이 정합니다. 둘 다 빌드 시점에 SDK에 새겨지므로 런타임에 바꿀 수 없습니다.

키	타입	설명
`app_id`	string	5자여야 합니다. 환경 변수 `SOPHONZ_APP_ID`로도 지정
`api_token`	string	32자 이상이어야 합니다. 환경 변수 `SOPHONZ_API_TOKEN`으로도 지정
`ndk_enabled`	boolean	네이티브 크래시 수집. 기본값 `true`
`sdk_config`	object	아래 항목

키	효과
`collector_url`	OTLP 수집기 기본 주소. 생략하면 `https://in.sophonz.ai`
`service_key`	앱 키. `service.key` 리소스 속성으로 전송
`service_namespace`	`service.namespace` 리소스 속성
`deployment_environment`	`deployment.environment.name` 리소스 속성

키	타입	기본값
`automatic_data_capture.power_save_mode_info`	boolean	`true`
`automatic_data_capture.network_connectivity_info`	boolean	`true`
`automatic_data_capture.anr_info`	boolean	`true`
`automatic_data_capture.ui_load_tracing_disabled`	boolean	`false`
`automatic_data_capture.ui_load_tracing_selected_only`	boolean	`false`
`automatic_data_capture.end_startup_with_app_ready`	boolean	`false`
`automatic_data_capture.activity_process_lifecycle_tracker_enabled`	boolean	`false`
`view_config.enable_automatic_activity_capture`	boolean	`true`
`taps.capture_coordinates`	boolean	`false`
`compose.capture_compose_onclick`	boolean	`false`
`webview.enable`	boolean	`true`
`webview.capture_query_params`	boolean	`true`
`webview.fragment_capture`	`keep` · `redact` · `remove`	`keep`
`crash_handler.enabled`	boolean	`true`
`app_exit_info.aei_enabled`	boolean	`true`
`capture_fcm_pii_data`	boolean	`false`
`app.report_disk_usage`	boolean	`true`
`background_activity.capture_enabled`	boolean	`false`
`sig_handler_detection`	boolean	`false`
`otel.enable_otel_kotlin_sdk`	boolean	`false`
`app_framework`	`react_native` · `unity` · `flutter` · `native`	없음

키	타입	기본값
`networking.enable_huc_lite_instrumentation`	boolean	`true`
`networking.enable_native_monitoring`	boolean	`false`
`networking.enable_traceparent_injection`	boolean	`false`
`networking.traceparent_only_allow_domains`	string[]	없음
`networking.enable_network_span_forwarding`	boolean	`false`
`networking.capture_request_content_length`	boolean	`false`
`networking.capture_okhttp_response_body_size`	boolean	`false`
`networking.disabled_url_patterns`	string[] (정규식)	`[]`
`networking.default_capture_limit`	int	`1000`
`networking.domains[]`	`{domain_name, domain_limit}`	`[]`

키	타입	기본값
`sensitive_keys_denylist`	string[]	없음
`capture_public_key`	string	없음

저장소의 스키마 파일은 taps.capture_coordinates, networking.capture_request_content_length, networking.enable_native_monitoring, sig_handler_detection의 기본값을 true로 적고 있으나, 키를 생략했을 때 실제로 적용되는 값은 위 표대로 모두 false입니다.

Gradle 확장

app/build.gradle.kts

sophonz {
  bytecodeInstrumentation {
    okhttpEnabled.set(true)
    firebasePushNotificationsEnabled.set(true)
  }
}

최상위 옵션

옵션	기본값	설명
`autoAddSophonzDependencies`	`true`	SDK 의존성 자동 추가. 제거 예정
`autoAddSophonzComposeClickDependency`	`false`	Compose 탭 계측 의존성 자동 추가
`telemetryEnabled`	`true`	플러그인 자체의 사용 통계 전송
`failBuildOnUploadErrors`	`true`	심볼 업로드 실패 시 빌드 중단
`customSymbolsDirectory`	없음	심볼 파일 경로 지정

바이트코드 계측

옵션	기본값	대상
`enabled`	`true`	전체 마스터 스위치
`okhttpEnabled`	`true`	OkHttp 인터셉터 삽입
`onClickEnabled`	`true`	View 클릭
`onLongClickEnabled`	`true`	View 롱클릭
`webviewOnPageStartedEnabled`	`true`	WebView 페이지 로드
`applicationInitTimingEnabled`	`true`	Application 초기화 시간 측정
`autoSdkInitializationEnabled`	`false`	SDK 자동 시작
`firebasePushNotificationsEnabled`	`false`	FCM 메시지 수신
`classIgnorePatterns`	`[]`	제외할 패키지 패턴

enabled를 끄면 나머지 값과 무관하게 바이트코드 계측이 모두 멈춥니다. 특정 패키지만 제외하려면 다음과 같이 지정합니다.

sophonz {
  bytecodeInstrumentation {
    classIgnorePatterns.set(listOf("com.example.vendor.*"))
  }
}

배리언트별 제어

sophonz {
  buildVariantFilter {
    if (name.contains("debug")) {
      disablePluginForVariant()
    }
  }
}

disableBytecodeInstrumentationForVariant()는 계측만 끄고 플러그인은 유지합니다. disablePluginForVariant()는 해당 배리언트에서 플러그인 전체를 비활성화합니다.

설정

sophonz-config.json

최상위

수집기 연결

수집 항목

네트워크

민감정보

Gradle 확장

최상위 옵션

바이트코드 계측

배리언트별 제어