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

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

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

문제 신고

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

    루비 설치

    코멘트

    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 에 대한 모든 참조를 제거하십시오.

이전 버전의 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 © 2024 New Relic Inc.

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