Cordova 모바일 애플리케이션 모니터링

New Relic Cordova 에이전트는 Cordova 모바일 앱을 모니터링하고 앱 성능, 오류 및 사용자 경험에 대한 깊은 통찰력을 제공합니다. 에이전트에는 기본 모바일 앱에 제공되는 모든 New Relic 모바일 모니터링 기능이 포함되어 있습니다. Cordova 에이전트를 설치하고 구성하면 다음을 수행할 수 있습니다.

JavaScript 오류 캡처 문제를 빠르게 식별하고 수정합니다.
네트워크 요청 추적: 앱이 백엔드와 상호 작용하는 방식을 확인합니다.
분산 추적 사용: 처리된 예외로 드릴다운하고 근본 원인을 찾습니다.
사용자 지정 이벤트 및 지표 생성: 사용자가 앱과 상호 작용하는 방식을 이해합니다.

호환성 요구 사항

Cordova 에이전트를 설치하기 전에 앱이 다음 요구사항을 충족하는지 확인하십시오.

코르도바 7.x 이상
Node.js 6.0 이상
코르도바 CLI 도구
프로젝트를 위한 Android 또는 iOS Cordova 플랫폼
모바일 애플리케이션 토큰

Cordova 에이전트 설치

Cordova 에이전트를 설치하려면 UI에 직접 있는 설치 안내를 따르십시오.

에이전트를 수동으로 설치해야 하는 경우 다음 단계를 따르세요.

Step 1 of 5

애플리케이션 토큰 만들기

one.newrelic.com > Browser & Mobile > (Android 또는 iOS 선택) 로 이동한 다음 UI에서 계측 단계를 완료하세요.
UI의 Step 4 [4단계] 에서 애플리케이션 토큰(해당되는 경우 iOS 및 Android용 토큰)을 복사합니다.

Step 2 of 5

Cordova 에이전트 추가

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}"

Step 3 of 5

(선택 사항) 에이전트 구성

에이전트 시작 시 호출되는 다음 선택적 구성을 --variable 인수에 추가합니다.

CRASH_REPORTING_ENABLED: 충돌 보고를 활성화 또는 비활성화합니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
DISTRIBUTED_TRACING_ENABLED: 네트워크 요청에 대한 분산 추적 헤더 추가를 활성화 또는 비활성화합니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
INTERACTION_TRACING_ENABLED: 상호 작용 추적을 활성화 또는 비활성화합니다. 추적 계측은 여전히 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
DEFAULT_INTERACTIONS_ENABLED: 기본 상호 작용을 활성화하거나 비활성화합니다. 추적 계측은 여전히 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 사용자 지정 상호 작용이 활성화된 상태로 유지되는 동안에만 기본 상호 작용이 활성화 또는 비활성화됩니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
LOGGING_ENABLED: 에이전트 로깅을 활성화 또는 비활성화합니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
LOG_LEVEL: 로그 수준을 지정합니다.
- 가능한 값은 ERROR (가장 자세한 정보 없음), WARNING INFO, VERBOSE, DEBUG, AUDIT (가장 자세한 정보 표시)입니다.
- 기본값은 Android에서는 INFO 이고 iOS에서는 WARNING .
WEB_VIEW_INSTRUMENTATION (iOS 전용): 자동 WKWebView 계측을 활성화(기본값)하거나 비활성화합니다.
- 가능한 값은 true 및 false입니다. 기본값은 true입니다.
COLLECTOR_ADDRESS: 수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다.
CRASH_COLLECTOR_ADDRESS: 충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다.
FEDRAMP_ENABLED: 미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.
- 가능한 값은 true 및 false입니다. 기본값은 false입니다.
이러한 옵션은 Cordova 에이전트 v6.2.1 이상에서만 사용할 수 있습니다.
예를 들어 충돌 보고를 비활성화하려면 다음을 호출하세요.
```
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}" --variable CRASH_REPORTING_ENABLED="false"
```

Step 4 of 5

(Ionic Cordova에만 해당) Ionic 프레임워크 구성

ionic 프레임워크를 사용하는 경우 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

Step 5 of 5

앱 배포

그런 다음 앱을 배포합니다. 앱 활동이 끝나면 New Relic에 데이터가 표시됩니다(앱을 배포한 후 몇 분 정도 걸릴 수 있음).

에이전트 계측 사용자 지정

에이전트 계측을 사용자 정의해야 합니까? 공개 모바일 SDK API 방법을 사용하면 사용자 지정 데이터를 수집하고 기본 설정을 구성하는 등의 작업을 수행할 수 있습니다.

다음 사용자 지정은 Cordova 에이전트에 사용할 수 있습니다.

원하는 경우...	이 방법을 사용하십시오
충돌 문제 해결에 도움이 될 수 있는 앱 활동을 추적하기 위해 이동 경로를 기록합니다.	이동 경로 기록
메서드를 상호 작용으로 추적합니다.	상호 작용 시작 상호 작용 중지
오류 기록	오류 기록
맞춤 측정항목을 기록합니다.	맞춤 측정항목 기록
사용자 지정 속성 및 이벤트를 기록합니다.	사용자 정의 속성 및 이벤트를 보고하는 방법에는 여러 가지가 있습니다. 사용자 정의 속성 기록 증가 세션 속성 수 속성 제거 모든 속성 제거 맞춤 이벤트 기록 이벤트 풀의 최대 크기 설정 에이전트가 메모리에 이벤트를 저장하는 최대 시간 설정 현재 세션의 ID 얻기 이벤트 및 속성과 연결할 사용자 정의 사용자 ID 설정 사용하기에 가장 좋은 방법과 그 이유에 대한 자세한 내용은 사용자 지정 데이터 추가 를 참조하십시오.
사용자 지정 네트워크 요청 및 실패를 추적합니다.	HTTP 요청 추적 실패한 HTTP 요청 추적
에이전트를 종료합니다.	에이전트를 종료합니다.
기본 모바일 모니터링 설정을 활성화/비활성화합니다.	모니터링 기능 활성화/비활성화
테스트 충돌 보고서를 실행합니다.	충돌 보고 테스트

에이전트 업데이트

Cordova 에이전트 버전을 업데이트하려면 다음 간단한 명령을 실행하십시오.

cordova plugin update

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.