New Relic 이외의 .NET 모니터링 솔루션은 이 프로파일링 API를 사용할 수 있습니다. 그러나 한 번에 하나의 서비스만 프로파일러를 사용할 수 있습니다. 즉, 과거에 .NET 모니터링 서비스를 사용했고 이를 완전히 비활성화/제거하지 않은 경우 프로파일러가 여전히 사용 중일 수 있으므로 .NET 에이전트를 활성화하려고 할 때 프로파일러 충돌 이 발생할 수 있습니다.
.NET 에이전트 다운로드 라이브러리
New Relic .NET 에이전트 다운로드 라이브러리 에는 특정 설치 절차 에서 참조되는 설치 파일 패키지가 포함되어 있습니다. 이러한 파일에 대한 자세한 내용은 다운로드 라이브러리의 ReadMe 파일 을 참조하십시오.
수동 .NET 에이전트 설치용 Zip 파일(Windows)
ZIP 파일을 사용하여 에이전트를 수동으로 설치하려면 모니터링하려는 애플리케이션에 대한 올바른 파일을 선택하십시오.
.NET Framework 또는 .NET Core/.NET 5+(32비트): NewRelicDotNetAgent_VERSION_x86.zip
.NET Framework 또는 .NET Core/.NET 5+(64비트): NewRelicDotNetAgent_VERSION_x64.zip
원하는 위치에 에이전트 폴더의 압축을 풉니다.
모니터링하려는 프로세스에 대한 환경 변수를 설정합니다.
주의
이러한 환경 변수를 전역적으로 설정하지 않는 것이 좋습니다. 이러한 환경 변수를 전역적으로 설정하면 시스템에서 실행 중인 모든 .NET 프로세스가 계측되고 New Relic에 보고될 수 있습니다. 에이전트를 수동으로 설치하는 경우 모니터링하려는 프로세스에 대해서만 이러한 환경 변수를 설정할 수 있는 수단이 있을 것으로 기대합니다.
.NET 에이전트를 설치하려면 환경 변수를 설정해야 합니다. 일부 설치 절차(예: IIS에서 호스팅하는 .NET 응용 프로그램)의 경우 이러한 환경 변수가 자동으로 설정됩니다. 다른 설치 절차의 경우 수동으로 설정해야 합니다. .NET Framework 및 .NET Core 애플리케이션 모두에 필요한 환경 변수를 보려면 환경 변수 를 참조하세요.
환경 변수를 수동으로 설정해야 하는 설치의 경우 환경 변수를 통해 다른 구성 옵션 을 설정할 수도 있습니다. 다음은 일반적으로 설정되는 두 가지입니다.
상승된 셸의 관리자 권한이 필요합니다(특히 사용자 지정 로그 디렉터리를 선택하고 IISReset을 수행하는 경우).
주의
보안상의 이유로 스크립트 앞에 powershell 를 추가하는 대신 스크립트 파일 이름에 ./ 을 추가하여 아래와 같이 installAgent.ps1 스크립트를 실행해야 합니다. powershell 을 추가하여 스크립트를 실행하고 제공된 인수(예: 설치 경로 또는 사용자 정의 로그 경로)에 공백이 있으면 이러한 인수가 손상되어 에이전트가 위치에 설치됩니다. 안전하지 않을 수 있습니다.
스크립트 가능한 설치 프로그램을 사용하여 .NET Core 애플리케이션용 .NET 에이전트를 설치하려면:
Windows 관리자 그룹에 대한 관리자 권한이 있는지 확인하십시오. 이에 대한 자세한 내용은 권한 문서 를 참조하십시오.
.NET 에이전트 다운로드 사이트 에서 .NET 에이전트의 스크립트 가능한 설치 프로그램 패키지를 다운로드합니다. 이러한 패키지 중 하나를 다운로드하거나 사용하면 라이센스 조건 에 동의하고 수락하는 것입니다.
원하는 위치에 패키지의 압축을 풉니다.
명령 셸을 열고 압축을 푼 패키지의 폴더로 이동합니다.
에이전트를 로컬 또는 전역으로 설치할 수 있습니다.
옵션이 없는 단순 설치의 경우 다음 명령을 사용합니다.
bash
$
./installAgent.ps1 -destinationPATH-installType global -licenseKey YOUR_LICENSE_KEY \