.NET 에이전트를 사용하면 웹페이지에 계측을 추가할 수 있습니다. .NET 에이전트와 함께 브라우저를 사용하기 전에 .NET 에이전트 릴리스 정보 를 참조하고 최신 .NET 에이전트 릴리스가 설치되어 있는지 확인하세요.
.NET 에이전트 요구 사항 에 따라 브라우저 모니터링을 설치합니다 . 그런 다음 이 문서의 절차에 따라 .NET 에이전트를 수동으로 계측합니다.
자동계측
중요
자동 측정, 자동 리소스는 .NET Framework 웹앱과 .NET Core v6.0 이상 웹앱에서만 사용할 수 있습니다. ASP..NET Core v5.0 및 이전 애플리케이션은 .NET 에이전트에서 모니터링하더라도 자동 측정, 자동 로그를 사용할 수 없습니다.
브라우저 자동 측정, 자동 로그를 사용하면 .NET 에이전트는 text/html 의 content-type 이 있고 페이지 내에 <head> 태그도 있는 모든 페이지에 브라우저 JavaScript 헤더를 자동으로 삽입합니다. 브라우저 자동 측정, 자동 리소스는 .NET Framework 웹앱에 대해 기본적으로 활성화되지만 .NET Core v6 이상 웹앱에서는 기본적으로 비활성화됩니다. 자세한 내용은 .NET Core v6+용 브라우저 자동 측정, 자동 로그 활성화를 참조하세요.
<head> 태그 검색은 DOM 시작 부분에서 시작됩니다. .NET 에이전트는 콘텐츠를 사용자에게 스트리밍하기 전에 HTTP 응답 필터를 사용하여 페이지를 수정하는 HttpModule 을 추가하여 JavaScript 헤더를 삽입합니다.
자동 계측을 처음 활성화할 때 aspx 페이지가 다시 컴파일되도록 asp.net 캐시 디렉토리를 정리해야 할 수 있습니다. 다음 명령을 사용합니다.
$flush_dotnet_temp.cmd이 삽입으로 content-type 이 올바르게 설정되지 않으면 이전에 작동하던 페이지가 작동을 멈출 수 있습니다. 수정하려면 앱에서 content-types 을(를) 검토 및 업데이트하거나 자동 계측을 비활성화 하십시오.
에이전트 API를 통한 수동 계측
자동 계측을 활성화할 수 없는 경우에도 New Relic .NET 에이전트 API를 사용하고 페이지에 적절한 코드를 포함하여 브라우저 에이전트를 수동으로 포함할 수 있습니다.
NewRelic.Api.Agent.dll을 다운로드하려면 설치를 다시 실행하고.dll을 참조하십시오.뉴웰릭 .NET 에이전트 디렉터리에서
New Relic.Net
에이전트 섹션을 선택한 다음,
API Assembly
선택합니다.
NuGet:
Install-package NewRelic.Agent.Api실행하여.dll
설치하고 참조합니다.
뉴렐릭 .NET 에이전트 API 호출하도록 웹 로그를 설정하려면 프로젝트에
NewRelic.Api.Agent.dll에 대한 참조를 추가하세요.선택 사항: 웹 서버에서 구현하다, 배포하다 구성 디렉터리를 수정하는 경우
NewRelic.Api.Agent.dll작곡의bin디렉터리에 복사합니다.<head>태그에서 API를 호출합니다.X-UA-COMPATIBLE http-equiv속성이 있는 메타 태그가 있으면 해당 메타 태그 뒤에 설정합니다.
복사/붙여넣기로 수동 계측
브라우저 모니터링을 활성화하면 JavaScript 스니펫을 앱의 웹페이지에 수동으로 삽입할 수 있습니다. 복사/붙여넣기 옵션을 사용하면 웹페이지 성능을 모니터링하는 데 필요한 JavaScript 코드 조각의 정확한 배치를 제어할 수 있습니다. 복사/붙여넣기로 브라우저 모니터링을 활성화하는 방법에 대한 지침은 브라우저 설명서 를 참조하세요.
계측 비활성화
계측을 비활성화하려면:
문제점 해결
브라우저 타이밍 데이터를 볼 수 없는 경우 문제 해결 절차를 따르십시오.
.NET Core v6+ 웹 애플리케이션에 대한 브라우저 자동 측정, 자동 로그 활성화
.NET Core v6+ 웹앱에서 브라우저 자동 측정을 활성화하려면(.NET 에이전트 v10.19.2 이상 필요):
newrelic.config편집하고browserMonitoringautoInstrument플래그를true로 설정하여 자동 측정, 자동 로그를 전역적으로 활성화했는지 확인하세요.<!-- enable auto instrumentation globally --><browserMonitoring autoInstrument="true"/>newrelic.config편집하고appSettings섹션에 새 항목을 추가하여(또는 존재하지 않는 경우appSettings섹션을 추가) ..NET Core 6+ 웹 앱에 대한 자동 측정, 자동 로그를 활성화합니다.web.config파일의appSettings섹션과 동일 하지 않습니다 .<!-- enable .NET Core 6+ instrumentation --><appSettings><add key="EnableAspNetCore6PlusBrowserInjection" value="true" /></appSettings>
웹 애플리케이션과의 호환성을 보장하려면 운영 환경에서 이 기능을 철저히 테스트하는 것이 좋습니다. 이 기능과 관련하여 문제가 발생하는 경우 지원을 위해 당사에 문의 하세요.