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를 사용하는지에 따라 다릅니다.

   Ruby installation	Comments
   Rails, Roda 또는 Sinatra를 사용하는 경우	Rails: 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 에 대한 모든 참조를 제거하십시오.