이 가이드에서는 .NET 에이전트의 9.x 및 10.x 버전 간의 주요 변경 사항, 업그레이드하는 동안 발생할 수 있는 문제, 버전 9.x로 성공적으로 마이그레이션하는 방법에 대해 간략히 설명합니다.
주요 변경 사항은 다음과 같습니다.
- .NET 에이전트는 수명 종료로 지정된 프레임워크를 더 이상 지원하지 않습니다.
- 더 이상 사용되지 않는 스크립팅 가능한 설치 프로그램 제거
- 더 이상 사용되지 않는 계측 제거
- Windows 설치 자산 통합 및 이름 변경
- Linux 설치 프로그램 패키지 이름 변경
- 설치 프로그램 파일 이름의 더 짧은 버전 번호
.NET 에이전트는 수명 종료로 지정된 프레임워크를 더 이상 지원하지 않습니다.
Microsoft는 .NET Framework 4.6.1 이하 및 .NET Core 3.0 이하가 지원 종료에 도달했다고 발표했습니다.이전 프레임워크를 수명 종료로 지정하면 해당 프레임워크의 최신 버전을 개선하는 데 리소스를 할애할 수 있습니다.
고객은 지원되는 프레임워크 버전을 사용하도록 애플리케이션을 마이그레이션하는 것이 좋습니다.프레임워크 마이그레이션이 옵션이 아닌 경우에도 고객은 9.x 버전 .NET 에이전트를 사용하여 애플리케이션을 계측할 수 있습니다.
더 이상 사용되지 않는 스크립팅 가능한 설치 프로그램 제거
v10.x부터 사용량이 적어 다운로드 사이트에서 스크립트 가능한 설치 프로그램 제공을 중단합니다.스크립팅 가능한 설치 프로그램을 사용하여 .NET 에이전트 설치 프로세스를 자동화하는 경우 스크립트의 명령줄 옵션과 함께 MSI 설치 프로그램을 사용하거나 다운로드 사이트 의 zip 아카이브 .NET 에이전트를 사용하여 자체 설치 스크립트를 구축하는 것을 고려하십시오.
더 이상 사용되지 않는 계측 제거
v10.x부터 .NET 에이전트는 Castle MonoRail 계측을 중지합니다.고객은 여전히 이전 버전의 .NET 에이전트를 사용하여 이 라이브러리를 계측할 수 있습니다.
Windows 설치 자산 통합 및 이름 변경
이전 버전에서는 Windows에서 .NET Framework 및 .NET Core/.NET 5+용 에이전트 자산을 수동으로 설치하기 위해 별도의 ZIP 아카이브를 게시했습니다.수동 Windows 설치를 위한 .NET Framework 및 .NET Core/.NET 5+ 에이전트 자산을 모두 포함하는 단일 ZIP 아카이브로 통합되었습니다(64비트 및 32비트 버전 모두 계속 사용 가능).따라서 이러한 수동 ZIP 아카이브는 .NET Framework 및 .NET Core/.NET 5+ 자산을 모두 설치하는 기존 MSI 자동 설치 프로그램과 유사합니다.
또한 MSI 및 ZIP 파일의 이름을 모두 동일한 기본 파일 이름 NewRelicDotNetAgent 으로 변경했습니다.
9.x Windows 설치 자산 이름 및 해당 10.x에 해당하는 이름 표
| 9.x 파일 이름 | |에 사용됨 10.x 파일 이름 | | ---| ---| ---| | newrelic-에이전트-win-x64-VERSION.msi | .NET 프레임워크 및 ..NET Core/.NET(64비트) 자동 설치 | NewRelicDotNetAgent_VERSION_x64.msi | | newrelic-에이전트-win-x86-VERSION.msi | .NET 프레임워크 및 ..NET Core/.NET(32비트) 자동 설치 | NewRelicDotNetAgent_VERSION_x86.msi | | newrelic-에이전트-win-x64-VERSION.zip | .NET 프레임워크 전용(64비트) 에이전트 자산의 ZIP 아카이브 | NewRelicDotNetAgent_VERSION_x64.zip | | newrelic-에이전트-win-x86-VERSION.zip | .NET 프레임워크 전용(32비트) 에이전트 자산의 ZIP 아카이브 | NewRelicDotNetAgent_VERSION_x86.zip | | newrelic-netcore20-에이전트-win-x64-VERSION.zip | ..NET Core/.NET 전용(64비트) 에이전트 자산의 ZIP 아카이브 | NewRelicDotNetAgent_VERSION_x64.zip | | newrelic-netcore20-에이전트-win-x86-VERSION.zip | ..NET Core/.NET 전용(32비트) 에이전트 자산의 ZIP 아카이브 | NewRelicDotNetAgent_VERSION_x86.zip |
Linux 설치 프로그램 패키지 이름 변경
v10.x부터 Linux용 에이전트 설치 패키지의 이름이 newrelic-netcore20-agent 에서 newrelic-dotnet-agent (으)로 변경됩니다.릴리스된 2.0보다 큰 버전의 .NET Core를 지원했으며 에이전트 버전 10.0부터는 3.1 이전 버전의 .NET Core를 더 이상 지원하지 않기 때문에 netcore20 이름이 혼란스럽다고 생각합니다.
새 newrelic-dotnet-agent 패키지는 이전 newrelic-netcore20-agent 패키지와 충돌 및 교체(DEB) 또는 폐기(RPM)로 표시됩니다.시스템의 패키지 관리자는 두 가지를 동시에 설치하는 것을 허용하지 않습니다.
newrelic-netcore20-agent 에서(으)로 업그레이드 newrelic-dotnet-agent
중요
업그레이드 프로세스는 /usr/local/newrelic-netcore20-agent 의 이전 에이전트 설치에서 newrelic.config 및 모든 XML 사용자 정의 계측 파일을 /usr/local/newrelic-dotnet-agent 의 새 설치 위치로 마이그레이션합니다.로그 파일 및 기타 사용자 지정 데이터는 자동으로 마이그레이션 되지 않습니다 .
안전을 위해 다음 단계를 계속하기 전에
/usr/local/newrelic-netcore20-agent에 있는 모든 파일의 백업 복사본을 만들어야 합니다.현재 모니터링 중인 모든 .NET 응용 프로그램을 종료합니다.
Linux 시스템에 적합한 패키지 관리자 지침을 따르십시오.
프로파일링 환경 변수를 업데이트하십시오.특정 변수에 따라 변경 사항을 사용해야 하는 정확한 구성입니다.
CORECLR_ENABLE_PROFILING="1"CORECLR_PROFILER="{36032161-FFC0-4B61-B559-F6C5D41BAE5A}"CORECLR_NEWRELIC_HOME="/usr/local/newrelic-dotnet-agent"CORECLR_PROFILER_PATH="/usr/local/newrelic-dotnet-agent/libNewRelicProfiler.so"앱을 시작하고 데이터가 나타날 때까지 기다립니다.
마이그레이션이 성공적으로 완료되면 다음 단계를 수행하여 이전 newrelic-netcore20-agent 설치의 나머지 아티팩트를 정리합니다.
Debian 기반(apt/dpkg) 시스템을 사용하는 경우:
bash$sudo dpkg -P newrelic-netcore20-agent/usr/local/newrelic-netcore20-agent제거(Debian 기반(apt/dpkg) 및 RPM 기반(yum/rpm) 시나리오 모두에 적용):bash$sudo rm -rf /usr/local/newrelic-netcore20-agent
설치 프로그램 파일 이름의 더 짧은 버전 번호
New Relic .NET 에이전트는 에이전트 버전 8.28.0부터 Semantic Versioning 을 사용하고 있습니다.SemVer는 릴리스 버전을 지정하기 위해 주, 부 및 패치의 세 가지 숫자를 사용합니다.그러나 설치 프로그램 파일 이름은 계속해서 4개의 숫자를 사용했으며 네 번째 버전 번호는 항상 0입니다.앞으로 우리는 설치 프로그램 파일 이름에 있는 버전 문자열에서 이 의미없고 잠재적으로 혼란스러운 네 번째 숫자를 삭제합니다.이 변경 사항은 Windows 및 Linux 설치 프로그램 파일에 모두 적용됩니다.