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

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

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

문제 신고

Ruby 에이전트 구성

New Relic Ruby 에이전트는 구성 파일의 설정, 환경 변수를 사용하거나 서버 측 구성을 사용하여 프로그래밍 방식으로 구성할 수 있습니다. 이 문서는 Ruby 에이전트에 사용할 수 있는 구성 옵션을 요약합니다.

구성 옵션의 기본값이 (Dynamic) 이면 Ruby 에이전트가 런타임에 기본값을 계산한다는 의미입니다. 구성 설정 값은 기본적으로 다른 설정 값으로 적절하게 설정됩니다.

구성 방법 및 우선 순위

Ruby 에이전트를 구성하는 기본(기본) 방법은 config 하위 디렉토리의 구성 파일( newrelic.yml )을 사용하는 것입니다. 환경 변수를 사용하여 구성 값을 설정하려면:

  1. 설정 이름에 접두사 NEW_RELIC_ 을 추가합니다.
  2. 마침표 . 를 밑줄 _ 로 바꿉니다.

서버 측 구성 을 통해 UI에서 몇 가지 값을 구성할 수도 있습니다.

Ruby 에이전트는 구성에 대해 다음과 같은 우선 순위를 따릅니다.

  1. 환경 변수
  2. 서버 측 구성
  3. 구성 파일( newrelic.yml )
  4. 기본 구성 설정

즉, 환경 변수는 다른 모든 구성 설정 및 정보를 재정의하고 서버 측 구성은 구성 파일 및 기본 구성 설정을 재정의하는 식입니다.

구성 파일 옵션 보기 및 편집

Ruby 에이전트의 newrelic.yml 은 표준 YAML 구성 파일입니다. 일반적으로 상단에는 Defaults 섹션이 있고 아래에는 각 애플리케이션 환경에 대한 섹션이 포함됩니다. 예: Development , TestingProduction .

Ruby 에이전트는 특정 환경 변수를 확인하여 애플리케이션 환경을 파생하여 읽을 newrelic.yml 구성 파일의 섹션을 결정합니다. 이는 예를 들어 프로덕션 환경에서 log_level 구성 설정에 info 을 사용하고 개발 환경에서 debug 와 같이 더 자세한 log_level 구성 설정을 원할 때 유용할 수 있습니다.

다음은 newrelic.yml 구성 파일의 예입니다.

common: &default_settings
license_key: 'YOUR_LICENSE_KEY'
app_name: 'My Application Name'
production:
<<: *default_settings
log_level: info
development:
<<: *default_settings
log_level: debug

비 Rails 앱의 경우 Ruby 에이전트는 다음 환경 변수를 순서대로 검색하여 애플리케이션 환경을 결정합니다.

  1. NEW_RELIC_ENV
  2. RUBY_ENV
  3. RAILS_ENV
  4. APP_ENV
  5. RACK_ENV

Ruby 에이전트가 이러한 환경 변수의 값을 감지하지 못하면 애플리케이션 환경을 기본적으로 development 으로 설정하고 newrelic.yml 구성 파일의 development 섹션에서 읽습니다.

Rails 앱에서 Ruby 에이전트를 실행할 때 에이전트는 먼저 NEW_RELIC_ENV 환경 변수를 찾아 애플리케이션 환경과 사용할 newrelic.yml 섹션을 결정합니다. NEW_RELIC_ENV 가 없으면 에이전트는 Rails 환경( Rails 버전에 따라 RAILS_ENV 또는 RAILS.env )을 사용합니다.

구성 파일을 편집할 때 다음을 확인하십시오.

  • 두 개의 공백으로만 들여쓰기합니다.
  • error_collector 과 같은 섹션에서 관련 있는 경우에만 들여쓰기합니다.

들여쓰기를 올바르게 하지 않으면 에이전트가 시작될 때 Unable to parse configuration file 오류가 발생할 수 있습니다.

사용 가능한 Ruby 에이전트 구성 옵션의 최신 목록을 보려면 rake newrelic:config:docs 명령을 사용합니다. 이 문서에서는 가장 일반적인 옵션에 대해 설명합니다.

구성 파일 업데이트

이 문서는 Ruby 에이전트의 최신 릴리스에 적용됩니다. 이전 버전에 대한 자세한 내용은 newrelic.yml 자체의 주석을 참조하세요.

새 릴리스 이후에 newrelic.yml 파일을 업데이트하려면 에이전트 gem의 기본 디렉토리에 있는 템플릿을 사용하세요. 새 gem 버전으로 업데이트할 때 설치 디렉토리 에서 config/newrelic.ymlnewrelic.yml 를 검사하거나 비교하여 새 구성 옵션을 활용하십시오.

중요

gem을 업데이트해도 config/newrelic.yml 은 자동으로 업데이트되지 않습니다.

일반적인

이러한 설정은 에이전트 구성에 사용할 수 있습니다. 일부 설정은 New Relic 구독 수준에 따라 다릅니다.

트랜잭션 추적기

트랜잭션 추적 기능은 호출 순서 요약, 소요 시간 분석, SQL 쿼리 목록 및 쿼리 계획(mysql 및 postgresql에서)을 포함하여 선택한 트랜잭션에서 자세한 정보를 수집합니다. 사용 가능한 기능은 New Relic 구독 수준에 따라 다릅니다.

오류 수집기

에이전트는 기본적으로 잡히지 않는 모든 예외를 수집하고 보고합니다. 이러한 구성 옵션을 사용하면 오류 수집을 사용자 지정할 수 있습니다.

무시되고 예상되는 오류에 대한 정보 는 APM의 오류 분석 페이지를 참조하십시오 . NewRelic::Agent.notice_error Ruby 메서드를 통해 예상되는 오류를 설정하려면 Ruby Agent API를 참조하세요 .

브라우저 모니터링

그만큼 페이지 로드 타이밍 기능(실제 사용자 모니터링 또는 RUM이라고도 함)은 실제 사용자가 웹 사이트에서 경험하는 성능에 대한 통찰력을 제공합니다. 이는 각 페이지의 머리글과 바닥글에 소량의 JavaScript 코드를 삽입하여 사용자 브라우저가 웹 페이지를 다운로드하고 렌더링하는 데 걸리는 시간을 측정함으로써 수행됩니다.

거래 이벤트

애플리케이션 로깅

Ruby 에이전트는 컨텍스트에서 APM 로그를 지원합니다. Ruby 에이전트에 대한 로그 구성에 대한 몇 가지 팁 은 컨텍스트에서 Ruby 로그 구성 을 참조하십시오.

사용 가능한 로깅 관련 구성 옵션은 다음과 같습니다.

속성

속성 은 이벤트 또는 트랜잭션의 속성을 결정하는 정보를 포함하는 키-값 쌍입니다. 이러한 키-값 쌍은 APM의 트랜잭션 추적, APM의 추적된 오류, 대시보드의 트랜잭션 이벤트 및 대시보드의 페이지 보기 내에서 볼 수 있습니다. 이러한 각 대상으로 보낼 속성을 정확히 사용자 지정할 수 있습니다.

감사 로그

자동 시작

코드 수준 메트릭

받은편지함 구성 오류

다음 태그 중 하나를 설정하면 오류를 생성하는 소프트웨어 버전을 식별하는 데 도움이 됩니다.

  • NEW_RELIC_METADATA_SERVICE_VERSION 배포된 코드 버전(대부분의 경우 1.2.3과 같은 의미 버전)이 포함된 이벤트 데이터에 대한 tagged.service.version을 생성하지만 항상 그런 것은 아닙니다.
  • NEW_RELIC_METADATA_RELEASE_TAG 릴리스 태그(예: v0.1.209)가 포함된 이벤트 데이터에 tagged.releaseTag를 생성합니다. 또는 릴리스-209).
  • NEW_RELIC_METADATA_COMMIT 커밋 샤를 포함하는 이벤트 데이터에 대한 tagged.commit을 생성합니다. 전체 sha를 사용하거나 처음 7자만 사용할 수 있습니다(예: 734713b).

향후 릴리스된 오류 받은 편지함에서는 오류를 생성하는 소프트웨어 버전을 자동으로 추적합니다. 모든 버전 데이터는 CodeStream 에도 표시됩니다.

교차 애플리케이션 추적기

사용자 정의 속성

맞춤 이벤트

데이터 저장소 추적기

비활성화

이 설정을 사용하여 에이전트 시작 중에 계측 유형을 전환합니다.

분산 추적

엘라스틱서치

헤로쿠

무한 추적

수단

메시지 추적기

몽고

프로세스 호스트

갈퀴

규칙

사이드키크

느린 SQL

스팬 이벤트

스트립 예외 메시지

줄무늬

스레드 프로파일러

이용

Copyright © 2024 New Relic Inc.

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