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

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

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

문제 신고

Azure Web Apps에 .NET 에이전트 설치

이 문서에서는 Azure Web App에서 애플리케이션 성능 모니터링을 위해 New Relic의 .NET 에이전트를 설치하는 방법을 설명합니다. (이것은 Microsoft Azure에 대한 인프라 모니터링 통합을 설치하는 것과 동일하지 않습니다.) 권장 사항: 이 지침을 따르기 전에 .NET 에이전트 설치 개요 를 읽으십시오.

설치 옵션

다음 방법 중 하나를 사용하여 Azure 배포 웹앱에 New Relic .NET 에이전트를 추가합니다. 가장 좋은 옵션은 역할, 환경, 배포 등에 따라 다릅니다. 예를 들면 다음과 같습니다.

앱을 모니터링해야 하는 운영 팀의 경우 가장 쉽고 안정적인 옵션은 공개적으로 유지 관리되는 Azure 사이트 확장을 사용하는 것입니다.

참고: Azure 사이트 확장은 현재 Windows App Service 리소스에만 사용할 수 있습니다.

개발자 팀 또는 Linux App Service 리소스에 에이전트를 배포해야 하는 사람의 경우 nuget을 통해 설치하는 것이 가장 좋은 옵션입니다.

웹이 아닌 앱(WebJobs 포함) 또는 .NET Framework를 대상으로 하는 ASP.NET Core 앱을 모니터링하려면 다음 두 가지 방법 중 하나를 통해 해당 애플리케이션의 .exe 프로세스에 대해 에이전트를 명시적으로 활성화해야 합니다.

또한 WebJobs는 트랜잭션이 APM에 나타나도록 사용자 지정 계측 이 필요할 수 있으며 1분 미만 동안 실행되는 경우 추가 구성 이 필요할 수 있습니다.

Application Insights 비활성화

New Relic의 .NET 에이전트와 Microsoft Application Insights는 모두 CLR 프로파일러에 의존하지만 한 번에 하나만 활성화될 수 있습니다. .NET 에이전트가 제대로 작동하려면 Application Insights를 비활성화 해야 합니다 . 자세한 내용은 Application Insights 문제 해결 절차 를 참조하세요.

New Relic Azure Site Extension을 사용하여 설치( Windows만 해당 )

New Relic Azure Site Extension을 사용하여 Azure Web App용 .NET 에이전트를 설치하려면:

  1. New Relic Azure Site Extension 을 설치하기 전에 웹 애플리케이션을 종료하십시오.

  2. 사이트 확장 추가: https://[yoursitename].scm.azurewebsites.net 으로 이동한 다음 Site extensions > Gallery 를 선택합니다.

  3. 더하기를 선택하십시오

    New Relic 사이트 확장 옆에 있는 아이콘.

  4. Azure Portal에서 Azure App Service에 New Relic 앱 설정 을 추가합니다. 그러면 최신 .NET 에이전트 버전이 설치됩니다. 버전 10.x에서는 .NET Framework 4.6.1 이하 및 .NET Core 3.0 이하에 대한 지원을 중단 했습니다(마이그레이션 가이드 참조). 더 낮은 에이전트 버전이 필요한 경우 NEWRELIC_AGENT_VERSION_OVERRIDE 환경 변수를 사용하세요. 예: NEWRELIC_AGENT_VERSION_OVERRIDE=9.9.0 .

  5. 웹 앱을 다시 시작합니다.

사이트 확장을 이미 설치하고 버전 재정의를 설정했지만 애플리케이션이 보고되지 않는 경우 환경 변수가 인식되고 올바른 버전이 설치되도록 하려면 사이트 확장을 제거하고 다시 설치해야 할 수 있습니다.

이 설치 프로세스와 관련된 몇 가지 참고 사항:

  • 사용자 정의 계측 XML을 추가하거나 기본 newrelic.config 파일을 수정해야 하는 경우 %HOME%\NewRelicAgent\Framework 에서 .NET Framework용 .NET 에이전트를, %HOME%\NewRelicAgent\Core 에서 .NET Core용 에이전트를 찾을 수 있습니다.

  • 이 설치 방법은 Azure Web Apps 인스턴스의 모든 .NET Core 애플리케이션을 모니터링합니다. 특정 .NET Core 애플리케이션에 대한 모니터링을 비활성화하려면 다음 중 하나를 수행하면 됩니다.

New Relic Azure 사이트 확장으로 에이전트 업데이트

New Relic Azure 사이트 확장을 사용하여 Azure Web App용 .NET 에이전트를 업데이트하려면 다음 설치 지침을 따르십시오.

  • 에이전트 파일을 최신 버전으로 업데이트하는 최신 버전의 New Relic Azure 사이트 확장을 설치합니다.
  • 업데이트된 에이전트를 시작하려면 웹 앱을 다시 시작하십시오.

NuGet(.NET Framework)을 사용하여 설치

NuGet 설치 방법은 Azure Web App 호스트에서 사용할 수 있도록 애플리케이션과 함께 New Relic 에이전트를 패키징합니다.

이 절차의 NuGet 패키지는 이전 packages.config 만 지원합니다. 현재 PackageReference 형식을 지원하지 않습니다. 자세한 내용은 Microsoft의 패키지 참조 설명서 를 참조하십시오.

다중 프로젝트 솔루션의 경우 NuGet 패키지를 설치하기 전에 올바른 프로젝트(예: 특정 웹앱 프로젝트)를 선택했는지 확인하세요.

NuGet을 사용하여 .NET Framework 에이전트를 업그레이드하는 경우 newrelic.config 에서 변경한 내용을 덮어씁니다. 변경 사항을 보존하려면 newrelic.config 을 프로젝트 외부에 저장한 다음 업그레이드 후 복원하십시오.

NuGet을 사용하여 Azure Web App에 .NET 에이전트를 설치하려면:

  1. Azure Portal에서 Azure 플랫폼(32비트 또는 64비트)을 확인합니다. Azure 사이드바 메뉴에서 App Services > Your Application > Settings > Configuration > General settings 선택합니다.

  2. Visual Studio에서 애플리케이션을 열고 Package manager [패키지 관리자] 콘솔 에서 적절한 명령을 실행하여 New Relic NuGet 패키지를 설치합니다.

    • 32비트 : Install-Package NewRelic.Azure.WebSites
    • 64비트 : Install-Package NewRelic.Azure.WebSites.x64
  3. 애플리케이션을 게시합니다.

  4. Azure Portal에서 모니터링할 웹앱을 연 다음 Settings > Configuration 을 선택합니다.

  5. 구성 에서 + 새 애플리케이션 설정 을 선택하고 이러한 키/값 쌍을 추가합니다.

중요

이 예에서는 모두 Azure Web App이 D: 파일 시스템 루트를 사용한다고 가정합니다. Azure 웹에서 C: 루트를 사용하는 경우 이러한 경로를 구성할 때 올바른 드라이브 문자를 사용해야 합니다.

열쇠

COR_ENABLE_PROFILING

1

COR_PROFILER

{71DA0A04-7777-4EC6-9643-7D28B46A8A41}

COR_PROFILER_PATH

D:\Home\site\wwwroot\newrelic\NewRelic.Profiler.dll

NEWRELIC_HOME

D:\Home\site\wwwroot\newrelic

  1. Azure Portal에서 Azure App Service에 New Relic 앱 설정 을 추가합니다.
  2. 웹 앱을 다시 시작합니다.

NuGet(.NET Core)을 사용하여 설치

NuGet 설치 방법은 Azure Web App 호스트에서 사용할 수 있도록 애플리케이션과 함께 New Relic 에이전트를 패키징합니다.

.NET 에이전트는 Azure App Services에서 .NET Core Linux 및 Windows 애플리케이션을 지원합니다. Azure App Services의 설치 프로세스는 Linux 및 Windows용 .NET 에이전트 설치 절차 와 다릅니다.

NuGet을 사용하여 Azure Web App에 .NET 에이전트를 설치하려면:

  1. NewRelic.Agent NuGet 패키지를 설치합니다.

  2. newrelic.config 파일에 디렉터리 속성을 추가하여 로그 노드를 수정합니다( 참고: Visual Studio에서 NuGet에 의해 프로젝트에 추가된 newrelic.config 파일을 편집할 수 없는 경우 이 파일의 로컬 복사본을 다음 위치에 만들어야 합니다. 너의 어플리케이션):

  3. 애플리케이션을 게시합니다.

  4. Azure Portal에서 모니터링할 웹앱을 연 다음 Settings > Configuration 을 선택합니다.

  5. 구성 에서 + 새 애플리케이션 설정 을 선택하고 이러한 키/값 쌍을 추가합니다.

중요

이 예에서는 모두 Azure Web App이 D: 파일 시스템 루트를 사용한다고 가정합니다. Azure 웹에서 C: 루트를 사용하는 경우 이러한 경로를 구성할 때 올바른 드라이브 문자를 사용해야 합니다.

  1. Azure Portal에서 Azure App Service에 New Relic 앱 설정 을 추가합니다.
  2. 웹 앱을 다시 시작합니다.

Azure App Services에 New Relic 앱 설정 추가

앱 설정을 추가하려면:

  1. 당신이 가지고 있는지 확인 New Relic .NET 에이전트의 앱 설정을 추가하기 전에.

  2. Azure Portal에서 App Services 를 검색하고 열어 모니터링하려는 웹앱으로 이동합니다. 그런 다음 Configuration > Application settings 을 선택합니다.

  3. 애플리케이션 설정 에서 + 새 애플리케이션 설정 을 선택하고 다음 키/값 쌍을 추가합니다.

    열쇠

    NEW_RELIC_LICENSE_KEY

    귀하의_LICENSE_KEY

    NEW_RELIC_APP_NAME

    Your_APP_NAME

    이전 .NET 에이전트 버전을 사용해야 하는 경우 다음 키/값 쌍을 사용하세요.

    열쇠

    NEWRELIC_AGENT_VERSION_OVERRIDE

    DESIRED_AGENT_VERSION_NUMBER

  4. 웹 앱을 저장하고 다시 시작합니다.

설정 애플리케이션 설정이 있는 앱 이름은 newrelic.config 을 재정의합니다.

앱의 Kudu 진단 콘솔에서 앱의 환경 변수를 확인하려면 Environment > Environment variables 로 이동합니다.

예를 들어:

https://myappname.scm.azurewebsites.net/Env.cshtml#envVariables

앱 성능 보기

New Relic에서 성능을 보려면 애플리케이션이 트래픽을 수신해야 합니다. 데이터가 나타나기 시작하려면 몇 분 정도 기다려야 할 수 있습니다. 데이터가 표시되지 않으면 Azure Web Apps에 대한 문제 해결 절차를 참조하세요. New Relic에서 앱의 성능을 보려면 one.newrelic.com > All capabilities > APM & services > (앱 선택) 으로 이동합니다. APM Summary page [APM 요약 페이지가] 자동으로 나타납니다.

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

문제점 해결

에이전트를 설치하고 앱에 대한 트래픽을 생성하고 몇 분 동안 기다린 후에도 데이터가 표시되지 않으면 다음 문제 해결 팁을 시도하십시오.

  • 앱 루트의 newrelic 디렉터리에 있는 모든 파일이 Azure에 게시되었는지 확인합니다.
  • 환경 변수가 올바르게 설정되었는지 확인하십시오.
  • Microsoft Application Insights가 응용 프로그램에 설치 및 구성되어 있지 않은지 확인합니다. 자세한 내용은 Application Insights 문제 해결 절차 를 참조하세요.
  • 해당되는 경우 추가 Azure 문제 해결 절차 를 참조하세요.
Copyright © 2024 New Relic Inc.

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