New Relic Ruby 에이전트 설치

Ruby 에이전트는 코드를 자동 계측하므로 애플리케이션 모니터링을 시작할 수 있습니다. 런처를 사용하거나 이 문서의 지침에 따라 기본 Ruby 에이전트 설치를 완료할 수 있습니다.

보석 설치

1. Ruby 에이전트의 gem은 rubygems.org 에서 newrelic_rpm 으로 사용할 수 있습니다. Bundler를 사용하는 애플리케이션의 경우 이 gem을 Gemfile에 추가하세요.

   gem 'newrelic_rpm'

   복사

2. Infinite Tracing을 사용하기 위해 Infinite Tracing gem은 rubygems.org에서 newrelic-infinite_tracing 으로 사용할 수도 있습니다. Bundler를 사용하는 애플리케이션의 경우 Gemfile에 Infinite Tracing gem을 추가로 포함합니다.

   gem 'newrelic-infinite_tracing'

   복사

3. 다음 단계는 Rails, Roda 또는 Sinatra를 사용하는지에 따라 다릅니다.

   루비 설치	코멘트
   Rails, Roda 또는 Sinatra를 사용하는 경우	Rails : 권장 구성 에서 Rails 3 이상 또는 Rails 2.3을 사용하는 경우 Rails는 자동으로 Bundler.require 를 호출하고 애플리케이션 시작 중에 newrelic_rpm 이 필요하도록 합니다. Roda, Sinatra: Roda, Sinatra 또는 다른 프레임워크를 사용하는 경우 require 'newrelic_rpm' 수동으로 호출해야 합니다. 또한 무한 추적을 사용하는 경우 수동으로 require 'newrelic/infinite_tracing' 호출하십시오. 또는 무한 추적도 활성화하는 Bundler.require 를 수동으로 호출합니다.
   Rails, Roda 또는 Sinatra를 사용하지 않는 경우	Roda, Sinatra 또는 Rails를 사용 하지 않는 Rack 애플리케이션에서 자동 브라우저 애플리케이션 모니터링 및 교차 애플리케이션 추적을 사용하려면 에이전트에서 제공하는 추가 Rack 미들웨어를 수동으로 포함해야 합니다. New Relic gem을 목록에서 가능한 한 아래에 배치하여 gem이 초기화될 때 그 위에 있는 프레임워크가 계측되도록 합니다.

구성 파일 설치

에이전트를 설치한 후 newrelic.yml 구성 파일을 설치하고 앱 이름을 지정해야 합니다.

1. GitHub 저장소에서 newrelic.yml 사본을 다운로드하세요.

2. newrelic.yml 파일을 애플리케이션의 config 하위 디렉토리에 복사합니다.

3. 포함하도록 license_key 값을 편집합니다.

   계정 라이선스 키

   .

4. app_name 값을 의미 있는 이름 으로 편집합니다.

또는 다음 명령을 사용하여 수동으로 newrelic.yml 파일을 생성할 수 있습니다.

newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"

기존 newrelic.yml 을 덮어써야 하는 경우 이 명령과 함께 --force 옵션을 사용할 수도 있습니다.

APM 및 인프라 데이터에 대한 로그 보기

또한 로그와 애플리케이션의 데이터를 함께 가져와 더 쉽고 빠르게 문제를 해결할 수 있습니다. 컨텍스트의 로그를 사용하면 앱의 UI에서 직접 오류 및 추적과 관련된 로그 메시지를 볼 수 있습니다. Kubernetes 클러스터와 같은 인프라 데이터 컨텍스트에서 로그를 볼 수도 있습니다. 다른 UI 페이지로 전환할 필요가 없습니다.

에이전트 업데이트

Ruby 에이전트 버전 업그레이드 를 참조하십시오.

프로덕션 환경 외부에 에이전트 설치

일반적으로 프로덕션 환경에 Ruby 에이전트를 설치합니다. 개발 환경 또는 localhost 환경에서 Ruby 에이전트를 시험해 보려면 newrelic.yml 파일의 관련 environment: 블록에서 monitor_mode 구성 값이 true 으로 설정되었는지 확인하십시오.

예를 들어 개발 환경 에 New Relic을 배포하고 앱의 성능 측정항목을 계속 볼 수 있으려면 development: 블록에서 monitor_mode 구성 값을 true 로 설정합니다.

Ruby 에이전트 gem 제거

Bundler를 사용하여 Ruby 에이전트를 제거하려면 Gemfile에서 gem 'newrelic_rpm' 를 제거하세요. Bundler를 사용하지 않는 경우 environment.rb 파일에서 newrelic_rpm 에 대한 모든 참조를 제거하십시오.

이전 버전의 Rails에 설치

Rails 2.x에 Ruby 에이전트를 설치하고 Bundler를 사용하지 않는 경우 다음 절차를 따르세요.

require "newrelic_rpm"

require "newrelic/infinite_tracing"