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

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

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

문제 신고

.NET 에이전트 설치 리소스

이 문서에는 .NET 에이전트 설치 절차 에서 참조되는 리소스 및 절차에 대한 자세한 설명이 포함되어 있습니다.

중요

이 문서는 독립형 문서로 읽기 위한 것이 아닙니다 . 설치 지침은 .NET 에이전트 설치 를 참조하십시오.

마이크로소프트의 .NET 프로파일러

New Relic의 .NET 에이전트는 Microsoft 프로파일링 API 를 사용하여 .NET 애플리케이션의 데이터를 보고합니다.

New Relic 이외의 .NET 모니터링 솔루션은 이 프로파일링 API를 사용할 수 있습니다. 그러나 한 번에 하나의 서비스만 프로파일러를 사용할 수 있습니다. 즉, 과거에 .NET 모니터링 서비스를 사용했고 이를 완전히 비활성화/제거하지 않은 경우 프로파일러가 여전히 사용 중일 수 있으므로 .NET 에이전트를 활성화하려고 할 때 프로파일러 충돌 이 발생할 수 있습니다.

.NET 에이전트 다운로드 라이브러리

New Relic .NET 에이전트 다운로드 라이브러리 에는 특정 설치 절차 에서 참조되는 설치 파일 패키지가 포함되어 있습니다. 이러한 파일에 대한 자세한 내용은 다운로드 라이브러리의 ReadMe 파일 을 참조하십시오.

수동 .NET 에이전트 설치용 Zip 파일(Windows)

ZIP 파일을 사용하여 에이전트를 수동으로 설치하려면 모니터링하려는 애플리케이션에 대한 올바른 파일을 선택하십시오.

  1. .NET 에이전트 다운로드 사이트 로 이동하여 애플리케이션의 아키텍처(64비트 또는 32비트)와 일치하는 파일을 가져옵니다.

    • .NET Framework 또는 .NET Core/.NET 5+(32비트): NewRelicDotNetAgent_VERSION_x86.zip
    • .NET Framework 또는 .NET Core/.NET 5+(64비트): NewRelicDotNetAgent_VERSION_x64.zip
  2. 원하는 위치에 에이전트 폴더의 압축을 풉니다.

  3. 모니터링하려는 프로세스에 대한 환경 변수를 설정합니다.

    주의

    이러한 환경 변수를 전역적으로 설정하지 않는 것이 좋습니다. 이러한 환경 변수를 전역적으로 설정하면 시스템에서 실행 중인 모든 .NET 프로세스가 계측되고 New Relic에 보고될 수 있습니다. 에이전트를 수동으로 설치하는 경우 모니터링하려는 프로세스에 대해서만 이러한 환경 변수를 설정할 수 있는 수단이 있을 것으로 기대합니다.

  4. 응용 프로그램을 다시 시작하십시오. IIS를 사용하는 경우 IIS를 다시 시작합니다.

애플리케이션이 트래픽을 수신하는 경우 데이터가 몇 분 이내에 표시되어야 합니다. 표시되지 않으면 데이터가 표시되지 않음 을 참조하십시오.

맞춤형 계측의 필요성

.NET 에이전트를 설치한 후 대부분의 .NET 애플리케이션 프레임워크는 자동으로 New Relic 계정에 데이터를 보고합니다. (앱 프레임워크 호환성: .NET Framework | .NET Core 참조)

.NET 애플리케이션이 자동으로 계측 되지 않는 애플리케이션 프레임워크를 사용하거나 앱에 프레임워크(예: 콘솔 앱)가 없는 경우 설치 후 앱 계측을 수동으로 설정해야 합니다. 이를 수행하는 단계는 다음과 같습니다.

  1. 애플리케이션 및 프레임워크에 대한 관련 설치 지침 을 따르십시오.
  2. New Relic에 보고되는 활동을 정의하기 위해 애플리케이션을 사용자 정의합니다.

설치 관련 환경 변수

.NET 에이전트를 설치하려면 환경 변수를 설정해야 합니다. 일부 설치 절차(예: IIS에서 호스팅하는 .NET 응용 프로그램)의 경우 이러한 환경 변수가 자동으로 설정됩니다. 다른 설치 절차의 경우 수동으로 설정해야 합니다. .NET Framework 및 .NET Core 애플리케이션 모두에 필요한 환경 변수를 보려면 환경 변수 를 참조하세요.

환경 변수를 수동으로 설정해야 하는 설치의 경우 환경 변수를 통해 다른 구성 옵션 을 설정할 수도 있습니다. 다음은 일반적으로 설정되는 두 가지입니다.

  • License key. 설정을 위한 환경 변수는 다음과 같습니다.

    NEW_RELIC_LICENSE_KEY = YOUR_LICENSE_KEY

    newrelic.config 파일 또는 앱의 구성 파일 에서 설정할 수도 있습니다.

  • App name. 의미 있는 애플리케이션 이름을 설정하는 것이 좋지만 설치 후에 설정할 수도 있습니다. 환경 변수는 다음과 같습니다.

    NEW_RELIC_APP_NAME = YOUR_APP_NAME

    newrelic.config, 앱의 구성 파일 또는 API를 통해 이를 설정할 수도 있습니다.

스크립트 가능한 설치 프로그램(Windows만 해당)

스크립트 가능한 설치 프로그램은 .NET 에이전트를 설치하기 위한 PowerShell 스크립트가 포함된 ZIP 아카이브입니다. .NET Framework와 .NET Core에 대한 별도의 zip 아카이브가 있습니다.

중요

스크립트 가능한 설치 프로그램보다 MSI 설치 프로그램을 사용하는 것이 좋습니다. 설치를 자동화하려면 명령줄에서 MSI 설치 프로그램을 실행하는 것이 좋습니다.

중요

.NET 에이전트 버전 10.0.0부터 스크립트 가능한 설치 프로그램을 더 이상 사용할 수 없습니다.이 설명서는 이전 버전에 대해 스크립트 가능한 설치 프로그램을 사용하려는 고객을 위해 남아 있습니다.

Copyright © 2024 New Relic Inc.

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