• 로그인지금 시작하기

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

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

스위프트 패키지 관리자 설치

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

iOS 애플리케이션 설치

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

iOS 애플리케이션을 설치 및 구성하려면:

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

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

Swift 패키지 관리자를 사용하여 구성

  1. File > Swift Packages > Add Package Dependency... 를 선택합니다.

  2. 패키지 파일의 Github URL을 추가합니다.

    https://github.com/newrelic/newrelic-ios-agent-spm

    패키지를 추출할 때 artifact of binary target 'NewRelic' failed extraction: The operation couldn’t be completed. (TSCBasic.StringError error 1.) 오류가 발생하면 Xcode를 닫고 Derrived Data 폴더를 삭제한 다음 Xcode를 다시 열고 다시 시도하세요.

  3. NewRelic 패키지 제품을 선택하고 대상을 선택한 다음 마침을 선택합니다.

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

    NewRelic.start(withApplicationToken:"APP_TOKEN")

    중요

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

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

    • iOS 에이전트 7.4.0 이상:

      "${BUILD_DIR%/Build/*}/SourcePackages/artifacts/newrelic-ios-agent-spm/NewRelic.xcframework/Resources/run-symbol-tool" "APP_TOKEN"
    • iOS 에이전트 7.3.8 또는 이전:

      SCRIPT=`/usr/bin/find "${SRCROOT}" -name newrelic_postbuild.sh | head -n 1`
      
      if [ -z "${SCRIPT}"]; then
       ARTIFACT_DIR="${BUILD_DIR%Build/*}SourcePackages/artifacts"
       SCRIPT=`/usr/bin/find "${ARTIFACT_DIR}" -name newrelic_postbuild.sh | head -n 1`
      fi
      
      /bin/sh "${SCRIPT}" "APP_TOKEN"
    • 디버깅 중에 기호 업로드를 건너뛰려면 기존 줄 위에 다음 줄을 빌드 스크립트에 추가합니다.

      if [ ${CONFIGURATION} = "Debug" ]; then
      echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
      exit 0
      fi
  6. 스크립트 실행 아래에 "스크립트 실행: 종속성 분석 기반" 확인란이 있는 경우 해당 확인란이 선택되어 있지 않은지 확인하십시오.

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

While you wait for your data to come in...

Did this doc help you install?

문제점 해결

Swift 패키지를 추가할 때 다음 오류가 표시될 수 있습니다.

  • 아티팩트가 체크섬과 일치하지 않습니다.
  • remoteSourceControl에서 프레임워크를 다운로드할 수 없습니다.

이러한 유형의 오류가 표시되면 다음을 시도하십시오.

  1. Xcode 프로젝트에서 New Relic Swift 패키지를 통합 해제합니다.

  2. 터미널에서 다음 명령을 실행하여 spm 캐시를 삭제합니다.

    rm -rf ~/Library/Caches/org.swift.swiftpm
    rm -rf ~/Library/org.swift.swiftpm
  3. Xcode를 사용하여 파생 데이터를 삭제합니다.

  4. New Relic Swift 패키지를 Xcode 프로젝트에 다시 통합합니다.

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

모바일 앱 모니터링에는 6가지 로그 수준을 사용할 수 있습니다.

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

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

NRLogger.setLogLevels(NRLogLevelALL.rawValue)
Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.