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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

문제 신고

PHP 에이전트 설치: 비표준 PHP(고급)

비표준 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 스크립트 사용(권장)

  1. 다음 옵션 중 하나를 사용하여 올바른 디렉토리에서 New Relic을 가리킵니다.

  2. 해당 디렉토리에서 newrelic-install 스크립트를 호출합니다. 서버와 경로에 따라 설치 스크립트는 시스템에서 다른 버전의 PHP를 찾을 수 있습니다. 목록에서 특정 버전을 선택합니다.

자세한 내용은 PHP 설치 스크립트 를 참조하십시오.

수동으로 새 유물 설치

설치 스크립트를 사용하지 않으려면 완전 수동 설치를 수행할 수 있습니다. PHP 설치에 대한 정보 를 수집하십시오. phpinfo() 에서 적절한 값을 검토하고 얻을 수 있습니다. 그런 다음 파일을 수동으로 만들고 링크하거나 복사합니다.

phpinfo()에서 설치 매개변수 가져오기

이 프로세스가 작동하지 않으면 phpinfo() 에서 올바른 정보를 얻고 적절한 설정을 환경 변수로 시스템에 전달할 수 있습니다.

phpinfo()

Notes

PHPAPI

이것은 phpinfo() 헤더에 PHP Extension 으로 표시됩니다.

ARCH

이것은 file /path/to/php 을 실행하여 결정할 수 있습니다.

  • ELF-32 에 대한 참조가 표시되면 ARCHx86 입니다.
  • ELF-64 에 대한 참조가 표시되면 ARCHx64 입니다.

MODULEDIR

이것은 PHP Core 섹션에서 extension_dir 으로 표시됩니다.

PHPZTS

ZTS 옵션은 PHP 에이전트 버전 9.19.0.309 이하 에만 적용됩니다.ZTS는 PHP 에이전트 버전 9.20.0.310 이상에서 사용할 수 없습니다.

ZTS가 컴파일되었는지 확인하려면 phpinfo() 출력 상단에서 Thread Safety 설정을 찾으세요.

  • 비활성화된 경우 PHPZTS 이(가) 비어 있습니다.
  • 이것이 활성화되면 PHPZTS 은 문자열 -zts 이며, 여기에는 언급된 대로 선행 하이픈이 포함됩니다.

NRBASEDIR

New Relic 에이전트 설치 디렉터리의 기본 디렉터리입니다. 예를 들어, /usr/lib/newrelic-php5 또는 tarball 설치를 위해 tar 파일을 추출한 디렉토리입니다.

이 정보를 사용하여 다음 명령을 실행하여 PHP 모듈을 설치하십시오. 예제의 값을 실제 설정으로 조정해야 합니다.

bash
$
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

수동 구성

다음 단계는 구성입니다.

  1. PHP 설치가 추가 구성 파일을 읽는 디렉토리에 $NRBASEDIR/scripts/newrelic.ini.template 을 복사하고 이름을 newrelic.ini 로 바꿉니다.

    목적지를 결정하려면 Scan this dir for additional .ini files 이라는 항목에 대한 phpinfo() 출력을 확인하십시오. 나열된 디렉토리가 (none) 이면 이 파일의 설정을 나열된 PHP 구성 파일(일반적으로 php.ini )에 추가합니다.

  2. newrelic.ini 파일의 라이센스 키 설정을 . 필요에 따라 다른 세션도 변경합니다(예: newrelic.appname ).

  3. $NRBASEDIR/daemon/newrelic-daemon.$architecture 을(를) /usr/bin/newrelic-daemon 에 복사합니다.

    시스템에 따라 $architecture는 x86 또는 x64가 됩니다.

  4. 디스패처/웹 서버를 다시 시작합니다.

  5. 사이트가 제대로 작동하는지 확인하십시오. 그렇지 않은 경우 생성한 newrelic.ini 또는 newrelic.so 을 제거하고 디스패처/웹 서버를 다시 시작하여 이전 작업을 복원합니다.

  6. 웹 서버/디스패처 로그 파일( newrelic 아님 )을 검사하여 문제를 확인합니다. 여전히 도움이 필요하면 support.newrelic.com 에서 지원을 받으십시오.

설치 확인

newrelic 섹션의 phpinfo() 페이지를 조사하여 다시 시작한 후 에이전트가 설치되었는지 확인하십시오. 에이전트가 성공적으로 설치된 것으로 보이면 시스템에서 두 개의 newrelic-daemon 프로세스가 실행 중인지 확인하십시오.

  • RedHat 기반 시스템의 경우:

    bash
    $
    ps -aef | grep newrelic-daemon
  • 데비안 기반 시스템의 경우:

    bash
    $
    ps aux | grep newrelic-daemon

앱에서 약간의 트래픽을 생성한 다음 APM 요약 페이지 에 결과가 도착할 때까지 3-5분 정도 기다립니다.

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

Copyright © 2024 New Relic Inc.

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