• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

Swift 패키지 관리자 수동 설치

iOS 모니터링을 설정하려면 설치 안내를 사용하는 것이 좋습니다. 그러나 에이전트를 수동으로 설치해야 하는 경우 아래 단계에 따라 Swift Package Manager를 사용하여 New Relic iOS 에이전트를 설치하세요.

iOS 애플리케이션 설치

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

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

  1. one.newrelic.com 으로 이동합니다.
  2. 해당하는 경우: Mobile Apps [모바일 앱] 목록에서 Add a new app [새 앱 추가를] 선택합니다.
  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 패키지 제품을 선택하고 대상을 선택한 후 Finish를 선택합니다.

  4. AppDelegate.swift 파일에서 이 호출을 applicationDidFinishLaunchWithOptions 의 첫 번째 줄로 추가하고 APP_TOKEN 애플리케이션 토큰으로 바꿉니다. (앱이 SwiftUI로 작성된 경우 다음 지침 에 따라 AppDelegate를 프로젝트에 추가하세요.)

    NewRelic.start(withApplicationToken:"APP_TOKEN")

    중요

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

  5. 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"
  6. (선택 사항) 디버깅 중에 기호 업로드를 건너뛰려면 위의 빌드 스크립트에 다음 줄을 추가합니다.

    bash
    $
    if [ ${CONFIGURATION} = "Debug" ]; then
    $
    echo "Skipping DSYM upload CONFIGURATION: ${CONFIGURATION}"
    $
    exit 0
    $
    fi
  7. "스크립트 실행: 종속성 분석 기반"이라는 확인란이 있으면 선택 취소되어 있는지 확인하세요.

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

이 문서가 설치하는데 도움이 되셨나요?

문제점 해결

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

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

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

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

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

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

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

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

기본적으로 iOS 에이전트는 info 수준에서 로깅합니다. 로그 수준을 변경하여 더 많거나 적은 데이터를 수집할 수 있습니다. 지원되는 로그 수준은 6개입니다.

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

중요

릴리스 빌드가 아닌 디버깅을 위해서는 로그 수준을 verbose 이상으로만 높이세요.

앱에서 로깅 수준을 변경하려면 NewRelic.start(withApplicationToken) 호출하기 전에 다음 메서드 호출을 추가하세요.

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

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