구성 개요

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

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

구성 방법 및 우선 순위

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

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

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

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

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

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

구성 파일 옵션 보기 및 편집

루비 에이전트의 newrelic.yml 은 표준 YAML 설정 파일입니다. 일반적으로 상단에 Defaults 섹션이 포함되고 하단에는 각 애플리케이션 환경(Development, Test, Staging, Production)에 대한 섹션이 포함됩니다.

루비 에이전트는 특정 환경 변수를 살펴보고 newrelic.yml 구성 파일에서 읽을 섹션을 결정하여 에이전트 환경을 파생시킵니다. 이것은 운영 환경에서 log_level 구성 설정에 info 사용하고 개발 환경에서 더 자세한 log_level 구성 설정(예: debug)을 원할 때 유용할 수 있습니다.

다음은 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

루비 에이전트는 인력 환경을 찾기 위해 다음 환경 변수를 순서대로 찾습니다.

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

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

Rails 앱에서 루비 에이전트를 실행할 때 에이전트는 먼저 NEW_RELIC_ENV 환경 변수를 검색하여 내장 환경과 사용할 newrelic.yml 의 섹션을 찾습니다. NEW_RELIC_ENV 가 없으면 에이전트는 Rails 환경(RAILS_ENV)을 사용합니다.

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

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

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

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

구성 파일 업데이트

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

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

설정 참조

모든 설정 항목은 아래 하위 페이지에 문서화되어 있습니다. 각 설정은 유형, 기본값 및 해당하는 환경 변수를 표시합니다.