모바일 모니터링 설정 구성

아래 방법을 사용하여 기본 모바일 모니터링 설정을 변경하십시오. 에이전트 호출을 포함한 모든 설정은 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());

데이터 끝점 설정

설명	예시
Crash analysis 페이지 에 표시되는 충돌 보고를 활성화 또는 비활성화합니다. 수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다. 이 엔드포인트는 처리된 예외 업로드에도 사용됩니다. 데이터 수집을 보고할 때 에이전트가 사용할 데이터 끝점을 바꾸려면 `NewRelic.withApplicationToken(“<TOKEN>”)` 메서드 호출에 `andCollectorAddress:` 추가하세요. 기본값은 `mobile-collector.newrelic.com` 입니다.	`NewRelic.withApplicationToken(“<TOKEN>”) .usingCollectorAddress("harvest-upload.domain.com") .usingCrashCollectorAddress("crash-upload.domain.com")`
충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다. 비정상 종료를 보고할 때 에이전트가 사용할 데이터 엔드포인트를 바꾸려면 `NewRelic.withApplicationToken(“<TOKEN>”)` 메서드 호출에 `andCrashCollectorAddress:` 추가하세요. 기본값은 `mobile-crash.newrelic.com` 입니다.	`NewRelic.withApplicationToken(“<TOKEN>”) .usingCollectorAddress("harvest-upload.domain.com") .usingCrashCollectorAddress("crash-upload.domain.com")`

설명

예시

Crash analysis 페이지 에 표시되는 충돌 보고를 활성화 또는 비활성화합니다.

수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다. 이 엔드포인트는 처리된 예외 업로드에도 사용됩니다.

데이터 수집을 보고할 때 에이전트가 사용할 데이터 끝점을 바꾸려면 NewRelic.withApplicationToken(“<TOKEN>”) 메서드 호출에 andCollectorAddress: 추가하세요.

기본값은 mobile-collector.newrelic.com 입니다.

NewRelic.withApplicationToken(“<TOKEN>”)
        .usingCollectorAddress("harvest-upload.domain.com")
        .usingCrashCollectorAddress("crash-upload.domain.com")

충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다.

비정상 종료를 보고할 때 에이전트가 사용할 데이터 엔드포인트를 바꾸려면 NewRelic.withApplicationToken(“<TOKEN>”) 메서드 호출에 andCrashCollectorAddress: 추가하세요.

기본값은 mobile-crash.newrelic.com 입니다.

NewRelic.withApplicationToken(“<TOKEN>”)
        .usingCollectorAddress("harvest-upload.domain.com")
        .usingCrashCollectorAddress("crash-upload.domain.com")

분석 설정

설명	예시
이벤트 데이터 수집을 활성화하거나 비활성화합니다. 이러한 이벤트는 NRQL로 쿼리하고 Crash analysis 페이지 에서 사용할 수 있습니다. 기본값은 `true` 입니다.	`withAnalyticsEvents(false)`
이벤트 데이터 보고를 활성화하거나 비활성화합니다. 이벤트 collection 은(는) 계속 발생하지만 해당 이벤트는 수집기로 전송되지 않습니다. 수집을 비활성화하고 싶지만 에이전트가 수집한 내용을 계속 볼 수 있는 경우 `withAnalyticsEvents` 대신 이를 사용하기로 결정할 수 있습니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.AnalyticsEvents) NewRelic.disableFeature(FeatureFlag.AnalyticsEvents)`

설명

예시

이벤트 데이터 수집을 활성화하거나 비활성화합니다. 이러한 이벤트는 NRQL로 쿼리하고 Crash analysis 페이지 에서 사용할 수 있습니다.

기본값은 true 입니다.

withAnalyticsEvents(false)

이벤트 데이터 보고를 활성화하거나 비활성화합니다. 이벤트 collection 은(는) 계속 발생하지만 해당 이벤트는 수집기로 전송되지 않습니다. 수집을 비활성화하고 싶지만 에이전트가 수집한 내용을 계속 볼 수 있는 경우 withAnalyticsEvents 대신 이를 사용하기로 결정할 수 있습니다.

기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.AnalyticsEvents)
NewRelic.disableFeature(FeatureFlag.AnalyticsEvents)

앱 실행 시간 설정

설명	예시
메트릭 에 대한 보고 앱 시작 시간(콜드 및 핫 타임) 활성화 또는 비활성화: 콜드 스타트 시간은 앱이 처음부터 시작되는 것을 의미합니다. 이는 앱의 프로세스가 그때까지 시스템에 의해 생성되지 않았음을 의미합니다. 핫 시작 시간은 앱의 프로세스가 이미 백그라운드에서 실행 중인 시간을 나타냅니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.AppStartMetrics) NewRelic.disableFeature(FeatureFlag.AppStartMetrics)`

설명

예시

메트릭 에 대한 보고 앱 시작 시간(콜드 및 핫 타임) 활성화 또는 비활성화:

콜드 스타트 시간은 앱이 처음부터 시작되는 것을 의미합니다. 이는 앱의 프로세스가 그때까지 시스템에 의해 생성되지 않았음을 의미합니다.
핫 시작 시간은 앱의 프로세스가 이미 백그라운드에서 실행 중인 시간을 나타냅니다.
기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.AppStartMetrics)
NewRelic.disableFeature(FeatureFlag.AppStartMetrics)

애플리케이션 설정

설명	예시
애플리케이션의 버전을 문자열로 설정합니다. 기본값은 `AndroidManifest.xml` 에 설정된 버전 번호입니다.	`withApplicationVersion("MY APP VERSION")`
빌드 버전을 문자열로 설정합니다. 기본값은 `AndroidManifest.xml` 에 설정된 빌드 ID입니다.	`withApplicationBuild("MY BUILD VERSION")`

배경보고

설명	예시
애플리케이션이 백그라운드 상태로 전환될 때 백그라운드 보고를 활성화하거나 비활성화합니다. 이 기능을 활성화하면 에이전트는 앱이 백그라운드에 있는 동안 캡처된 데이터를 보고하고,`background` 속성이 세션 속성에 추가됩니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `NewRelic.enableFeature(FeatureFlag.BackgroundReporting) NewRelic.disableFeature(FeatureFlag.BackgroundReporting)`

충돌 및 오류 보고 설정

설명	예시
지연된 충돌 보고를 활성화하거나 비활성화합니다. 기본값은 `false` 입니다.	`withCrashReportingEnabled(true)`
처리된 예외 페이지 에 표시되는 처리된 예외 이벤트 기록을 활성화하거나 비활성화합니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.HandledExceptions) NewRelic.disableFeature(FeatureFlag.HandledExceptions)`
충돌 분석 페이지 에 표시되는 기본 런타임 충돌, 예외 및 ANR(응용 프로그램 응답 없음) 조건의 기록을 활성화하거나 비활성화합니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.NativeReporting) NewRelic.disableFeature(FeatureFlag.NativeReporting)`

분산 추적

설명	예시
네트워크 요청에 분산 추적 헤더 추가를 활성화하거나 비활성화합니다. 기본값은 `true` 입니다. 모바일 앱의 분산 추적에 대한 자세한 내용 은 New Relic 분산 추적 작동 방식 을 참조하세요.	`NewRelic.enableFeature(FeatureFlag.DistributedTracing) NewRelic.disableFeature(FeatureFlag.DistributedTracing)`

설명

예시

네트워크 요청에 분산 추적 헤더 추가를 활성화하거나 비활성화합니다.

기본값은 true 입니다.

모바일 앱의 분산 추적에 대한 자세한 내용 은 New Relic 분산 추적 작동 방식 을 참조하세요.

NewRelic.enableFeature(FeatureFlag.DistributedTracing)
NewRelic.disableFeature(FeatureFlag.DistributedTracing)

이벤트 지속성

설명	예시
에이전트가 강제 종료 및 프로세스 종료 시나리오 중에 이벤트를 캡처할 수 있도록 하는 이벤트 지속성을 활성화하거나 비활성화합니다.	이벤트 지속성은 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오: `NewRelic.disableFeature(FeatureFlag.EventPersistence) NewRelic.enableFeature(FeatureFlag.EventPersistence)`

FedRamp 설정

설명	예시
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다. 기본값은 `true` 입니다(에이전트 버전 6.11.0 기준).	`NewRelic.enableFeature(FeatureFlag.FedRampEnabled) NewRelic.disableFeature(FeatureFlag.FedRampEnabled)`

설명

예시

미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.

기본값은 true 입니다(에이전트 버전 6.11.0 기준).

NewRelic.enableFeature(FeatureFlag.FedRampEnabled)
NewRelic.disableFeature(FeatureFlag.FedRampEnabled)

상호작용 설정

설명	예시
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.InteractionTracing) NewRelic.disableFeature(FeatureFlag.InteractionTracing)`
기본 상호 작용을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 사용자 지정 상호 작용이 활성화된 상태로 유지되는 동안에만 기본 상호 작용이 활성화되거나 비활성화됩니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.DefaultInteractions) NewRelic.disableFeature(FeatureFlag.DefaultInteractions)`

설명

예시

상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.

기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.InteractionTracing)
NewRelic.disableFeature(FeatureFlag.InteractionTracing)

기본 상호 작용을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 사용자 지정 상호 작용이 활성화된 상태로 유지되는 동안에만 기본 상호 작용이 활성화되거나 비활성화됩니다.

기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.DefaultInteractions)
NewRelic.disableFeature(FeatureFlag.DefaultInteractions)

로깅 설정

설명	예시
에이전트 로깅을 활성화하거나 비활성화합니다. 기본값은 `true` 입니다.	`withLoggingEnabled(false)`
로그 수준을 지정합니다. 옵션에는 다음이 포함됩니다. `ERROR` (가장 장황하지 않음) `WARN` `INFO` `VERBOSE` `DEBUG` `AUDIT` (가장 장황한) 기본값은 `INFO` 입니다.	`withLogLevel(AgentLog.ERROR)`

설명

예시

에이전트 로깅을 활성화하거나 비활성화합니다.

기본값은 true 입니다.

withLoggingEnabled(false)

로그 수준을 지정합니다. 옵션에는 다음이 포함됩니다.

ERROR (가장 장황하지 않음)
WARN
INFO
VERBOSE
DEBUG
AUDIT (가장 장황한)
기본값은 INFO 입니다.

withLogLevel(AgentLog.ERROR)

네트워킹 설정

설명	예시
MobileRequest 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다. 기본값은 `true` 입니다(에이전트 버전 5.15.2 기준).	`NewRelic.enableFeature(FeatureFlag.NetworkRequests) NewRelic.disableFeature(FeatureFlag.NetworkRequests)`
MobileRequestError 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다. Android 에이전트 버전 5.11.0 이상에서 사용할 수 있습니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.NetworkErrorRequests) NewRelic.disableFeature(FeatureFlag.NetworkErrorRequests)`
HTTP 오류 추적 및 MobileRequestError 이벤트에 대한 HTTP 응답 본문 캡처를 활성화하거나 비활성화합니다. 기본값은 `true` 입니다.	`NewRelic.enableFeature(FeatureFlag.HttpResponseBodyCaptureEnabled) NewRelic.disableFeature(FeatureFlag.HttpResponseBodyCaptureEnabled)`

설명

예시

MobileRequest 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.

기본값은 true 입니다(에이전트 버전 5.15.2 기준).

NewRelic.enableFeature(FeatureFlag.NetworkRequests)
NewRelic.disableFeature(FeatureFlag.NetworkRequests)

MobileRequestError 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다. Android 에이전트 버전 5.11.0 이상에서 사용할 수 있습니다.

기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.NetworkErrorRequests)
NewRelic.disableFeature(FeatureFlag.NetworkErrorRequests)

HTTP 오류 추적 및 MobileRequestError 이벤트에 대한 HTTP 응답 본문 캡처를 활성화하거나 비활성화합니다.

기본값은 true 입니다.

NewRelic.enableFeature(FeatureFlag.HttpResponseBodyCaptureEnabled)
NewRelic.disableFeature(FeatureFlag.HttpResponseBodyCaptureEnabled)

오프라인 저장

설명	예시
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `NewRelic.enableFeature(FeatureFlag.OfflineStorage) NewRelic.disableFeature(FeatureFlag.OfflineStorage)`

설명

예시

인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다.

오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.

오프라인 저장소는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.

NewRelic.enableFeature(FeatureFlag.OfflineStorage)
NewRelic.disableFeature(FeatureFlag.OfflineStorage)

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)`

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_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com");`
충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다. 비정상 종료를 보고할 때 에이전트가 사용할 데이터 엔드포인트를 바꾸려면 `NewRelic.start(withApplicationToken:)` 메서드 호출에 `andCrashCollectorAddress:` 추가하세요. 기본값은 `mobile-crash.newrelic.com` 입니다.	`NewRelic.start(withApplicationToken:YOUR_APP_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com");`

설명

예시

Crash analysis 페이지 에 표시되는 충돌 보고를 활성화 또는 비활성화합니다.

수집 데이터 업로드 끝점의 URI 기관 구성 요소를 지정합니다. 이 엔드포인트는 처리된 예외 업로드에도 사용됩니다.

데이터 수집을 보고할 때 에이전트가 사용할 데이터 끝점을 바꾸려면 NewRelic.start(withApplicationToken:) 메서드 호출에 andCollectorAddress: 추가하세요.

기본값은 mobile-collector.newrelic.com 입니다.

NewRelic.start(withApplicationToken:YOUR_APP_TOKEN
        andCollectorAddress:"harvest-upload.domain.com"
        andCrashCollectorAddress:"crash-upload.domain.com");

충돌 데이터 업로드 URI의 권한 구성 요소를 지정합니다.

비정상 종료를 보고할 때 에이전트가 사용할 데이터 엔드포인트를 바꾸려면 NewRelic.start(withApplicationToken:) 메서드 호출에 andCrashCollectorAddress: 추가하세요.

기본값은 mobile-crash.newrelic.com 입니다.

NewRelic.start(withApplicationToken:YOUR_APP_TOKEN
      andCollectorAddress:"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)`

설명

예시

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 분산 추적 작동 방식을 참조하세요.

기본값은 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)`
비동기 대기 URL 세션에 대한 측정, 로그를 활성화하거나 비활성화합니다. 기본값은 `false` 입니다(에이전트 버전 7.4.5 기준).	`NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftAsyncURLSessionSupport)`

앱 실행 시간 설정

설명	예시
메트릭으로 보고 앱 시작 시간(콜드 및 핫 타임)을 활성화 또는 비활성화합니다. 콜드 타임은 앱 시작과 첫 번째 추첨 사이의 시간을 나타냅니다. 핫 타임은 앱이 백그라운드에서 실행되고 첫 번째 그리기까지 재개되는 데 걸리는 시간을 나타냅니다. 기본값은 `true` 입니다(에이전트 버전 7.4.0 기준). iOS의 AppLaunch/Cold Response는 일반적인 정의에서 제시하는 것보다 더 엄격한 제한을 두고 있습니다. 다음과 같은 특정 기준이 충족된 후에만 한 번 보고됩니다. 기기 재부팅 후: iOS 기기를 재부팅해야 합니다. 그 후 메트릭이 보고되도록 구성합니다. 신규 설치 후: iOS 구성을 새로 설치한 후 설치해야 합니다. 일회성 보고: 이 보고는 일반적으로 앱이 종료되었다가 다시 시작될 때마다 수신되는 것이 아니라, 특정 이벤트가 발생한 후 한 번만 수신됩니다.	`NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics)`

설명

예시

메트릭으로 보고 앱 시작 시간(콜드 및 핫 타임)을 활성화 또는 비활성화합니다.

콜드 타임은 앱 시작과 첫 번째 추첨 사이의 시간을 나타냅니다.
핫 타임은 앱이 백그라운드에서 실행되고 첫 번째 그리기까지 재개되는 데 걸리는 시간을 나타냅니다.
기본값은 true 입니다(에이전트 버전 7.4.0 기준).
iOS의 AppLaunch/Cold Response는 일반적인 정의에서 제시하는 것보다 더 엄격한 제한을 두고 있습니다. 다음과 같은 특정 기준이 충족된 후에만 한 번 보고됩니다.
- 기기 재부팅 후: iOS 기기를 재부팅해야 합니다. 그 후 메트릭이 보고되도록 구성합니다.
- 신규 설치 후: iOS 구성을 새로 설치한 후 설치해야 합니다.
- 일회성 보고: 이 보고는 일반적으로 앱이 종료되었다가 다시 시작될 때마다 수신되는 것이 아니라, 특정 이벤트가 발생한 후 한 번만 수신됩니다.

NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics)

FedRAMP 끝점 설정

설명	예시
FedRAMP 엔드포인트를 사용하여 활성화 또는 비활성화합니다. 기본값은 `false` 입니다(에이전트 버전 7.4.5 기준).	`NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled)`

설명

예시

FedRAMP 엔드포인트를 사용하여 활성화 또는 비활성화합니다.

기본값은 false 입니다(에이전트 버전 7.4.5 기준).

NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled)

오프라인 저장

설명	예시
인터넷 연결이 없을 때 오프라인 데이터 저장을 활성화 또는 비활성화합니다. 앱이 인터넷에 연결할 수 없는 동안 이벤트가 추가되면 해당 이벤트에 `offline` 속성이 추가됩니다. 오프라인 저장 용량을 구성하려면 최대 오프라인 저장 용량 설정하기를 참조하세요.	오프라인 저장소는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_OfflineStorage)`

배경보고

설명	예시
애플리케이션이 백그라운드 상태로 전환될 때 백그라운드 보고를 활성화하거나 비활성화합니다. 이 기능을 활성화하면 에이전트는 앱이 백그라운드에 있는 동안 캡처된 데이터를 보고하고,`background` 속성이 세션 속성에 추가됩니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundReporting])` 백그라운드 계측을 사용하기 위한 iOS 앱 프로젝트의 전제 조건: 앱 번들 ID가 포함된 항목을 포함하여 다시와 함께 키 `Permitted background task scheduler identifiers` (를) 추가하세요. Xcode 프로젝트 기능의 Background Fetch [배경 모드] 섹션에서 Background Processing [배경 가져오기] 및 Background Modes [배경 처리를] 활성화합니다. 참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다.

설명

예시

애플리케이션이 백그라운드 상태로 전환될 때 백그라운드 보고를 활성화하거나 비활성화합니다. 이 기능을 활성화하면 에이전트는 앱이 백그라운드에 있는 동안 캡처된 데이터를 보고하고,background 속성이 세션 속성에 추가됩니다.

백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오.

NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundReporting])

백그라운드 계측을 사용하기 위한 iOS 앱 프로젝트의 전제 조건:

앱 번들 ID가 포함된 항목을 포함하여 다시와 함께 키 Permitted background task scheduler identifiers (를) 추가하세요.
Xcode 프로젝트 기능의 Background Fetch [배경 모드] 섹션에서 Background Processing [배경 가져오기] 및 Background Modes [배경 처리를] 활성화합니다.

참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다.

자동 로그 수집

설명	예시
원격 로깅에 대한 `stdout` 및 `stderr` 수집을 활성화하거나 비활성화합니다.	로그 수집은 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하세요. `NewRelic.disableFeatures([NRMAFeatureFlags.NRFeatureFlag_AutoCollectLogs])` 자세한 내용은 iOS 에이전트 로깅을 참조하세요.

설명

예시

원격 로깅에 대한 stdout 및 stderr 수집을 활성화하거나 비활성화합니다.

로그 수집은 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하세요.

NewRelic.disableFeatures([NRMAFeatureFlags.NRFeatureFlag_AutoCollectLogs])

자세한 내용은 iOS 에이전트 로깅을 참조하세요.

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

사용 가능한 구성

설명	예시
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다.	`analyticsEventEnabled: true`
충돌 보고를 활성화하거나 비활성화합니다.	`crashReportingEnabled: true`
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.	`interactionTracingEnabled: true`
`MobileRequest` 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.	`networkRequestEnabled: true`
`MobileRequestError` 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다.	`networkErrorRequestEnabled: true`
HTTP 오류 추적 및 `MobileRequestError` 이벤트에 대한 HTTP 응답 본문 캡처를 활성화 또는 비활성화합니다.	`httpResponseBodyCaptureEnabled: true`
에이전트 로깅을 활성화하거나 비활성화합니다.	`loggingEnabled: true`
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 `ERROR` (가장 자세한 정보 없음), `WARNING`, `INFO`, `VERBOSE`, `AUDIT` (가장 자세한 정보 표시)가 포함됩니다.	`logLevel: NREnums.LogLevel.INFO`
(iOS 전용) `WebViews` 의 자동 계측을 활성화/비활성화합니다.	`webViewInstrumentation: true`
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`collectorAddress: "crash-upload-delegate.domain.com"`
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`crashCollectorAddress: "crash-upload-delegate.domain.com"`
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다.	`sendConsoleEvents: true`
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.	`fedRampEnabled: false`
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오. `offlineStorageEnabled: false`
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `backgroundReportingEnabled: true` 백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다. 앱의 `Info.plist` 파일에 '허용된 백그라운드 작업 스케줄러 식별자' 키를 추가하세요. 이 키는 앱의 번들 제외인 단일 문자열 값을 포함하는 제외여야 합니다. Xcode 프로젝트 기능의 Background Modes 섹션에서 Background Fetch 및 Background Process 를 활성화하세요. 참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다.

Cordova 에이전트 SDK를 사용하면 기본 설정을 구성하여 에이전트의 동작을 변경할 수 있습니다.

기본 설정을 변경하는 경우 appToken 호출한 직후에 기능 플래그를 추가해야 합니다.

샘플 구성은 다음과 같습니다.

bash

$# Disable Crash Reporting
$cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git
$  --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN"
$  --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"
$  --variable CRASH_REPORTING_ENABLED="false"
$  --variable OFFLINE_STORAGE_ENABLED="false"

사용 가능한 구성

설명	예시
충돌 보고를 활성화하거나 비활성화합니다.	bash `$CRASH_REPORTING_ENABLED = "true"`
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.	bash `$INTERACTION_TRACING_ENABLED = "true"`
`MobileRequest` 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.	`networkRequestEnabled: true`
`MobileRequestError` 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다.	`networkErrorRequestEnabled: true`
HTTP 오류 추적 및 `MobileRequestError` 이벤트에 대한 HTTP 응답 본문 캡처를 활성화 또는 비활성화합니다.	`httpResponseBodyCaptureEnabled: true`
에이전트 로깅을 활성화하거나 비활성화합니다.	bash `$LOGGING_ENABLED = "true"`
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 `ERROR` (가장 자세한 정보 없음), `WARNING`, `INFO`, `VERBOSE`, `AUDIT` (가장 자세한 정보 표시)가 포함됩니다.	bash `$LOG_LEVEL = "INFO"`
(iOS 전용) `WebViews` 의 자동 계측을 활성화/비활성화합니다.	bash `$WEB_VIEW_INSTRUMENTATION = "true"`
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	bash `$COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"`
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	bash `$CRASH_COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"`
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다.	`sendConsoleEvents: true`
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.	bash `$FEDRAMP_ENABLED = "false"`
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오. bash `$OFFLINE_STORAGE_ENABLED = "false"`
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. bash `$BACKGROUND_REPORTING_ENABLED = "true"` 백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다. 앱의 `Info.plist` 파일에 '허용된 백그라운드 작업 스케줄러 식별자' 키를 추가하세요. 이 키는 앱의 번들 제외인 단일 문자열 값을 포함하는 제외여야 합니다. Xcode 프로젝트 기능의 Background Modes 섹션에서 Background Fetch 및 Background Process 를 활성화하세요. 참고: 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);
  }
}

사용 가능한 구성

설명	예시
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다.	`analyticsEventEnabled: true`
충돌 보고를 활성화하거나 비활성화합니다.	`crashReportingEnabled: true`
에이전트 로깅을 활성화하거나 비활성화합니다.	`loggingEnabled: true`
`MobileRequest` 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.	`networkRequestEnabled: true`
`MobileRequestError` 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다.	`networkErrorRequestEnabled: true`
플러그인 결합 추적을 활성화하거나 비활성화합니다. 트레이스 측정, 로그는 여전히 발생하지만 트레이스가 수집되지 않습니다. 이렇게 하면 기본 및 사용자 정의 블록결합이 비활성화됩니다. 기본적으로 거짓	`interactionTracingEnabled: false`
WebView의 자동 측정을 활성화/비활성화합니다.	`webViewInstrumentation: false`
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.	`fedRampEnabled: false`
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 `ERROR` (가장 자세한 정보 없음), `WARNING`, `INFO`, `VERBOSE`, `AUDIT` (가장 자세한 정보 표시)가 포함됩니다.	`logLevel: NREnums.LogLevel.INFO`
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`collectorAddress: "crash-upload-delegate.domain.com"`
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`crashCollectorAddress: "crash-upload-delegate.domain.com"`
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오. `offlineStorageEnabled: false`
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `backgroundReportingEnabled: true` 백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다. 앱의 `Info.plist` 파일에 '허용된 백그라운드 작업 스케줄러 식별자' 키를 추가하세요. 이 키는 앱의 번들 제외인 단일 문자열 값을 포함하는 제외여야 합니다.

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);
});

사용 가능한 구성

설명	예시
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다.	`analyticsEventEnabled: true`
충돌 보고를 활성화하거나 비활성화합니다.	`crashReportingEnabled: true`
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.	`interactionTracingEnabled: true`
`MobileRequest` 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.	`networkRequestEnabled: true`
`MobileRequestError` 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다.	`networkErrorRequestEnabled: true`
HTTP 오류 추적 및 `MobileRequestError` 이벤트에 대한 HTTP 응답 본문 캡처를 활성화 또는 비활성화합니다.	`httpResponseBodyCaptureEnabled: true`
에이전트 로깅을 활성화하거나 비활성화합니다.	`loggingEnabled: true`
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 `ERROR` (가장 자세한 정보 없음), `WARNING`, `INFO`, `VERBOSE`, `AUDIT` (가장 자세한 정보 표시)가 포함됩니다.	`logLevel: NREnums.LogLevel.INFO`
(iOS 전용) `WebViews` 의 자동 계측을 활성화/비활성화합니다.	`webViewInstrumentation: true`
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`collectorAddress: "crash-upload-delegate.domain.com"`
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`crashCollectorAddress: "crash-upload-delegate.domain.com"`
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다.	`sendConsoleEvents: true`
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오. `offlineStorageEnabled: false`
네트워크 요청에 분산 추적 헤더 추가를 활성화하거나 비활성화합니다. 기본값은 `true` 입니다. 모바일 앱에서의 추적 추적에 대한 자세한 내용은 브라우저 및 모바일 추적 보고를참조하세요.	분산 추적은 기본적으로 활성화되어 있습니다. 비활성화하려면 다음 기능 플래그를 추가하세요. `distributedTracingEnabled: false`
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `backgroundReportingEnabled: true` 백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다. 앱의 `Info.plist` 파일에 '허용된 백그라운드 작업 스케줄러 식별자' 키를 추가하세요. 이 키는 앱의 번들 제외인 단일 문자열 값을 포함하는 제외여야 합니다. Xcode 프로젝트 기능의 Background Modes 섹션에서 Background Fetch 및 Background Process 를 활성화하세요. 참고: 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,
    jsErrorReportingEnabled: true
  )
};

NewRelic.startAgent(appToken,agentConfiguration);
NewRelic.setJSAppVersion(appVersion.version);
AppRegistry.registerComponent(appName, () => App);

사용 가능한 구성

설명	예시
(Android 전용) 이벤트 데이터 수집을 활성화 또는 비활성화합니다.	`analyticsEventEnabled: true`
충돌 보고를 활성화하거나 비활성화합니다.	`crashReportingEnabled: true`
네이티브 충돌 보고를 활성화하거나 비활성화합니다.	`nativeCrashReportingEnabled: true`
JavaScript 오류를 `MobileJSError` 이벤트로 자동 보고하는 기능을 활성화하거나 비활성화합니다. 활성화되면 에이전트는 처리되지 않은 JavaScript 오류를 캡처하고 추가 계측 없이 이를 보고합니다. 기본값은 `true`입니다. 리액트 네이티브 에이전트 버전 1.9.0 이상에서 사용할 수 있습니다.	`jsErrorReportingEnabled: true`
상호 작용 추적을 활성화하거나 비활성화합니다. 추적 계측은 계속 발생하지만 추적이 수집되지 않습니다. 이렇게 하면 기본 및 사용자 지정 상호 작용이 비활성화됩니다.	`interactionTracingEnabled: true`
`MobileRequest` 이벤트 유형에 대한 성공적인 HTTP 요청 보고를 활성화하거나 비활성화합니다.	`networkRequestEnabled: true`
`MobileRequestError` 이벤트 유형에 대한 네트워크 및 HTTP 요청 오류 보고를 활성화하거나 비활성화합니다.	`networkErrorRequestEnabled: true`
HTTP 오류 추적 및 `MobileRequestError` 이벤트에 대한 HTTP 응답 본문 캡처를 활성화 또는 비활성화합니다.	`httpResponseBodyCaptureEnabled: true`
에이전트 로깅을 활성화하거나 비활성화합니다.	`loggingEnabled: true`
로그 수준을 지정합니다. 기본 로그 수준에 대해서는 이 필드를 생략하십시오. 옵션에는 `ERROR` (가장 자세한 정보 없음), `WARNING`, `INFO`, `VERBOSE`, `AUDIT` (가장 자세한 정보 표시)가 포함됩니다.	`logLevel: NREnums.LogLevel.INFO`
(iOS 전용) `WebViews` 의 자동 계측을 활성화/비활성화합니다.	`webViewInstrumentation: true`
데이터 전송을 위한 특정 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`collectorAddress: "crash-upload-delegate.domain.com"`
충돌을 보내기 위한 특정 충돌 수집기 주소를 설정합니다. 기본 주소에 대해서는 이 필드를 생략하십시오.	`crashCollectorAddress: "crash-upload-delegate.domain.com"`
New Relic에 JavaScript 콘솔 로그 전송을 활성화 또는 비활성화합니다.	`sendConsoleEvents: true`
미국 정부 클라이언트에 대해 서로 다른 엔드포인트를 사용하여 보고 데이터를 활성화 또는 비활성화합니다.	`fedRampEnabled: false`
인터넷 연결을 사용할 수 없을 때 오프라인 데이터 저장소를 활성화하거나 비활성화합니다. 오프라인 저장소의 양을 구성하려면 최대 오프라인 저장소 크기 설정을 참조하세요.	오프라인 저장소는 기본적으로 활성화되어 있습니다. 이를 비활성화하려면 다음 기능 플래그를 추가하십시오. `offlineStorageEnabled: false`
애플리케이션이 백그라운드 상태로 전환되면 백그라운드 보고를 활성화하거나 비활성화합니다.	백그라운드 보고는 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 다음 기능 플래그를 추가하십시오. `backgroundReportingEnabled: true` 백그라운드 계측을 사용하려면 iOS 앱 프로젝트에 다음이 필요합니다. 앱의 `Info.plist` 파일에 '허용된 백그라운드 작업 스케줄러 식별자' 키를 추가하세요. 이 키는 앱의 번들 제외인 단일 문자열 값을 포함하는 제외여야 합니다. Xcode 프로젝트 기능의 Background Modes 섹션에서 Background Fetch 및 Background Process 를 활성화하세요. 참고: iOS는 iOS가 24시간마다 한 번씩 백그라운드에서 수집하도록 보장합니다.

뉴렐릭은 Unity의 모바일 앱 모니터링을 위한 기본 설정을 제공합니다. 특정 요구 사항에 맞게 Unity 편집기 내에서 이러한 설정을 쉽게 조정할 수 있습니다.

이러한 설정을 구성하려면:

Unity Editor를 실행하고 Unity 프로젝트를 엽니다.
메뉴 모음에서 Tools > New Relic > Getting Started > New Relic Configuration 선택하세요.
왼쪽 Inspector 창에는 기본 설정 목록이 표시됩니다. 활성화하려면 설정 옆의 확인란을 선택하고 비활성화하려면 확인란을 선택 취소하면 됩니다.
Add component [구성 요소 추가 를] 클릭합니다.

뉴렐릭은 Unreal Engine의 모바일 앱 모니터링을 위한 기본 설정을 제공합니다. Unreal 편집기 내에서 이러한 설정을 특정 요구 사항에 맞게 쉽게 조정할 수 있습니다.

이러한 설정을 구성하려면:

Unreal Editor를 설치하고 Unreal 프로젝트를 엽니다.
메뉴 막대에서 **Plugins > New Relic > **을 선택합니다.

Screenshot of the Unreal editor to configure settings

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

데이터 끝점 설정 .css-21sua1{background:none;border:none;width:0;padding:0;}

분석 설정

앱 실행 시간 설정

애플리케이션 설정

배경보고

충돌 및 오류 보고 설정

분산 추적

이벤트 지속성

FedRamp 설정

상호작용 설정

로깅 설정

네트워킹 설정

오프라인 저장

기능 플래그 활성화 또는 비활성화

데이터 끝점 설정

충돌 및 오류 보고 기능 플래그

분산 추적

상호작용 기능 플래그

주의

주의

네트워킹 기능 플래그

주의

앱 실행 시간 설정

FedRAMP 끝점 설정

오프라인 저장

배경보고

자동 로그 수집

사용 가능한 구성

사용 가능한 구성

사용 가능한 구성

사용 가능한 구성

사용 가능한 구성

데이터 끝점 설정