아래 방법을 사용하여 기본 모바일 모니터링 설정을 변경하십시오. 에이전트 호출을 포함한 모든 설정은 MainActivity
클래스의 onCreate
메서드에서 호출됩니다.
설정을 변경하려면 두 가지 옵션이 있습니다(설정이 지원하는 경우).
각 특정 조건에 대해 자체 행에서 설정을 변경하십시오. 예를 들어:
NewRelic.disableFeature(FeatureFlag.DefaultInteractions);NewRelic.enableFeature(FeatureFlag.CrashReporting);NewRelic.withApplicationToken(<NEW_RELIC_TOKEN>).start(this.getApplication());또는
.with
메서드를 사용하여 에이전트 시작 호출의 일부로 설정을 변경합니다. 예를 들어:NewRelic.withApplicationToken(<NEW_RELIC_TOKEN>).withDefaultInteractions(false).withCrashReportingEnabled(true).start(this.getApplication());분석 설정
설명
예시
이벤트 데이터 수집을 활성화하거나 비활성화합니다. 이러한 이벤트는 NRQL로 쿼리하고 Crash analysis 페이지 에서 사용할 수 있습니다.
기본값은
true
입니다.withAnalyticsEvents(false)이벤트 데이터 보고를 활성화하거나 비활성화합니다. 이벤트 collection 은(는) 계속 발생하지만 해당 이벤트는 수집기로 전송되지 않습니다. 수집을 비활성화하고 싶지만 에이전트가 수집한 내용을 계속 볼 수 있는 경우
withAnalyticsEvents
대신 이를 사용하기로 결정할 수 있습니다.기본값은
true
입니다.FeatureFlag.AnalyticsEvents(true)앱 실행 시간 설정
설명
예시
메트릭 에 대한 보고 앱 시작 시간(콜드 및 핫 타임) 활성화 또는 비활성화:
콜드 스타트 시간은 앱이 처음부터 시작되는 것을 의미합니다. 이는 앱의 프로세스가 그때까지 시스템에 의해 생성되지 않았음을 의미합니다.
핫 시작 시간은 앱의 프로세스가 이미 백그라운드에서 실행 중인 시간을 나타냅니다.
기본값은
true
입니다.
FeatureFlag.AppStartMetrics(false)애플리케이션 설정
설명
예시
애플리케이션의 버전을 문자열로 설정합니다. 기본값은
AndroidManifest.xml
에 설정된 버전 번호입니다.withApplicationVersion("MY APP VERSION")빌드 버전을 문자열로 설정합니다. 기본값은
AndroidManifest.xml
에 설정된 빌드 ID입니다.withBuildVersion("MY BUILD VERSION")충돌 및 오류 보고 설정
설명
예시
지연된 충돌 보고를 활성화하거나 비활성화합니다. 기본값은
false
입니다.withCrashReportingEnabled(true)처리된 예외 페이지 에 표시되는 처리된 예외 이벤트 기록을 활성화하거나 비활성화합니다. 기본값은
true
입니다.FeatureFlag.HandledExceptions(false)충돌 분석 페이지 에 표시되는 기본 런타임 충돌, 예외 및 ANR(응용 프로그램 응답 없음) 조건의 기록을 활성화하거나 비활성화합니다. 기본값은
true
입니다.FeatureFlag.NativeReporting(false)분산 추적
설명
예시
네트워크 요청에 분산 추적 헤더 추가를 활성화하거나 비활성화합니다.
기본값은
true
입니다.모바일 앱의 분산 추적에 대한 자세한 내용 은 New Relic 분산 추적 작동 방식 을 참조하세요.
FeatureFlag.DistributedTracing(false)FedRamp 설정
설명
예시
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.
기본값은
true
입니다(에이전트 버전 6.11.0 기준).FeatureFlag.FedRampEnabled(false)상호작용 설정
설명
예시
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.
기본값은
true
입니다.FeatureFlag.InteractionTracing(false)기본 상호 작용을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 사용자 지정 상호 작용이 활성화된 상태로 유지되는 동안에만 기본 상호 작용이 활성화되거나 비활성화됩니다.
기본값은
true
입니다.FeatureFlag.DefaultInteractions(false)로깅 설정
설명
예시
에이전트 로깅을 활성화하거나 비활성화합니다.
기본값은
true
입니다.withLoggingEnabled(false)로그 수준을 지정합니다. 옵션에는 다음이 포함됩니다.
ERROR
(가장 장황하지 않음)WARN
INFO
VERBOSE
DEBUG
AUDIT
(가장 장황한)기본값은
INFO
입니다.
withLogLevel(AgentLog.ERROR)네트워킹 설정
설명
예시
MobileRequest 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.
기본값은
true
입니다(에이전트 버전 5.15.2 기준).FeatureFlag.NetworkRequests(false)MobileRequestError 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다. Android 에이전트 버전 5.11.0 이상에서 사용할 수 있습니다.
기본값은
true
입니다.FeatureFlag.NetworkErrorRequests(false)HTTP 오류 추적 및 MobileRequestError 이벤트에 대한 HTTP 응답 본문 캡처를 활성화하거나 비활성화합니다.
기본값은
true
입니다.FeatureFlag.HttpResponseBodyCaptureEnabled(false)오프라인 저장
설명
예시
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다.
오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.
오프라인 저장소는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
NewRelic.enableFeature(FeatureFlag.OfflineStorage)배경보고
설명
예시
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.
백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
NewRelic.enableFeature(FeatureFlag.BackgroundReporting)ApplicationExitInfo 보고
설명
예시
ApplicationExitInfo 보고를 활성화하거나 비활성화합니다.
ApplicationExitInfo 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
NewRelic.enableFeature(FeatureFlag.ApplicationExitReporting)
New Relic의 iOS 에이전트는 에이전트의 기본 동작을 변경하기 위한 구성 설정을 제공합니다. 기본 설정을 변경하는 경우 앱 토큰을 호출한 직후에 기능 플래그를 추가해야 합니다. 예를 들어:
목표-C:
+ [NewRelic startWithApplicationToken:]빠른:
NewRelic.start(withApplicationToken:)기능 플래그 활성화 또는 비활성화
기능 플래그를 구성하려면 에 정의된 다음 방법을 사용하십시오.
NewRelic.h:
iOS 언어
절차
오브젝티브-C
Objective-C에서 이러한 기능은 비트마스크되어 있으므로
|
를 사용하여 동시에 여러 기능을 활성화하거나 비활성화할 수 있습니다.기능 플래그 활성화:
+[NewRelic enableFeatures:(NRMAFeatureFlags)flags];기능 플래그 비활성화:
+[NewRelic disableFeatures:(NRMAFeatureFlags)flags];다음은 예입니다.
- 상호 작용 추적 및 실험적 네트워킹 계측이 활성화됩니다.
NSURLSession
계측 및 충돌 보고가 비활성화됩니다.
[NewRelic enableFeatures:NRFeatureFlag_SwiftInteractionTracing | NRFeatureFlag_FedRampEnabled];[NewRelic disableFeatures:NRFeatureFlag_NSURLSessionInstrumentation | NRFeatureFlag_CrashReporting];[NewRelic startWithApplicationToken:...];빠른
기능 플래그 활성화:
NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])기능 플래그 비활성화:
NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])기본 상호작용 추적을 비활성화하는 예:
NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions)데이터 끝점 설정
설명
예시
Crash analysis 페이지 에 표시되는 충돌 보고를 활성화 또는 비활성화합니다.
수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다. 이 엔드포인트는 처리된 예외 업로드에도 사용됩니다.
데이터 수집을 보고할 때 에이전트가 사용할 데이터 끝점을 바꾸려면
NewRelic.start(withApplicationToken:)
메서드 호출에andCollectorAddress:
추가하세요.기본값은
mobile-collector.newrelic.com
입니다.NewRelic.start(withApplicationToken:YOUR_APP_TOKENandCollectorAddress:"harvest-upload.domain.com"andCrashCollectorAddress:"crash-upload.domain.com");충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다.
비정상 종료를 보고할 때 에이전트가 사용할 데이터 엔드포인트를 바꾸려면
NewRelic.start(withApplicationToken:)
메서드 호출에andCrashCollectorAddress:
추가하세요.기본값은
mobile-crash.newrelic.com
입니다.NewRelic.start(withApplicationToken:YOUR_APP_TOKENandCollectorAddress:"harvest-upload.domain.com"andCrashCollectorAddress:"crash-upload.domain.com");충돌 및 오류 보고 기능 플래그
아래의 충돌 및 오류 보고 설정을 수정하는 경우 iOS 에이전트가 호출을 시작하기 전에 기능 플래그를 호출해야 합니다.
설명
예시
Crash analysis [충돌 분석] 페이지 에 표시되는 충돌 보고를 활성화하거나 비활성화합니다.
수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다. 이 엔드포인트는 처리된 예외 업로드에도 사용됩니다.
데이터 수집을 보고할 때 에이전트가 사용할 데이터 끝점을 바꾸려면
NewRelic.withApplicationToken()
메서드 호출에.usingCollectorAddress()
추가하세요.기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_CrashReporting)처리된 예외 페이지 에 표시되는 처리된 예외 이벤트 기록을 전역적으로 활성화하거나 비활성화합니다.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HandledExceptionEvents)분산 추적
설명
예시
네트워크 요청에 대한 분산 추적 헤더 추가를 활성화하거나 비활성화합니다. 모바일 앱의 분산 추적에 대한 자세한 내용은 New Relic 분산 추적 작동 방식을 참조하세요.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DistributedTracing)상호작용 기능 플래그
아래의 충돌 및 오류 보고 설정을 수정하는 경우 New Relic iOS 에이전트 시작 호출 직전에 기능 플래그를 호출해야 합니다.
설명
예시
기본 소스화된 클래스 및 메서드에 대해서만 캡슐화 추적을 활성화하거나 비활성화합니다. 맞춤 상호작용이 보고됩니다. The Traces는 Interactions 페이지 에 나타납니다.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions)Interactions 페이지 에 표시되는 상호작용 추적을 전역적으로 활성화하거나 비활성화합니다.
에이전트가 시작된 후에는 상호작용 추적이 비활성화됩니다. 에이전트를 시작하기 전에 실행된 활동이나 메소드에 대한 상호작용은 계속해서 Interactions 페이지에 나타날 수 있습니다.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_InteractionTracing)주의
이 기능을 활성화하기 전에 Swift 상호 작용 추적 활성화 를 참조하십시오. 적절한 조치를 취하지 않으면 이 기능을 활성화하면 불안정해질 수 있습니다.
Swift 코드에 대한 확장 결합 추적을 활성화하거나 비활성화합니다. 트레이스는 Interactions 페이지 에 나타납니다.
NRFeatureFlag_InteractionTracing
비활성화되면 이 기능은 항상 비활성화됩니다.기본값은
false
입니다.NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftInteractionTracing)자동 WKWebView 계측을 활성화하거나 비활성화합니다.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_WebViewInstrumentation)주의
이 기능은 더 이상 사용되지 않으므로 이 기능 플래그 호출을 활성화하면 애플리케이션의 안정성이 저하될 수 있습니다. New Relic에서 지시하지 않는 한 사용을 피하십시오.
자동 제스처 계측을 활성화하거나 비활성화합니다.
기본값은
false
입니다.NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_GestureInstrumentation)네트워킹 기능 플래그
아래 설정을 수정하는 경우 New Relic iOS 에이전트 시작 호출 전에 기능 플래그를 호출해야 합니다.
설명
예시
주의
이 기능은 더 이상 사용되지 않으므로 이 기능 플래그 호출을 활성화하면 애플리케이션의 안정성이 저하될 수 있습니다. New Relic에서 지시하지 않는 한 사용을 피하십시오.
실험적 네트워킹 계측을 활성화하거나 비활성화합니다. 이것은
NRMAURProtocol
을 통해 모든NSURLConnection
네트워크 요청을 강제합니다.기본값은
false
입니다.NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_ExperimentalNetworkingInstrumentation)NSURLSession
에 대한 네트워킹 계측을 활성화 또는 비활성화합니다. 이러한 URL 추적은 HTTP 요청 페이지로 전송됩니다.기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NSURLSessionInstrumentation)네트워킹 계측을 활성화하거나 비활성화합니다. 그러면 HTTP 응답 데이터가 MobileRequest 이벤트로 전송됩니다.
기본값은
true
입니다(에이전트 버전 6.0.0 기준).NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NetworkRequestEvents)오류 또는 실패를 초래하는 구성된 네트워크 호출의 HTTP 요청 오류 이벤트 생성을 활성화하거나 비활성화합니다. 이러한 이벤트는 MobileRequestError 이벤트로 보고됩니다.
기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_RequestErrorEvents)HTTP 오류 추적 및
MobileRequestError
이벤트에 대한 HTTP 응답 본문 캡처를 활성화 또는 비활성화합니다.기본값은
true
입니다.NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HttpResponseBodyCapture)async await URL 세션에 대한 계측을 활성화하거나 비활성화합니다.
기본값은
false
입니다(에이전트 버전 7.4.5 기준).NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftAsyncURLSessionSupport)앱 실행 시간 설정
설명
예시
메트릭으로 보고 앱 시작 시간(콜드 및 핫 타임)을 활성화 또는 비활성화합니다.
콜드 타임은 앱 시작과 첫 번째 추첨 사이의 시간을 나타냅니다.
핫 타임은 앱이 백그라운드에서 실행되고 첫 번째 그리기까지 재개되는 데 걸리는 시간을 나타냅니다.
기본값은
true
입니다(에이전트 버전 7.4.0 기준).
NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics)FedRAMP 끝점 설정
설명
예시
FedRAMP 엔드포인트를 사용하여 활성화 또는 비활성화합니다.
기본값은
false
입니다(에이전트 버전 7.4.5 기준).NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled)오프라인 저장
설명
예시
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.
오프라인 저장소는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_OfflineStorage)배경보고
설명
예시
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.
백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundReporting])백그라운드 계측을 사용하기 위한 iOS 앱 프로젝트의 전제 조건:
- 앱 번들 ID가 포함된 항목을 포함하여 다시와 함께 키
Permitted background task scheduler identifiers
(를) 추가하세요. - Xcode 프로젝트 기능의 Background Fetch [배경 모드] 섹션에서 Background Processing [배경 가져오기] 및 Background Modes [배경 처리를] 활성화합니다.
참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다.
Capacitor 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
import { NewRelicCapacitorPlugin, NREnums, AgentConfiguration } from '@newrelic/newrelic-capacitor-plugin';import { Capacitor } from '@capacitor/core';
var appToken;
if(Capacitor.getPlatform() === 'ios') { appToken = '<IOS-APP-TOKEN>';} else { appToken = '<ANDROID-APP-TOKEN>';}
let agentConfig : AgentConfiguration = {
analyticsEventEnabled: false, crashReportingEnabled: false, interactionTracingEnabled: false, networkRequestEnabled: false, networkErrorRequestEnabled: false, httpResponseBodyCaptureEnabled: false, loggingEnabled: false, logLevel: NREnums.LogLevel.INFO, webViewInstrumentation: false, collectorAddress: "", crashCollectorAddress: "", sendConsoleEvents: false, fedRampEnabled: false, offlineStorageEnabled: false}
NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration:agentConfig})
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다. |
|
충돌 보고를 활성화하거나 비활성화합니다. |
|
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다. |
|
|
|
|
|
HTTP 오류 추적 및 |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
(iOS 전용) |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다. |
|
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다. |
Cordova 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
# Disable Crash Reportingcordova 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"--variable OFFLINE_STORAGE_ENABLED="false"
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
충돌 보고를 활성화하거나 비활성화합니다. |
|
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다. |
|
|
|
|
|
HTTP 오류 추적 및 |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
(iOS 전용) |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다. |
|
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다. |
.NET MAUI 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
using NewRelic.MAUI.Plugin;...
public static MauiApp CreateMauiApp() { var builder = MauiApp.CreateBuilder(); builder .UseMauiApp<App>() .ConfigureFonts(fonts => { fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular"); fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold"); });
builder.ConfigureLifecycleEvents(AppLifecycle => { #if ANDROID AppLifecycle.AddAndroid(android => android .OnCreate((activity, savedInstanceState) => StartNewRelic())); #endif #if IOS
AppLifecycle.AddiOS(iOS => iOS.WillFinishLaunching((_,__) => { StartNewRelic(); return false; })); #endif }); return builder.Build(); }
private static void StartNewRelic() {
CrossNewRelic.Current.HandleUncaughtException();
// Set optional agent configuration // Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled // AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
if (DeviceInfo.Current.Platform == DevicePlatform.Android) { CrossNewRelic.Current.Start("<APP-TOKEN-HERE>"); // Start with optional agent configuration // CrossNewRelic.Current.Start("<APP-TOKEN-HERE>", agentConfig); } else if (DeviceInfo.Current.Platform == DevicePlatform.iOS) { CrossNewRelic.Current.Start("<APP-TOKEN-HERE>"); // Start with optional agent configuration // CrossNewRelic.Current.Start("<APP-TOKEN-HERE", agentConfig); } }
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다. |
|
충돌 보고를 활성화하거나 비활성화합니다. |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
|
|
|
|
플러그인 결합 추적을 활성화하거나 비활성화합니다. 트레이스 측정, 로그는 여전히 발생하지만 트레이스가 수집되지 않습니다. 이렇게 하면 기본 및 사용자 정의 블록결합이 비활성화됩니다. 기본적으로 거짓 |
|
WebView의 자동 측정을 활성화/비활성화합니다. |
|
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. |
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
|
Flutter 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
if (Platform.isAndroid) { appToken = AppConfig.androidToken;} else if (Platform.isIOS) { appToken = AppConfig.iOSToken;}
Config config = Config( accessToken: appToken, analyticsEventEnabled: false, networkErrorRequestEnabled: false, networkRequestEnabled: false, crashReportingEnabled: false, interactionTracingEnabled: false, httpResponseBodyCaptureEnabled: false, loggingEnabled: false, webViewInstrumentation: false, printStatementAsEventsEnabled: false, httpInstrumentationEnabled: false, offlineStorageEnabled: true);
// NewrelicMobile.instance.start(config, () {// runApp(MyApp());// });
runZonedGuarded(() async { WidgetsFlutterBinding.ensureInitialized(); FlutterError.onError = NewrelicMobile.onError; await NewrelicMobile.instance.startAgent(config); runApp(MyApp());}, (Object error, StackTrace stackTrace) { NewrelicMobile.instance.recordError(error, stackTrace);});
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다. |
|
충돌 보고를 활성화하거나 비활성화합니다. |
|
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다. |
|
|
|
|
|
HTTP 오류 추적 및 |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
(iOS 전용) |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다. |
React Native 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
import NewRelic from 'newrelic-react-native-agent';import * as appVersion from './package.json';import {Platform} from 'react-native';
let appToken;
if (Platform.OS === 'ios') { appToken = '<IOS-APP-TOKEN>'; } else { appToken = '<ANDROID-APP-TOKEN>'; }
const agentConfiguration = { Config config = Config( analyticsEventEnabled: false, crashReportingEnabled: false, interactionTracingEnabled: false, networkRequestEnabled: false, networkErrorRequestEnabled: false, httpResponseBodyCaptureEnabled: false, loggingEnabled: false, logLevel: NREnums.LogLevel.INFO, webViewInstrumentation: false, collectorAddress: "", crashCollectorAddress: "", sendConsoleEvents: false, fedRampEnabled: false, offlineStorageEnabled:false };
NewRelic.startAgent(appToken,agentConfiguration);NewRelic.setJSAppVersion(appVersion.version);AppRegistry.registerComponent(appName, () => App);
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다. |
|
충돌 보고를 활성화하거나 비활성화합니다. |
|
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다. |
|
|
|
|
|
HTTP 오류 추적 및 |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
(iOS 전용) |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다. |
|
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다. |
뉴렐릭은 Unity의 모바일 앱 모니터링을 위한 기본 설정을 제공합니다. 특정 요구 사항에 맞게 Unity 편집기 내에서 이러한 설정을 쉽게 조정할 수 있습니다.
이러한 설정을 구성하려면:
Xamarin 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.
기본 설정을 변경하는 경우 appToken
호출한 직후에 기능 플래그를 추가해야 합니다.
샘플 구성은 다음과 같습니다.
public App () { InitializeComponent();
MainPage = new MainPage(); Application.Current.PageAppearing += OnPageAppearing; Application.Current.PageDisappearing += PageDisappearing;
CrossNewRelicClient.Current.HandleUncaughtException(); CrossNewRelicClient.Current.TrackShellNavigatedEvents();
// Set optional agent configuration // Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled,webViewInstrumentation, fedRampEnabled, offlineStorageEnabled AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled: false, offlineStorageEnabled: false);
if (Device.RuntimePlatform == Device.Android) { //CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE>"); // Start with optional agent configuration CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE", agentConfig); } else if (Device.RuntimePlatform == Device.iOS) { //CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE>"); // Start with optional agent configuration CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE", agentConfig); } } }
사용 가능한 구성 [#configurations]
설명 | 예시 |
---|---|
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다. |
|
충돌 보고를 활성화하거나 비활성화합니다. |
|
에이전트 로깅을 활성화하거나 비활성화합니다. |
|
|
|
|
|
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 |
|
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오. |
|
플러그인 결합 추적을 활성화하거나 비활성화합니다. 트레이스 측정, 로그는 여전히 발생하지만 트레이스가 수집되지 않습니다. 이렇게 하면 기본 및 사용자 정의 블록결합이 비활성화됩니다. 기본적으로 거짓 |
|
WebView의 자동 측정을 활성화/비활성화합니다. |
|
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. |
|
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요. | 오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오.
|
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다. | 백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.
백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다.
|