코코아팟 설치

이 절차는 Cocoapods를 사용하는 iOS 및 tvOS 앱에 적용됩니다. 다른 유형의 경우 iOS 설치 및 구성을참조하십시오.

iOS 애플리케이션 설치

설치 프로세스의 일부로 New Relic은 자동으로 애플리케이션 토큰 을 생성합니다. 이것은 New Relic에서 모니터링하는 각 모바일 앱을 인증하기 위한 40자의 16진수 문자열입니다.

iOS 또는 tvOS 애플리케이션을 설치하고 구성하려면:

1. one.newrelic.com 으로 이동합니다.
2. (해당되는 경우) 모바일 앱 목록에서 새 앱 추가를선택합니다.
3. 시작하기 페이지에서 모바일 모니터링을 위한 플랫폼으로 iOS 를 선택합니다.
4. 모바일 앱의 이름을 입력한 다음 계속 을 선택합니다.

모바일 모니터링을 위해 New Relic을 구성하는 단계를 계속 진행합니다.

Objective-C를 사용하여 구성

CocoaPods 및 Objective-C로 iOS/tvOS 앱을 구성하는 이러한 절차는 New Relic의 시작하기 페이지에도 나타납니다.

1. 프로젝트의 Podfile 에서 다음 줄을 추가합니다.

   pod 'NewRelicAgent'

   복사

2. Xcode에서 프로젝트를 닫고 프로젝트 디렉터리의 터미널 에서 다음 명령을 실행하여 업데이트합니다.

   pod install

   복사

3. 프로젝트 디렉토리의 터미널 에서 다음 명령을 실행하여 Xcode에서 프로젝트를 엽니다.

   open App.xcworkspace

   복사

4. AppDelegate.m 파일에 New Relic 헤더를 포함합니다.

   #import <NewRelic/NewRelic.h>

   복사

5. AppDelegate.m 파일에서 이 호출을 application:didFinishLaunchingWithOptions 의 첫 번째 줄에 추가하고 APP_TOKEN 를 애플리케이션 토큰 으로 바꿉니다.

   [NewRelic startWithApplicationToken:@"APP_TOKEN"];

   복사

   중요

   에이전트는 didFinishLaunchingWithOptions 의 첫 번째 줄에 있어야 하며 적절한 계측을 보장하기 위해 기본 스레드에서 실행되어야 합니다. 나중에, 백그라운드 스레드에서 또는 비동기적으로 호출을 시작하면 예기치 않거나 불안정한 동작이 발생할 수 있습니다.

6. 대상의 빌드 단계 에 빌드 스크립트를 추가합니다. 새 빌드 스크립트가 가장 마지막 빌드 스크립트인지 확인하십시오. 그런 다음 APP_TOKEN 을 애플리케이션 토큰 으로 바꿔 다음을 붙여넣습니다.

• iOS 에이전트 7.4.0 이상의 경우:

  SCRIPT=`/usr/bin/find "${SRCROOT}" -name run-symbol-tool | head -n 1`
  /bin/sh "${SCRIPT}" "APP_TOKEN"

  복사

• iOS 에이전트 7.3.8의 경우 이하:

  SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
  /bin/sh "${SCRIPT}" "APP_TOKEN"

  복사

• 선택 사항: 디버깅 중에 기호 업로드를 건너뛰려면 기존 줄 위의 빌드 스크립트에 다음 줄을 추가합니다.

  if [ ${CONFIGURATION} = "Debug" ]; then
      echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
      exit 0
  fi

  복사

7. 앱을 정리하고 빌드한 다음 시뮬레이터나 다른 장치에서 실행하십시오.

Swift를 사용하여 구성

CocoaPods 및 Swift로 iOS/tvOS 앱을 구성하는 이러한 절차는 New Relic의 시작하기 페이지에도 나타납니다.

1. 프로젝트의 Podfile 에서 다음 줄을 추가합니다.

   pod 'NewRelicAgent'

   복사

2. Xcode에서 프로젝트를 닫고 프로젝트 디렉터리의 터미널에서 다음 명령을 실행하여 업데이트합니다.

   pod install

   복사

3. 프로젝트 디렉터리의 터미널에서 다음 명령을 실행하여 Xcode에서 프로젝트를 엽니다.

   open App.xcworkspace

   복사

4. AppDelegate.swift 에서 New Relic 헤더를 추가합니다. (앱이 SwiftUI로 작성된 경우 다음 지침 에 따라 프로젝트에 AppDelegate를 추가합니다.)

   import NewRelic

   복사

5. AppDelegate.swift 파일에서 이 호출을 application:didFinishLaunchingWithOptions 의 첫 번째 줄에 추가하고 APP_TOKEN 를 애플리케이션 토큰 으로 바꿉니다.

   NewRelic.start(withApplicationToken:"APP_TOKEN")

   복사

   중요

   적절한 계측을 보장하려면 didFinishLaunchingWithOptions() 의 첫 번째 줄에서 에이전트를 호출하고 기본 스레드에서 에이전트를 실행해야 합니다. 나중에 호출을 시작하면(백그라운드 스레드에서 또는 비동기적으로) 예기치 않거나 불안정한 동작이 발생할 수 있습니다.

6. 대상의 빌드 단계에 빌드 스크립트를 추가합니다. 새 빌드 스크립트가 마지막 빌드 스크립트인지 확인하십시오. 그런 다음 다음을 붙여넣고 APP_TOKEN 애플리케이션 토큰으로 바꿉니다.

• iOS 에이전트 7.4.0 이상의 경우:

  SCRIPT=`/usr/bin/find "${SRCROOT}" -name run-symbol-tool | head -n 1`
  /bin/sh "${SCRIPT}" "APP_TOKEN"

  복사

• iOS 에이전트 7.3.8의 경우 이하:

  SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
  /bin/sh "${SCRIPT}" "APP_TOKEN"

  복사

• 선택 사항: 디버깅 중에 기호 업로드를 건너뛰려면 기존 줄 위의 빌드 스크립트에 다음 줄을 추가합니다.

  if [ ${CONFIGURATION} = "Debug" ]; then
      echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
      exit 0
  fi

  복사

7. 앱을 정리하고 빌드한 다음 시뮬레이터나 다른 장치에서 실행하십시오.

로깅 수준 변경(선택 사항)

기본적으로 New Relic iOS 에이전트는 info 수준에서 로그합니다. 로그 수준을 verbose 이상으로 높이는 것은 릴리스 빌드가 아닌 디버깅을 위해서만 권장됩니다. 모바일 앱 모니터링에 6가지 로그 수준을 사용할 수 있습니다.

• none
• error
• warning
• info
• verbose
• ALL

앱에서 로깅 수준을 높이려면 NewRelic.start(withApplicationToken) 를 호출하기 전에 이 메서드 호출을 추가하세요.

[NRLogger setLogLevels:NRLogLevelALL];

Swift 앱의 경우:

NRLogger.setLogLevels(NRLogLevelALL.rawValue)