• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

코르도바를 위한 New Relic 소개

iOS 및 Android용 공식 New Relic Cordova 플러그인을 사용하면 개발자가 모바일 에이전트를 Cordova 애플리케이션 에 쉽게 포함할 수 있습니다. JavaScript로 작성된 플러그인에는 New Relic의 기본 에이전트가 자동으로 포함되어 모바일 모니터링 및 성능 가시성 을 제공합니다.

특징

New Relic Cordova 플러그인은 다음을 수행합니다.

  • Cordova 애플리케이션에 추가된 플랫폼을 감지하고 관련 New Relic Android 또는 iOS 에이전트의 최신 릴리스를 적용합니다.
  • iOS 기호화 파일 업로드를 위한 빌드 후 스크립트 추가
  • Android Proguard 매핑 파일 업로드
  • Cordova를 통해 구축된 모바일 애플리케이션을 자동으로 계측
  • 자바스크립트 오류 캡처
  • 분산 추적 생성
  • 약속 거부 추적(JavaScript에서 처리되지 않은 예외)
  • 콘솔 로그로 경고 및 오류 추적
  • 상호 작용 및 해당 시퀀스 캡처
  • 사용자 세션 추적

자세한 내용 은 Github의 New Relic Cordova 플러그인을 참조하십시오.

호환성 및 요구 사항

New Relic Cordova 플러그인에는 다음이 필요합니다.

네트워크 요청은 webview 및 기본 프레임워크에 대한 iOS 장치에만 기록됩니다. Android는 기본 네트워크 호출만 녹음합니다.

Cordova는 일반적으로 기본적으로 예외를 처리합니다. Cordova 플러그인은 Cordova가 처리하지 않는 포착되지 않은 예외(충돌)를 기록합니다.

Cordova 플러그인 설치

설치하기 전에 Android 또는 iOS 플랫폼을 Cordova 프로젝트에 추가하기 위한 전제조건 을 충족했는지 확인하십시오. 그런 다음 다음 단계에 따라 Cordova 플러그인을 설치합니다.

  1. 아직 계정이 없다면 가입 하세요(무료).

  2. 해당하는 경우 iOS 및 Android에 대해 별도의 애플리케이션 토큰을 사용합니다.

  3. New Relic 애플리케이션 페이지에서 구축 중인 Cordova 플랫폼에 대한 애플리케이션 토큰을 복사하십시오.

  4. Cordova 프로젝트 디렉토리로 변경한 다음 Cordova 명령줄 도구를 사용하여 프로젝트에 플러그인을 추가하십시오. --variable 인수를 사용하여 플러그인에 애플리케이션 토큰을 전달합니다.

    # Install from github repository
    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}"
  5. 앱을 배포합니다.

  6. 모바일 모니터링 UI 에서 성능 데이터를 봅니다.

플러그인 업데이트

다음 명령을 사용하여 New Relic Cordova 플러그인을 최신 릴리스 버전으로 쉽게 업데이트하십시오.

cordova plugin update

이온 기본 설치

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

API 호출

Cordova 플러그인은 iOS 및 Android SDK 에이전트와 동일한 API 호출을 사용합니다. New Relic iOS SDK 문서 또는 Android SDK 문서 를 참조하십시오.

JavaScript 오류의 경우 다음과 같이 NewRelic.recordError(error) 를 호출할 수 있습니다.

NewRelic.recordError(error);

자바스크립트 오류

Cordova 플러그인은 JavaScript 오류에 대한 사용자 정의 이벤트를 생성하고 이를 New Relic에 보고합니다. UI에서 사용자 정의 대시보드를 사용하여 이러한 JavaScript 오류 이벤트를 추적할 수 있습니다.

사용자 정의 대시보드를 생성하려면:

  1. one.newrelic.com 으로 이동합니다.

  2. 쿼리 빌더 를 클릭합니다.

  3. 다음 쿼리를 실행합니다.

    SELECT * FROM `JS Errors`
  4. 대시보드에 추가를 클릭합니다.

one.newrelic.com > Query builder : Query builder 를 사용하여 Cordova/Ionic 앱에서 JavaScript 오류를 추적하기 위한 사용자 지정 대시보드를 만듭니다.

대시보드를 시작하는 데 도움이 필요한 경우 대시 보드 소개 를 참조하세요.

기본 Cordova 속성

Cordova 플러그인은 다음 속성을 수집합니다.

기인하다

설명

appId

모니터링되는 앱의 고유 식별자입니다. 예: 35091 .

appBuild

충돌한 바이너리의 기술 빌드 번호를 나타냅니다. 개발자는 이 속성을 사용하여 앱의 어떤 빌드가 충돌했는지 정확히 확인할 수 있습니다.

appName

모니터링되는 앱의 이름입니다. 예를 들어, New Relic iOS .

appVersion

모니터링되는 앱의 버전 번호입니다. 예를 들어, 2.2.9 .

appVersionId

모니터링되는 앱의 New Relic 고유 버전 번호입니다.

architecture

armv7, arm64와 같은 장치의 프로세서 아키텍처.

asn

데이터가 보고될 때 장치와 연결된 자율 시스템 번호입니다.

asnOwner

ASN의 통신 소유자입니다.

carrier

WiFi , Verizon , Sprint 등과 같이 앱이 데이터를 전송한 모바일 네트워크입니다.

category

수집되는 데이터의 유형입니다. 표준 범주는 세션 , 상호 작용충돌 입니다. API를 통해 사용자 지정 이벤트를 추가한 경우 사용자 지정 범주를 사용합니다.

city

포틀랜드 또는 시애틀 과 같이 모니터링되는 앱이 있는 도시입니다.

countryCode

모니터링되는 앱이 있는 국가입니다. 예를 들어 영국의 경우 GB 입니다. 국가 코드 목록은 ISO 3166-1 alpha-2 를 참조하십시오.

crashException

충돌과 관련된 예외(있는 경우)입니다. 예: java.lang.NullPointerException .

crashMessage

충돌과 관련된 메시지(있는 경우).

device

iPad Air 또는 Galaxy S5 와 같은 기기의 이름입니다.

deviceGroup

iPod Touch 또는 iPad 와 같은 기기 카테고리입니다.

deviceManufacturer

장치 제조업체입니다. 예를 들어, 모토로라 또는 HTC .

deviceModel

장치의 모델 번호입니다. 예: XT1039 또는 SM-G900F .

interactionDuration

상호 작용이 장치에서 렌더링되는 총 시간(초)입니다. 렌더링 시간 외에도 여기에는 일반적으로 상호 작용과 관련된 모든 외부 호출이 포함됩니다.

install

TRUE 인 경우 이 세션은 앱을 새로 설치한 것입니다.

lastInteraction

충돌 이벤트 이전의 마지막 상호작용(있는 경우)입니다. 예를 들어 앱 실행 .

memUsageMb

애플리케이션에서 사용한 총 메모리 양(MB)입니다. 60초마다 업데이트됩니다.

name

이벤트와 연결된 상호 작용의 이름입니다. 예: ApplicationsListFragment 또는 NavigationDrawerFragment .

newRelicVersion

애플리케이션에서 실행 중인 에이전트의 버전 번호입니다. 예: 4.232.0 .

osMajorVersion

iOS 7.0.4 와 비교하여 iOS 7 과 같은 앱 호스트 운영 체제의 단순화된 버전 번호입니다.

osName

iOS 또는 Android 와 같은 앱의 호스트 운영 체제 이름입니다.

osVersion

iOS 7 과 비교한 iOS 7.0.4 와 같은 앱 호스트 운영 체제의 정확한 버전 번호입니다.

regionCode

모니터링되는 앱이 있는 국가 내의 특정 지역입니다. 미국에서 지역은 주입니다.

sessionDuration

사용자가 애플리케이션을 사용한 시간(초)입니다. 세션이 충돌하면 sessionDuration 가 캡처되지 않습니다(다른 이벤트 및 속성은 계속 기록됨).

10분보다 긴 세션의 경우 세션이 진행되는 동안 Interaction 및 Custom 이벤트 카테고리 의 이벤트가 New Relic으로 전송되므로 sessionDuration 속성이 없습니다. 세션이 끝날 무렵에 기록된 이벤트에는 세션 이벤트 범주와 마찬가지로 기간이 포함됩니다.

sessionId

단일 사용자 세션에 대한 고유 식별자입니다.

timeSinceLastInteraction

충돌 이벤트 이전의 상호작용 이후 경과된 시간(초)입니다.

timeSinceLoad

모바일 세션 시작부터 이벤트가 발생한 시간까지의 시간(초)입니다. 이벤트는 Session, Interaction 또는 Crash의 기본 제공 이벤트 카테고리일 수 있으며 에이전트 API를 통해 전송된 모든 사용자 정의 이벤트가 될 수 있습니다.

upgradeFrom

업그레이드가 감지되면 사용자가 업그레이드한 이전 버전의 버전 번호를 지정합니다. 예: 2.2.8 . 현재 버전 번호의 경우 version 속성을 사용합니다.

uuid

B8B0BC30-0235-11E4-9191-0800200C9A66 과 같이 특정 기기에 앱을 설치하기 위한 고유 식별자입니다.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.