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

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

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

문제 신고

브라우저 모니터링 및 Ruby 에이전트

Ruby 에이전트를 사용하면 자동 또는 수동으로 웹 페이지에 브라우저 모니터링 에이전트 계측을 추가할 수 있습니다. 사용하려면 UI에서 절차에 따라 브라우저 에이전트를 설치합니다. 그런 다음 이 섹션의 절차에 따라 Ruby 에이전트를 설정하세요.

요구 사항

자동 브라우저 계측은 최신 버전의 Rails에서 지원됩니다.

  • New Relic Ruby 에이전트( 버전 3.0.1 이상 )
  • 자동 계측용: Rails 2.3 이상
  • 수동 계측의 경우: Rails 2.0 - 2.2

자동 계측 사용

자동 계측은 Rack과 함께 작동하며 Rails 2.3 이상이 필요합니다.

newrelic.yml 에서 다음 플래그를 추가하거나 편집하여 최종 사용자 모니터링 스크립트가 있는 페이지를 자동으로 계측하도록 에이전트를 구성합니다.

browser_monitoring:
auto_instrument: true

이것은 최종 사용자를 모니터링하는 가장 간단한 방법입니다. Ruby 에이전트는 애플리케이션의 각 페이지를 검사하고 헤더에 브라우저 JavaScript를 자동으로 삽입합니다. 자동 계측은 Rack을 지원하는 환경에서 작동합니다. 성능상의 이유로 에이전트는 헤더 계측 지점에 대한 애플리케이션 응답의 처음 50k만 스캔합니다. X-UA-Compatible 메타 태그가 있고 <head> 태그가 50k보다 긴 경우 자동 계측이 정상적으로 실패합니다.

자동 계측은 X-UA-Compatible 메타 태그를 찾고 바로 뒤에 JavaScript를 삽입합니다. 자동 계측이 X-UA-Compatible 메타 태그를 찾을 수 없으면 여는 head 태그 뒤에 삽입되고 실패하면 여는 body 태그 뒤에 삽입됩니다. 이러한 태그 중 하나라도 조건부 또는 주석으로 래핑된 경우 자동 계측이 실패할 수 있습니다.

자동 계측이 애플리케이션 페이지를 올바르게 계측하지 못하는 경우 에이전트 API를 통해 수동으로 계측 해야 합니다.

에이전트 API를 통해 수동으로 계측

Rails 2.1-2.2를 사용 중이거나 자동 계측을 사용할 수 없는 경우에도 페이지에 적절한 스크립트를 포함하여 최종 사용자 모니터링을 수동으로 설정할 수 있습니다. New Relic Ruby 에이전트의 API를 사용하여 페이지에 삽입할 스크립트를 생성합니다.

예를 들어, 에이전트를 호출하도록 애플리케이션 템플릿을 수정하려면 다음을 사용하십시오.

<head>
<%= ::NewRelic::Agent.browser_timing_header rescue "" %>
# existing template code ...
</head>

CSP 논스 지원

브라우저 계측에서 CSP Nonce 사용은 Ruby 에이전트 버전 7.1.0 이상에서 지원됩니다. 브라우저 계측과 함께 nonce를 사용하려면 브라우저 모니터링 자동 계측을 비활성화하고 에이전트 API를 통해 수동 계측을 사용해야 합니다.

이제 에이전트가 브라우저 계측에 nonce를 삽입할 수 있도록 API 메서드에 nonce를 인수로 전달할 수 있습니다. 예: NewRelic::Agent.browser_timing_header(nonce) .

문제점 해결

보고되는 브라우저 데이터가 표시되지 않으면 HTML 소스를 보고 HTML 헤드에서 다음과 유사한 두 개의 스크립트 블록을 확인합니다.

<script type="text/javascript">
window.NREUM||(NREUM={});...
</script>

이러한 항목이 없으면 템플릿 파일에서 자동 계측 설정 또는 수동 계측 배치를 확인하십시오.

3.7.0 이전의 Ruby 에이전트 버전에서는 <%=::NewRelic::Agent.browser_timing_footer rescue "" %> 도 문서의 맨 아래에 최대한 가깝게 호출해야 했습니다. 3.7.0에서는 모든 필수 스크립트가 browser_timing_header 에 포함됩니다. browser_timing_footer 는 호환성을 위해 빈 문자열을 반환합니다.

자동 계측 비활성화

auto-instrument 의 기본값은 true 입니다(지정되지 않은 경우에도). 자동 계측을 비활성화하려면 이 플래그를 false 로 설정합니다.

특정 컨트롤러 또는 컨트롤러 작업에 대해서만 자동 계측을 비활성화하려면 newrelic_ignore_enduser 을 사용합니다. 서버 측 계측은 이 호출의 영향을 받지 않습니다.

Copyright © 2024 New Relic Inc.

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