New Relic Cordova 에이전트는 Apache Cordova 프레임워크 에 구축된 기본 애플리케이션(iOS, Android)을 모니터링합니다. JavaScript로 작성된 Cordova 에이전트에는 네이티브 앱을 위한 모든 New Relic 모바일 모니터링 기능도 포함되어 있습니다.
특징
일단 설치되면 Cordova 에이전트는 다음을 수행할 수 있습니다.
- Cordova 애플리케이션에 추가된 플랫폼을 감지하고 관련 New Relic Android 또는 iOS 에이전트의 최신 릴리스를 적용합니다.
- iOS 기호화 파일 업로드를 위한 빌드 후 스크립트 추가
- Android Proguard 매핑 파일 업로드
- Cordova를 통해 구축된 모바일 애플리케이션을 자동으로 계측
- 자바스크립트 오류 캡처
- 분산 추적 생성
- 약속 거부 추적(JavaScript에서 처리되지 않은 예외)
- 콘솔 로그로 경고 및 오류 추적
- 상호 작용 및 해당 시퀀스 캡처
- 사용자 세션 추적
Cordova 모니터링 시작하기
1단계: 요구 사항 확인
설치하기 전에 Cordova 프로젝트에 Android 또는 iOS 플랫폼을 추가하기 위한 다음 전제 조건을 충족하는지 확인하십시오.
2단계: 애플리케이션 토큰 받기
New Relic을 처음 사용하는 경우 계정을 만드세요 . 무료입니다!
먼저, 나중에 3단계 에서 사용할 애플리케이션 토큰을 가져와야 합니다.
- one.newrelic.com > Browser & Mobile > (Android 또는 iOS 선택) 으로 이동한 다음 UI에서 계측 단계를 완료합니다.
- UI의 4단계 에서 애플리케이션 토큰을 복사합니다. Cordova 에이전트를 설치할 때 필요합니다.
3단계: Cordova 에이전트 설치
Cordova 프로젝트 디렉터리에서 Cordova 명령줄 도구를 사용하여 Cordova 에이전트를 프로젝트에 추가하고
--variable
인수를 사용하여 2단계 의 애플리케이션 토큰을 붙여넣습니다.# Install from github repositorycordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}"중요
앱이 iOS와 Android 모두에서 빌드된 경우 iOS 및 Android용 애플리케이션 토큰을 별도로 가져와야 합니다.
(선택 사항) 이온 프레임워크 를 사용하는 경우 Cordova 프로젝트 디렉터리에 다음을 추가합니다.
bash$ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="{ios-app-token}" --variable ANDROID_APP_TOKEN="{android-app-token}"$$npm install @awesome-cordova-plugins/newrelic그런 다음 앱을 배포합니다.
그리고 끝났습니다! 이제 New Relic에서 데이터를 볼 시간입니다(앱을 배포한 후 몇 분 정도 걸릴 수 있음).
4단계: 뉴렐릭에서 데이터 보기
one.newrelic.com > Mobile > (Cordova 앱 선택)으로 이동하여 New Relic 모바일 모니터링 UI에서 앱의 성능 데이터를 확인합니다.
one.newrelic.com > Mobile > (Cordova 앱 선택) : Cordova 에이전트가 이 데이터를 수집하여 UI에서 보고 분석할 수 있는 New Relic으로 보냅니다.
(선택 사항) 5단계: JavaScript 오류 추적
프로젝트에 NewRelic.recordError(error);
를 추가하여 JavaScript 오류에 대한 사용자 정의 이벤트를 생성하고 이를 New Relic에 보고하도록 Cordova 에이전트를 구성할 수 있습니다.
NewRelic.recordError(error);
그런 다음 UI에서 사용자 지정 대시보드를 사용하여 이러한 JavaScript 오류 이벤트를 추적할 수 있습니다. 사용자 지정 대시보드를 만들려면:
one.newrelic.com 으로 이동합니다.
쿼리 빌더 를 클릭합니다.
다음 쿼리를 실행합니다.
SELECT * FROM `JS Errors`대시보드에 추가 를 클릭합니다.
one.newrelic.com > Query builder : Query builder 를 사용하여 Cordova 앱에서 JavaScript 오류를 추적하기 위한 맞춤형 대시보드를 생성합니다.
대시보드를 시작하는 데 도움이 필요한 경우 대시 보드 소개 를 참조하십시오.
다음 단계
API 호출을 사용하여 사용자 지정 데이터 추적: Cordova 에이전트는 iOS 및 Android SDK 에이전트와 동일한 API 호출을 사용합니다. iOS SDK 또는 Android SDK 를 참조하십시오.
Cordova 에이전트 버전 업데이트: Cordova 에이전트를 최신 버전으로 업데이트해야 하는 경우 다음 간단한 명령을 실행하십시오.
cordova plugin update