PHP 에이전트 및 Heroku

Heroku 는 PHP를 포함한 다양한 언어로 웹 호스팅을 위한 PaaS(Platform as a Service) 솔루션입니다. 뉴렐릭을 사용하면 Heroku 및 의 APM지표로 브라우저 모니터링확장할 수 있습니다.

지원서 준비

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

PHP 에이전트 설치

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

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

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가 사용자 정의 구성 파일을 사용하도록 지시합니다.

   bash

   카피

   $
   heroku config:set NEW_RELIC_CONFIG_FILE=newrelic.ini

애플리케이션 이름 지정

각 앱의 지표가 별도로 보고되도록 하려면 각 앱에 기술 이름을 지정하세요. 애플리케이션 이름의 기본값은 PHP Application on Heroku 입니다.

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

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

   bash

   카피

   $
   heroku config:set NEW_RELIC_APP_NAME='YOUR_APP_NAME'

2. 앱의 이름 변경을 확인하려면 다음을 실행하세요.

   bash

   카피

   $
   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 도구 벨트 명령을 실행하십시오.

   bash

   카피

   $
   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

$
heroku config:unset NEW_RELIC_LOG_LEVEL