New Relic의 .NET 에이전트 는 APM에 보고되고 표시되는 애플리케이션 이름을 변경할 수 있는 여러 가지 방법을 제공합니다. 이 문서에서는 이러한 이름 지정 옵션에 대한 개요를 제공합니다.
APM 앱 이름 지정(.NET에 국한되지 않음)에 대한 일반적인 개요는 애플리케이션 이름 지정을 참조 하세요 . 데이터 연속성을 손상시키지 않고 애플리케이션의 이름을 변경하려면 UI alias-change 옵션을 사용하십시오.
앱 이름 설정(권장 방법) 앱을 처음 배포할 때 기본 이름을 더 설명적인 이름으로 변경할 수 있습니다. New Relic은 이러한 이름을 사용하여 메트릭을 수집하므로 이를 사용자 지정하면 여러 호스트에서 동일한 애플리케이션을 실행하고 모든 인스턴스에서 메트릭을 가져올 수 있습니다.
일반적으로 앱 로컬 newrelic.config
파일을 구성하는 것이 가장 편리한 이름 지정 방법입니다.
명명 방법
설명
추천 :
앱 로컬 newrelic.config
파일 구성
이 방법을 사용하면 특정 구성 설정으로 앱에 고유한 이름을 지정할 수 있습니다. 또한 IIS 및 비 IIS 호스팅 앱 모두에서 작동합니다.
에이전트 홈 디렉토리에서 앱의 루트 폴더로 newrelic.config
파일을 복사합니다.
기본: %ALLUSERSPROFILE%\New Relic\.NET Agent
복사본을 열고 앱 이름을 다음과 같이 설정합니다.
<application>
<name> App Name </name>
</application>
응용 프로그램을 다시 시작하십시오.
앱이 활성화되어 있는 한 데이터는 몇 분 안에 표시됩니다. 그렇지 않은 경우 문제 해결 절차 를 따르십시오.
기타 방법특정 용도나 목적을 염두에 둔 경우 다른 이름 지정 방법을 선호할 수 있습니다. 다음은 대체 방법의 전체 목록입니다.
중요 일부 방법은 다른 방법 보다 우선 합니다. 명명 방법을 선택하기 전에 구성이 어떻게 영향을 받을 수 있는지 이해해야 합니다.
명명 방법
설명
web.config
파일 구성
IIS에서 호스팅되는 앱이 있고 로컬 newrelic.config
파일을 사용하지 않으려는 경우 web.config
파일에서 이름 지정 설정을 구성할 수 있습니다.
단계 .NET Framework 앱의 경우:
파일의 appSettings
섹션에 다음 항목을 추가한 다음 애플리케이션을 다시 시작합니다.
<appSettings>
<add key = "NewRelic.AppName" value = "App Name " />
</appSettings>
.NET Core 앱의 경우:
다음과 같이 파일에 NEW_RELIC_APP_NAME
환경 변수를 추가한 다음 애플리케이션을 다시 시작합니다.
<aspNetCore processPath="dotnet" arguments=".\MyApp.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" hostingModel="InProcess" >
<environmentVariables>
<environmentVariable name="NEW_RELIC_APP_NAME" value="App Name " />
</environmentVariables>
</aspNetCore>
환경 변수를 사용하여 앱 이름 설정
컨테이너 배포 시 앱 이름을 쉽게 설정하고 싶다면 애플리케이션 환경에서 환경변수를 설정하면 된다.
단계 애플리케이션 환경에서 환경 변수 NEW_RELIC_APP_NAME
를 설정합니다.
NEW_RELIC_APP_NAME = "App name "
앱 풀의 이름
IIS 응용 프로그램 풀에 이미 원하는 고유 이름이 있거나 SNCI(공유 네트워크 콘텐츠 인프라) 를 사용하는 경우 할당된 앱 풀을 따라 앱 이름을 지정할 수 있습니다.
단계 web.config.
의 <appSettings>
섹션에서 모든 NewRelic.AppName
키를 제거합니다. 주변의 <appSettings>
태그를 삭제하지 않도록 하십시오.
newrelic.config
의 <application>
상위 요소에서 모든 <name>
하위 요소를 제거합니다. 주변의 <application>
태그를 삭제하지 않도록 하십시오.
그러면 각 앱은 앱 풀 이름에 따라 보고합니다.
app.config
파일 구성
IIS에서 호스팅되지 않는 응용 프로그램이 있고 로컬 newrelic.config
파일을 사용하지 않으려는 경우 app.config
파일에서 이름 지정 설정을 구성할 수 있습니다.
단계 다음 항목을 app.config
파일(예: applicationname.exe.config
)에 추가한 다음 애플리케이션을 다시 시작합니다.
<appSettings>
<add key = "NewRelic.AppName" value = "App Name " />
</appSettings>
.NET 에이전트 API 사용
프로그래밍 방식으로 앱 이름을 바꾸려면 SetApplicationName()
에이전트 API 호출을 사용하여 런타임에 앱 이름을 설정할 수 있습니다. 이 이름은 다른 모든 애플리케이션 이름 지정 소스보다 우선합니다.
앱이 활성화되어 있는 한 데이터는 몇 분 안에 표시됩니다. 그렇지 않은 경우 .NET 앱의 구성 파일 ( newrelic.config
또는 app.config
)을 변경한 경우 관리 명령 프롬프트에서 IISRESET
을 수행했는지 확인하십시오. 그렇지 않으면 문제 해결 절차 를 따르십시오.
여러 앱 이름 사용 여러 앱 이름을 사용하여 애플리케이션에서 데이터를 집계할 수 있습니다. 우리는 때때로 이것을 데이터 "롤업"이라고 부릅니다.
.NET 에이전트의 경우 최대 3개의 애플리케이션 이름을 설정할 수 있습니다. 첫 번째 이름은 기본 응용 프로그램 이름이고 두 번째 및 세 번째 이름은 보다 일반적인 데이터 집계 범주에 사용됩니다. 여러 앱 이름이 작동하는 방식에 대한 자세한 내용은 여러 앱 이름 사용 을 참조하세요.
Newrelic.config
파일다음은 앱 로컬 newrelic.config
파일에 여러 이름을 설정하는 예입니다.
<application>
<name>Primary App Name </name>
<name>Second App Name </name>
<name>Third App Name </name>
</application>
Web.config
파일다음은 web.config
파일에 여러 이름을 설정하는 예입니다.
<appSettings>
<add key="NewRelic.AppName" value="App Name , App Name 2 , App Name 3 " />
</appSettings>
App.config
파일다음은 app.config
파일에 여러 이름을 설정하는 예입니다.
<appSettings>
<add key="NewRelic.AppName" value="App Name , App Name 2 , App Name 3 " /
</appSettings>