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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

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.