iOS 모니터링을 설정하려면 설치 안내를 사용하는 것이 좋습니다. 그러나 에이전트를 수동으로 설치해야 하는 경우 아래 단계에 따라 Cocoapods와 함께 New Relic iOS 에이전트를 설치하세요.
iOS 애플리케이션 설치
설치 프로세스의 일부로 New Relic은 자동으로 애플리케이션 토큰 을 생성합니다. 이것은 New Relic에서 모니터링하는 각 모바일 앱을 인증하기 위한 40자의 16진수 문자열입니다.
iOS 또는 tvOS 애플리케이션을 설치하고 구성하려면:
- one.newrelic.com 으로 이동합니다.
- (해당되는 경우) 모바일 앱 목록에서 새 앱 추가를선택합니다.
- 시작하기 페이지에서 모바일 모니터링을 위한 플랫폼으로 iOS 를 선택합니다.
- 모바일 앱의 이름을 입력한 다음 계속 을 선택합니다.
모바일 모니터링을 위해 New Relic을 구성하는 단계를 계속 진행합니다.
Objective-C를 사용하여 구성
CocoaPods 및 Objective-C로 iOS/tvOS 앱을 구성하는 이러한 절차는 New Relic의 시작하기 페이지에도 나타납니다.
프로젝트의
Podfile에 다음 줄을 추가합니다.pod 'NewRelicAgent'Xcode에서 프로젝트를 닫은 다음 터미널을 열고 프로젝트 디렉터리에서 다음 명령을 실행하세요.
bash$pod install터미널에서 다음 명령을 실행하여 Xcode에서 프로젝트를 엽니다.
bash$open App.xcworkspaceAppDelegate.m파일에 다음 New Relic 헤더를 추가합니다.#import <NewRelic/NewRelic.h>AppDelegate.m파일에서 이 호출을application:didFinishLaunchingWithOptions의 첫 번째 줄에 추가하고APP_TOKEN를 애플리케이션 토큰 으로 바꿉니다.[NewRelic startWithApplicationToken:@"APP_TOKEN"];중요
에이전트는
didFinishLaunchingWithOptions의 첫 번째 줄에 있어야 하며 적절한 계측을 보장하기 위해 기본 스레드에서 실행되어야 합니다. 나중에, 백그라운드 스레드에서 또는 비동기적으로 호출을 시작하면 예기치 않거나 불안정한 동작이 발생할 수 있습니다.이 저장소를 다운로드하세요: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.
다운로드한 저장소에서
xcodeproject파일이 포함된 폴더에dsym-upload-tools복사합니다. 이제 다음 파일이 포함된 폴더가 있어야 합니다.YOUR_PROJECT.xcodeprojdsym-upload-tools/
iOS 에이전트 버전에 따라 아래 빌드 스크립트를 대상의 Build Phases 에 추가하세요. 스크립트가 마지막 빌드 스크립트인지 확인하고
APP_TOKEN애플리케이션 토큰 으로 바꾸세요.- iOS 에이전트 7.4.0 이상의 경우:
bash$ARTIFACT_DIR="${BUILD_DIR%Build/*}"$SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -name run-symbol-tool | head -n 1`$/bin/sh "${SCRIPT}" "APP_TOKEN"- iOS 에이전트 7.3.8의 경우 이하:
bash$SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`$/bin/sh "${SCRIPT}" "APP_TOKEN"(선택 사항) 디버깅 중에 기호 업로드를 건너뛰려면 위의 빌드 스크립트에 다음 줄을 추가합니다.
bash$if [ ${CONFIGURATION} = "Debug" ]; then$echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"$exit 0$fi앱을 정리하고 빌드한 다음 시뮬레이터나 다른 장치에서 실행하십시오.
Swift를 사용하여 구성
CocoaPods 및 Swift로 iOS/tvOS 앱을 구성하는 이러한 절차는 New Relic의 시작하기 페이지에도 나타납니다.
프로젝트의 Podfile 에서 다음 줄을 추가합니다.
pod 'NewRelicAgent'Xcode에서 프로젝트를 닫고 프로젝트 디렉터리의 터미널에서 다음 명령을 실행하여 업데이트합니다.
bash$pod install프로젝트 디렉터리의 터미널에서 다음 명령을 실행하여 Xcode에서 프로젝트를 엽니다.
bash$open App.xcworkspaceAppDelegate.swift에서 New Relic 헤더를 추가합니다. (앱이 SwiftUI로 작성된 경우 다음 지침 에 따라 프로젝트에 AppDelegate를 추가합니다.)import NewRelicAppDelegate.swift파일에서 이 호출을application:didFinishLaunchingWithOptions의 첫 번째 줄에 추가하고APP_TOKEN를 애플리케이션 토큰 으로 바꿉니다.NewRelic.start(withApplicationToken:"APP_TOKEN")중요
적절한 계측을 보장하려면
didFinishLaunchingWithOptions()의 첫 번째 줄에서 에이전트를 호출하고 기본 스레드에서 에이전트를 실행해야 합니다. 나중에 호출을 시작하면(백그라운드 스레드에서 또는 비동기적으로) 예기치 않거나 불안정한 동작이 발생할 수 있습니다.이 저장소를 다운로드하세요: https://github.com/newrelic/newrelic-ios-agent-spm/archive/refs/heads/main.zip.
다운로드한 저장소에서
xcodeproject파일이 포함된 폴더에dsym-upload-tools복사합니다. 이제 다음 파일이 포함된 폴더가 있어야 합니다.YOUR_PROJECT.xcodeprojdsym-upload-tools/
iOS 에이전트 버전에 따라 아래 빌드 스크립트를 대상의 Build Phases 에 추가하세요. 스크립트가 마지막 빌드 스크립트인지 확인하고
APP_TOKEN애플리케이션 토큰 으로 바꾸세요.- iOS 에이전트 7.4.0 이상의 경우:
ARTIFACT_DIR="${BUILD_DIR%Build/*}"SCRIPT=`/usr/bin/find "${SRCROOT}" "${ARTIFACT_DIR}" -type f -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" ]; thenecho "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"exit 0fi앱을 정리하고 빌드한 다음 시뮬레이터나 다른 장치에서 실행하십시오.
이 문서가 설치하는데 도움이 되셨나요?
(선택사항) 로깅 수준 변경
기본적으로 iOS 에이전트는 info 수준에서 로깅합니다. 로그 수준을 변경하여 더 많거나 적은 데이터를 수집할 수 있습니다. 지원되는 로그 수준은 6개입니다.
noneerrorwarninginfoverboseALL
중요
릴리스 빌드가 아닌 디버깅을 위해서는 로그 수준을 verbose 이상으로만 높이세요.
앱에서 로깅 수준을 변경하려면 NewRelic.start(withApplicationToken) 호출하기 전에 다음 메서드 호출을 추가하세요.
목표-c:
[NRLogger setLogLevels:NRLogLevelALL];빠른:
NRLogger.setLogLevels(NRLogLevelALL.rawValue)