• 로그인지금 시작하기

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

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

문제 신고

PHP 에이전트 및 Heroku

Heroku 는 PHP를 포함한 다양한 언어로 웹 애플리케이션을 호스팅하기 위한 PaaS(Platform as a Service) 솔루션입니다. New Relic을 사용하면 APM브라우저 모니터링 의 메트릭으로 Heroku를 확장할 수 있습니다.

지원서 준비

PHP 에이전트를 설치하기 전에 PHP 웹 애플리케이션이 설치되어 Heroku에서 실행 중인지 확인하십시오. 자세한 내용 은 Heroku에서 PHP 시작하기를 참조하십시오.

PHP 에이전트 설치

Heroku에 PHP 앱을 배포한 후 PHP 에이전트를 설치합니다.

몇 분 안에 데이터가 APM 요약 페이지 에 나타나기 시작합니다. 데이터가 표시되지 않으면 이 문서의 확인문제 해결 절차를 참조하십시오.

Heroku에서 에이전트 구성

Heroku는 앱의 기본 환경 변수를 자동으로 구성합니다. 설정을 사용자 지정하려면 newrelic.ini 파일을 만들고 Heroku에 업로드합니다.

  1. newrelic.ini_.heroku [INI | 16KB].

  2. 파일 이름을 newrelic.ini_.heroku에서 newrelic.ini바꿉니다 .

  3. newrelic.ini 를 프로젝트 저장소의 루트 디렉터리에 복사합니다.

  4. PHP 에이전트 구성 에 설명된 대로 설정을 사용자 지정합니다.

    주의

    newrelic.license , newrelic.loglevel 또는 newrelic.appname 을 변경하지 마십시오. 이러한 설정은 Heroku 도구 벨트에 의해 구성됩니다.

  5. 구성 파일 변경 사항을 저장소에 커밋하고 변경 사항을 Heroku로 푸시합니다.

  6. 이 Heroku 도구 벨트 명령을 통해 Heroku가 사용자 정의 구성 파일을 사용하도록 지시합니다.

    heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

애플리케이션 이름 지정

각 앱의 측정항목이 별도로 보고되도록 하려면 각 앱에 설명이 포함된 이름을 지정 하세요. 애플리케이션 이름은 기본적 으로 Heroku의 PHP 애플리케이션입니다 .

New Relic은 앱 이름을 사용하여 데이터를 집계합니다. 이 이름을 변경하지 않으면 New Relic은 동일한 이름으로 설치한 추가 PHP 앱 각각의 데이터를 집계합니다.

  1. 애플리케이션의 이름을 지정하려면 다음 Heroku 도구 벨트 명령을 실행하십시오.

    heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'
  2. 앱의 이름 변경을 확인하려면 다음을 실행하세요.

    heroku run env | grep NEW_RELIC_APP_NAME

확인 메시지가 새 앱 이름을 반환하는지 확인합니다.

NEW_RELIC_APP_NAME=YOUR_APP_NAME

설치 확인

Heroku가 New Relic 애드온을 설치했는지 확인하려면 다음 Heroku 도구 벨트 명령을 실행하십시오.

heroku run env | grep NEW_RELIC

이것은 Heroku에서 New Relic 환경 변수의 목록을 생성할 것입니다. 에이전트는 이러한 환경 변수를 사용하여 데이터를 보고할 계정을 결정합니다. 최소한 다음 변수가 표시되어야 합니다.

NEW_RELIC_LICENSE_KEY='YOUR_LICENSE_KEY'
NEW_RELIC_LOG_LEVEL="warning"
NEW_RELIC_APP_NAME="YOUR_APP_NAME"

phpinfo 를 사용하여 앱이 계측되고 있는지 확인할 수도 있습니다.

Heroku에서 에이전트 문제 해결

Heroku의 PHP 에이전트 문제를 해결하려면 Heroku 웹 서버 로그에 저장된 로그 파일을 검사하십시오.

  1. 웹 서버 로그를 보려면 다음 Heroku 도구 벨트 명령을 실행하십시오.

    heroku logs -t | tee newrelic.log
  2. 로그 파일을 사용하여 문제를 해결하십시오.

  3. 추가 지원이 필요한 경우 support.newrelic.com에서 지원을 받으 십시오.

PHP 에이전트의 기본값은 warning 로그 수준 입니다. New Relic Support는 verbosedebug 로그 수준에서 로그를 요청할 수도 있습니다. 로그 수준을 verbosedebug 로 변경하려면 다음 Heroku 도구 벨트 명령을 실행하십시오.

heroku config:set NEW_RELIC_LOG_LEVEL=verbosedebug

주의

verbosedebug 로그 수준은 많은 양의 데이터를 빠르게 생성합니다. New Relic Support에서 요청하는 경우에만 이 설정을 사용하고 이 Heroku 도구 벨트 명령을 실행하여 출력을 수집하는 즉시 이 설정을 제거하십시오.

heroku config:unset NEW_RELIC_LOG_LEVEL

이 문서가 설치하는데 도움이 되셨나요?

Copyright © 2023 New Relic Inc.

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