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

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

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

문제 신고

New Relic Ruby 에이전트 설치

|View as Markdown (English)

루비 에이전트는 코드를 자동으로 계측하므로 애플리케이션 모니터링을 시작할 수 있습니다.

팁

Kubernetes에서 실행 중이십니까? Kubernetes APM 자동 첨부를 참조하십시오.

전제 조건

시작하기 전에 이 요구 사항을 확인해 주십시오.

요구 사항

세부

New Relic 계정

뉴렐릭 계정과 이(가) 필요합니다. 시작하기 전에 준비해 주십시오.

루비 버전

지원되는 루비 버전에 대해서는 루비 에이전트 요구사항 및 지원되는 프레임워크를 참조하십시오.

운영 체제

UNIX 계열 운영 시스템: Linux, Solaris, FreeBSD 및 macOS. 자세한 내용은 루비 에이전트 요구 사항 및 지원되는 프레임워크를 참조하십시오.

보석 설치

Gemfile에 루비 에이전트 gem을 추가하십시오:

gem 'newrelic_rpm'

그런 다음 실행하십시오:

bash
$
bundle install

중요

도커 컨테이너에서 에이전트를 사용하는 경우 각 컨테이너 내에 에이전트를 설치하십시오. 도커 기반 배포 예제는 GAE 플렉서블 환경에 설치를 참조하십시오.

프레임워크별 참고 사항:

  • Rails: Rails는 자동으로 Bundler.require을(를) 호출하므로 추가 단계 없이 시작 시 newrelic_rpm이(가) 필요합니다.
  • Roda 또는 Sinatra: 애플리케이션에서 수동으로 require 'newrelic_rpm'을(를) 호출해야 합니다.
  • 기타 Rack 앱: 자동 브라우저 모니터링을 사용하려면 에이전트에서 제공하는 Rack 미들웨어를 수동으로 포함하십시오.

에이전트 구성

뉴렐릭 GitHub 저장소에서 newrelic.yml을(를) 다운로드하여 애플리케이션의 config 디렉터리에 복사하십시오.

라이브로 전환하기 전에 반드시 변경해야 하는 단 두 가지 설정은 다음과 같습니다:

  1. 에 license_key을(를) 설정합니다.
  2. app_name을(를) 애플리케이션의 의미 있는 이름으로 설정해 주십시오.

또는 CLI를 사용하여 구성 파일을 생성하십시오:

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

데이터가 흐르고 있는지 확인

  1. 웹 서버를 다시 시작하십시오.

  2. 애플리케이션에 최소 두 개의 requests를 보내십시오.

  3. 2~3분 기다린 후, one.newrelic.com > APM을 열고 이름으로 앱을 찾아보십시오.

팁

앱이 표시되지 않습니까? 데이터가 표시되지 않음(루비)을 참조하십시오.

Copyright © 2026 New Relic Inc.

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