비표준 PHP 설치를 사용하는 경우 이 절차에 따라 New Relic을 올바르게 설치하십시오. 이것은 기본 설치 프로그램이 PHP 설치를 찾지 못하는 경우에 일반적입니다(예: 자체 컴파일된 PHP 또는 자체 포함된 PHP 스택이 있는 경우).
중요
설치 프로세스의 일부로 기본 응용 프로그램 이름 을 의미 있는 이름으로 변경합니다.
요구 사항
PHP의 명령줄 버전( php -i )을 사용하거나 phpinfo() 의 출력을 확인하여 다음을 확인합니다.
- PHP 확장 버전(
20090626,20100525,20121212,20131226,20151012또는20160303) - 확장 또는 모듈 설치 디렉토리
- PHP 버전이 ZTS(Zend Thread Safety) 지원으로 컴파일되었는지 여부
ZTS 옵션은 PHP 에이전트 버전 9.17 이하 에만 적용됩니다. ZTS는 PHP 버전 9.18 이상에서 사용할 수 없습니다.
명령줄 newrelic-install 스크립트 사용(권장)
다음 옵션 중 하나를 사용하여 올바른 디렉토리에서 New Relic을 가리킵니다.
해당 디렉토리에서
newrelic-install스크립트를 호출합니다. 서버와 경로에 따라 설치 스크립트는 시스템에서 다른 버전의 PHP를 찾을 수 있습니다. 목록에서 특정 버전을 선택합니다.
자세한 내용은 PHP 설치 스크립트 를 참조하십시오.
수동으로 새 유물 설치
설치 스크립트를 사용하지 않으려면 완전 수동 설치를 수행할 수 있습니다. PHP 설치에 대한 정보 를 수집하십시오. phpinfo() 에서 적절한 값을 검토하고 얻을 수 있습니다. 그런 다음 파일을 수동으로 만들고 링크하거나 복사합니다.
phpinfo()에서 설치 매개변수 가져오기
이 프로세스가 작동하지 않으면 phpinfo() 에서 올바른 정보를 얻고 적절한 설정을 환경 변수로 시스템에 전달할 수 있습니다.
phpinfo() | Notes |
|---|---|
| 이것은 |
| 이것은
|
| 이것은 PHP Core 섹션에서 |
| ZTS 옵션은 PHP 에이전트 버전 9.19.0.309 이하 에만 적용됩니다.ZTS는 PHP 에이전트 버전 9.20.0.310 이상에서 사용할 수 없습니다. ZTS가 컴파일되었는지 확인하려면
|
| New Relic 에이전트 설치 디렉터리의 기본 디렉터리입니다. 예를 들어, |
이 정보를 사용하여 다음 명령을 실행하여 PHP 모듈을 설치하십시오. 예제의 값을 실제 설정으로 조정해야 합니다.
$NRBASEDIR=/usr/lib/newrelic-php5; export NRBASEDIR$ MODULEDIR=/usr/lib/php/modules; export MODULEDIR$ ARCH=x64; export ARCH$ PHPAPI=20090626; export PHPAPI$ PHPZTS="-zts"; export PHPZTS$ rm -f $MODULEDIR/newrelic.so$ ln -s $NRBASEDIR/agent/$ARCH/newrelic-${PHPAPI}${PHPZTS}.so \> $MODULEDIR/newrelic.so수동 구성
다음 단계는 구성입니다.
PHP 설치가 추가 구성 파일을 읽는 디렉토리에
$NRBASEDIR/scripts/newrelic.ini.template을 복사하고 이름을newrelic.ini로 바꿉니다.목적지를 결정하려면
Scan this dir for additional .ini files이라는 항목에 대한phpinfo()출력을 확인하십시오. 나열된 디렉토리가(none)이면 이 파일의 설정을 나열된 PHP 구성 파일(일반적으로php.ini)에 추가합니다.newrelic.ini파일의 클러스터 키 설정을 로 바꿉니다. 또한 필요에 따라 다른 세션도 변경합니다(예:newrelic.appname).$NRBASEDIR/daemon/newrelic-daemon.$architecture을(를)/usr/bin/newrelic-daemon에 복사합니다.시스템에 따라 $architecture는 x86 또는 x64가 됩니다.
디스패처/웹 서버를 다시 시작합니다.
사이트가 제대로 작동하는지 확인하십시오. 그렇지 않은 경우 생성한
newrelic.ini또는newrelic.so을 제거하고 디스패처/웹 서버를 다시 시작하여 이전 작업을 복원합니다.웹 서버/디스패처 로그 파일(
newrelic아님 )을 검사하여 문제를 확인합니다. 여전히 도움이 필요하면 support.newrelic.com 에서 지원을 받으십시오.
설치 확인
newrelic 섹션의 phpinfo() 페이지를 조사하여 다시 시작한 후 에이전트가 설치되었는지 확인하십시오. 에이전트가 성공적으로 설치된 것으로 보이면 시스템에서 두 개의 newrelic-daemon 프로세스가 실행 중인지 확인하십시오.
RedHat 기반 시스템의 경우:
bash$ps -aef | grep newrelic-daemon데비안 기반 시스템의 경우:
bash$ps aux | grep newrelic-daemon
앱에서 트래픽을 생성한 후 APM Summary 페이지 에 결과가 나타날 때까지 3-5분 정도 기다립니다.