iOS 및 Android용 공식 New Relic Cordova 플러그인을 사용하면 개발자가 모바일 에이전트를 Cordova 애플리케이션 에 쉽게 포함할 수 있습니다. JavaScript로 작성된 플러그인에는 New Relic의 기본 에이전트가 자동으로 포함되어 모바일 모니터링 및 성능 가시성 을 제공합니다.
특징
New Relic Cordova 플러그인은 다음을 수행합니다.
- Cordova 애플리케이션에 추가된 플랫폼을 감지하고 적절한 New Relic 모바일 에이전트( Android 또는 iOS )의 최신 릴리스를 적용합니다.
- iOS 기호화 파일을 업로드하기 위한 빌드 후 스크립트를 추가합니다.
- Android Proguard 매핑 파일을 업로드합니다.
- Cordova를 통해 구축된 모바일 애플리케이션을 자동으로 계측합니다.
자세한 내용 은 Github의 New Relic Cordova 플러그인을 참조하십시오.
호환성 및 요구 사항
New Relic Cordova 플러그인에는 다음이 필요합니다.
네트워크 요청은 webview 및 기본 프레임워크에 대한 iOS 장치에만 기록됩니다. Android는 기본 네트워크 호출만 녹음합니다.
Cordova는 일반적으로 기본적으로 예외를 처리합니다. Cordova 플러그인은 Cordova가 처리하지 않는 포착되지 않은 예외(충돌)를 기록합니다.
Cordova 플러그인 설치
설치하기 전에 Android 또는 iOS 플랫폼을 Cordova 프로젝트에 추가하기 위한 전제조건 을 충족했는지 확인하십시오. 그런 다음 다음 단계에 따라 Cordova 플러그인을 설치합니다.
아직 계정이 없다면 가입 하세요(무료).
해당하는 경우 iOS 및 Android에 대해 별도의 애플리케이션 토큰을 사용합니다.
New Relic 애플리케이션 페이지에서 구축 중인 Cordova 플랫폼에 대한 애플리케이션 토큰을 복사하십시오.
Cordova 프로젝트 디렉토리로 변경한 다음 Cordova 명령줄 도구를 사용하여 프로젝트에 플러그인을 추가하십시오.
--variable
인수를 사용하여 플러그인에 애플리케이션 토큰을 전달합니다.# 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}"앱을 배포합니다.
모바일 모니터링 UI 에서 성능 데이터를 봅니다.
플러그인 업데이트
다음 명령을 사용하여 New Relic Cordova 플러그인을 최신 릴리스 버전으로 쉽게 업데이트하십시오.
cordova plugin update
기본 Cordova 속성
Cordova 플러그인은 다음 속성을 수집합니다.
기인하다 | 설명 |
---|---|
| 모니터링되는 앱의 고유 식별자입니다. 예: 35091 . |
| 충돌한 바이너리의 기술 빌드 번호를 나타냅니다. 개발자는 이 속성을 사용하여 앱의 어떤 빌드가 충돌했는지 정확히 확인할 수 있습니다. |
| 모니터링되는 앱의 이름입니다. 예를 들어, New Relic iOS . |
| 모니터링되는 앱의 버전 번호입니다. 예를 들어, 2.2.9 . |
| 모니터링되는 앱의 New Relic 고유 버전 번호입니다. |
| armv7, arm64와 같은 장치의 프로세서 아키텍처. |
| 데이터가 보고될 때 장치와 연결된 자율 시스템 번호입니다. |
| ASN의 통신 소유자입니다. |
| WiFi , Verizon , Sprint 등과 같이 앱이 데이터를 전송한 모바일 네트워크입니다. |
| 수집되는 데이터의 유형입니다. 표준 범주는 세션 , 상호 작용 및 충돌 입니다. API를 통해 사용자 지정 이벤트를 추가한 경우 사용자 지정 범주를 사용합니다. |
| 포틀랜드 또는 시애틀 과 같이 모니터링되는 앱이 있는 도시입니다. |
| 모니터링되는 앱이 있는 국가입니다. 예를 들어 영국의 경우 GB 입니다. 국가 코드 목록은 ISO 3166-1 alpha-2 를 참조하십시오. |
| 충돌과 관련된 예외(있는 경우)입니다. 예: |
| 충돌과 관련된 메시지(있는 경우). |
| iPad Air 또는 Galaxy S5 와 같은 기기의 이름입니다. |
| iPod Touch 또는 iPad 와 같은 기기 카테고리입니다. |
| 장치 제조업체입니다. 예를 들어, 모토로라 또는 HTC . |
| 장치의 모델 번호입니다. 예: XT1039 또는 SM-G900F . |
| 상호 작용이 장치에서 렌더링되는 총 시간(초)입니다. 렌더링 시간 외에도 여기에는 일반적으로 상호 작용과 관련된 모든 외부 호출이 포함됩니다. |
|
|
| 충돌 이벤트 이전의 마지막 상호작용(있는 경우)입니다. 예를 들어 앱 실행 . |
| 애플리케이션에서 사용한 총 메모리 양(MB)입니다. 60초마다 업데이트됩니다. |
| 이벤트와 연결된 상호 작용의 이름입니다. 예: ApplicationsListFragment 또는 NavigationDrawerFragment . |
| 애플리케이션에서 실행 중인 에이전트의 버전 번호입니다. 예: 4.232.0 . |
| iOS 7.0.4 와 비교하여 iOS 7 과 같은 앱 호스트 운영 체제의 단순화된 버전 번호입니다. |
| iOS 또는 Android 와 같은 앱의 호스트 운영 체제 이름입니다. |
| iOS 7 과 비교한 iOS 7.0.4 와 같은 앱 호스트 운영 체제의 정확한 버전 번호입니다. |
| 모니터링되는 앱이 있는 국가 내의 특정 지역입니다. 미국에서 지역은 주입니다. |
| 사용자가 애플리케이션을 사용한 시간(초)입니다. 세션이 충돌하면 10분보다 긴 세션의 경우 세션이 진행되는 동안 Interaction 및 Custom 이벤트 카테고리 의 이벤트가 New Relic으로 전송되므로 |
| 단일 사용자 세션에 대한 고유 식별자입니다. |
| 충돌 이벤트 이전의 상호작용 이후 경과된 시간(초)입니다. |
| 모바일 세션 시작부터 이벤트가 발생한 시간까지의 시간(초)입니다. 이벤트는 Session, Interaction 또는 Crash의 기본 제공 이벤트 카테고리일 수 있으며 에이전트 API를 통해 전송된 모든 사용자 정의 이벤트가 될 수 있습니다. |
| 업그레이드가 감지되면 사용자가 업그레이드한 이전 버전의 버전 번호를 지정합니다. 예: |
| B8B0BC30-0235-11E4-9191-0800200C9A66 과 같이 특정 기기에 앱을 설치하기 위한 고유 식별자입니다. |