React Native 애플리케이션 연동¶
React Native 애플리케이션의 메트릭 데이터를 수집하여 애플리케이션 성능을 시각화 방식으로 분석합니다.
읽기 경로¶
- 최초 연동: 먼저 연동 방식 선택을 확인하고, 수동 연동은 빠른 시작을 참고할 수 있습니다.
- 전체 연동: 본 문서를 계속 읽습니다.
- 파라미터 상세: SDK 초기화, RUM 설정, Log 설정, Trace 설정을 참고하세요.
- 사용자 정의 기능: 사용자 정의 태그 사용, 데이터 수집 사용자 정의 규칙, 데이터 수집 마스킹을 참고하세요.
- 고급 시나리오: "고급 시나리오" 그룹의 전용 페이지를 참고하세요.
- 문제 해결: 문제 해결을 참고하세요.
사전 요구 사항¶
주의
RUM Headless 서비스가 이미 활성화된 경우 사전 요구 사항이 자동으로 구성되었으므로 애플리케이션을 바로 연동할 수 있습니다.
로컬 환경에 배포하는 경우 다음 데이터 수신 측 구성을 완료해야 합니다. 공인 DataWay를 사용하는 경우 DataKit을 직접 배포할 필요가 없습니다.
- DataKit을 설치합니다.
- RUM 수집기를 구성합니다.
- DataKit을 공인망에서 액세스할 수 있게 구성하고 IP 지리 정보 라이브러리를 설치합니다.
애플리케이션 연동¶
주의
현재 React Native 버전은 Android 및 iOS 플랫폼만 지원합니다.
- RUM > 새 애플리케이션 > React Native로 이동합니다.
- Android 및 iOS 플랫폼의 RUM 데이터를 각각 수신할 수 있도록 React Native Android용과 React Native iOS용 애플리케이션을 각각 생성합니다.
- 각 플랫폼의 애플리케이션에 해당 애플리케이션 이름과 애플리케이션 ID를 입력합니다.
- 「연동 방식 선택」에서 Agent 자동 연동 또는 수동 연동을 선택한 후 「연동 구성」을 완료합니다.
연동 방식 선택¶
애플리케이션 구성 페이지에서 「Agent 자동 연동」 또는 「수동 연동」을 선택한 후 「연동 구성」을 완료합니다. 기존 애플리케이션은 구성 페이지로 바로 이동하여 연동을 계속할 수 있습니다.
| 연동 방식 | 사용 사례 | 작업 경로 |
|---|---|---|
| Agent 자동 연동 | 코딩 어시스턴트가 프로젝트를 분석하고 SDK 연동을 완료하도록 하려는 경우 | 콘솔에서 생성된 프롬프트를 복사하여 애플리케이션 코드 저장소에서 코딩 어시스턴트에 전달해 실행 |
| 수동 연동 | SDK를 직접 설치하고 파라미터를 구성하려는 경우 | 데이터 보고 방식을 확인한 후 본 문서와 빠른 시작에 따라 구성을 완료 |
Agent 자동 연동¶
- 현재 애플리케이션의 구성 페이지에서 「Agent 자동 연동」을 선택합니다.
- 「연동 구성」의 전체 프롬프트를 복사하고 현재 애플리케이션의 연동 정보가 사용되었는지 확인합니다.
- 애플리케이션 코드 저장소에서 코딩 어시스턴트를 열고 프롬프트를 붙여넣으면 Agent가 연동 가이드에 따라 프로젝트를 분석하고 SDK 구성을 완료합니다.
- 애플리케이션을 빌드하고 실행한 뒤 페이지 방문 등의 작업을 수행하여 현재 애플리케이션의 탐색기에서 데이터 수신을 확인합니다.
크로스 플랫폼 프레임워크를 사용하는 경우 Agent에 프레임워크와 대상 플랫폼을 설명하고 각 플랫폼에 해당하는 애플리케이션 정보를 각각 제공하세요.
페이지에 개인 API Key 또는 임시 인증 코드가 준비되지 않았다고 표시되면 안내에 따라 보완한 후 프롬프트를 다시 복사하세요.
수동 연동¶
애플리케이션 구성 페이지에서 「수동 연동」을 선택하고 데이터 보고 방식을 확인합니다.
- 공인 DataWay: RUM 데이터를 직접 수신하며 DataKit 수집기를 설치할 필요가 없습니다.
- 로컬 환경 배포: 사전 요구 사항을 충족한 후 RUM 데이터를 수신합니다.
아래 설치 및 빠른 시작에 따라 SDK 설치, 초기화 및 검증을 완료합니다. 기존 SDK 구성이 있는 경우 먼저 확인하고 재사용하여 중복 초기화를 방지해야 합니다.
설치¶
소스 코드 주소: https://github.com/GuanceCloud/datakit-react-native
Demo 주소: https://github.com/GuanceCloud/datakit-react-native/example
프로젝트 경로의 터미널에서 다음 명령을 실행합니다:
이렇게 하면 패키지의 package.json에 다음 종속성이 추가됩니다:
Android 통합 추가 구성:
-
Gradle Plugin ft-plugin을 구성하여 App 시작 이벤트와 네트워크 요청 데이터, Android Native 관련 이벤트(페이지 이동, 클릭 이벤트, Native 네트워크 요청, WebView 데이터)를 수집합니다.
-
Gradle에서 Guance Android Maven 저장소 주소를 동시에 구성해야 하며 Plugin과 AAR 모두 필요합니다. 구성 세부 사항은 example의 build.gradle을 참고하세요.
초기화 설명¶
최소 초기화 예시는 빠른 시작을 참고하세요.
전체 FTMobileConfig 파라미터 설명은 SDK 초기화를 참고하세요.
상세 구성 경로¶
고급 시나리오¶
- 사용자 정의 태그 사용
- 데이터 수집 사용자 정의 규칙
- 데이터 수집 마스킹
- 동적 구성
- 심볼 파일 업로드
- 핫 업데이트 SourceMap 버전 매칭
- WebView 데이터 모니터링
- 방문자 식별자 Visitor ID
- Native 및 React Native 하이브리드 개발
- Android Resource 수동 구성