• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

문제 신고

New Relic Ruby 에이전트 설치

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

루비 데이터 추가

보석 설치

중요

Docker 컨테이너에서 에이전트를 사용하는 경우 각 컨테이너 내에 에이전트를 설치하십시오.

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

    루비 설치

    코멘트

    Rails 또는 Sinatra를 사용하는 경우

    • Rails : 권장 구성 에서 Rails 3 이상 또는 Rails 2.3을 사용하는 경우 Rails는 자동으로 Bundler.require 를 호출하고 애플리케이션 시작 중에 newrelic_rpm 이 필요하도록 합니다.

    • Sinatra : Sinatra 또는 다른 프레임워크를 사용하는 경우 require 'newrelic_rpm' 을 수동으로 호출해야 합니다. 또한 Infinite Tracing을 사용하는 경우 수동으로 require 'newrelic/infinite_tracing' 을(를) 호출합니다.

      또는 무한 추적도 활성화하는 Bundler.require 를 수동으로 호출합니다.

    Rails 또는 Sinatra를 사용하지 않는 경우

    Sinatra 또는 Rails를 사용하지 않는 랙 애플리케이션에서 자동 브라우저 애플리케이션 모니터링 및 교차 애플리케이션 추적을 사용하려면 에이전트에서 제공하는 추가 랙 미들웨어 를 수동으로 포함해야 합니다. New Relic gem을 목록에서 가능한 한 낮게 배치하여 gem이 초기화될 때 그 위의 프레임워크가 계측될 수 있도록 합니다.

구성 파일 설치

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

  1. 아직 만들지 않았다면 New Relic 계정 을 만드십시오. 영원히 무료입니다. 또는 로그인 합니다.
  2. 계정 드롭다운 에서 계정 설정 을 선택합니다.
  3. 계정 설정 페이지에서 깨끗한 구성 파일 다운로드 섹션을 찾아 newrelic.yml 파일을 클릭합니다.
  4. newrelic.yml 파일을 애플리케이션의 config 하위 디렉토리에 복사합니다.
  5. 기본 응용 프로그램 이름을 의미 있는 이름으로 변경합니다 .

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

newrelic install --license_key="YOUR_KEY" "My application"

기존 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를 사용하지 않는 경우 다음 절차를 따르세요.

루비 설치

코멘트

번들러가 없는 Rails 2.1 - 2.3

  1. gem install newrelic_rpm 을 사용하여 gem을 설치합니다.

  2. environment.rb 을 수정하고 초기화 블록에 추가합니다.

    config.gem "newrelic_rpm"
  3. 무한 추적을 활성화하는 경우 environment.rb 파일의 다음 줄에 다음을 추가합니다.

    config.gem "newrelic-infinite_tracing"

2.1 이전의 레일

New Relic은 공식적으로 2.1 이전의 Rails 버전을 지원하지 않습니다. 그러나 New Relic for Rails 버전 2.0.*을 사용하려면 environment.rb 을 편집하고 initializer: 블록 뒤에 다음 문을 추가하세요.

require "newrelic_rpm"

무한 추적

무한 추적을 활성화하는 경우 environment.rb 파일의 다음 줄에 다음을 추가합니다.

require "newrelic/infinite_tracing"
Copyright © 2022 New Relic Inc.