PHP 에이전트를 설치 하기 전에 시스템이 아래 나열된 버전 요구 사항을 충족하는지 확인하세요.
PHP 릴리스
다음 PHP 버전이 지원됩니다:
버전 | 호환성 참고사항 |
---|---|
7.0 - 7.4 | PHP 버전 7.0 및 7.1에 대한 지원은 2024년 6월 1일에 EOL 됩니다. |
8.0 - 8.3 | PHP 8.x가 관찰 확장(PHP 에이전트)을 감지하면 Just-In-Time 컴파일이 비활성화됩니다. PHP 8.1 이상은 Fibers를 지원하지 않습니다. |
PHP 에이전트 호환성
최신 PHP 에이전트 릴리스는 PHP 에이전트 릴리스 노트를 참조하세요.
ZTS(Zend Thread Safety)로 컴파일된 PHP 빌드의 경우 PHP 에이전트 9.19 이하에서만 이러한 빌드를 지원합니다.
지원되지 않는 PHP 버전이나 플랫폼(예: 32비트 OS, FreeBSD 또는 ZTS 빌드)을 사용하는 경우 PHP 에이전트 패키지에 대한 자동 업데이트 메커니즘을 비활성화하는 것이 좋습니다. 자동 업그레이드를 방지하지 못하면 실수로 최신 에이전트 버전이 설치될 수 있습니다. 최신 버전에서는 더 이상 APM 데이터 수집에 필수적인 중요한 기능을 지원하지 않아 모니터링 기능이 중단될 수 있습니다.
자동 업데이트를 비활성화하려면 다음 두 가지 옵션이 있습니다.
패키지 업그레이드를 위해 제외 목록에 PHP 에이전트 패키지를 추가하거나
버전은 지원되지 않는 이전 기능을 지원하는 에이전트 버전에 PHP 에이전트 패키지를 고정합니다. 영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.
newrelic-php5
newrelic-php5-common
newrelic-daemon
권한
PHP 에이전트를 설치하려면 다음에 대한 루트 액세스가 필요합니다 .
- PHP 확장 디렉터리에 대한 읽기/쓰기 액세스입니다.
- PHP 구성 디렉터리(권장) 또는
php.ini
에서 PHP 구성 데이터에 대한 읽기/쓰기 액세스입니다. - 웹 서버 또는 PHP 프로세스 풀을 다시 시작합니다.
에이전트를 실행하는 데는 루트 액세스가 필요하지 않습니다 . 에이전트에는 다음 파일에 대한 읽기/쓰기 액세스 권한이 필요합니다(이러한 파일의 위치는 PHP 에이전트 설정에서 사용자 정의 할 수 있음).
라이센스 키
당신의 New Relic 는 계정에 가입할 때 New Relic이 제공하는 40자의 16진수 문자열입니다. 자세한 내용은 PHP 설치 스크립트 또는 PHP ini
파일의 라이센스 키 설정을 참조하세요.
프로세서
다음 프로세서가 지원됩니다.
- 인텔(및 호환) 플랫폼
- ARM64
운영체제
공급업체가 지원 종료를 발표하면(예: Ubuntu의 표준 지원 종료 페이지), 우리는 1년 동안 해당 최신 버전을 계속 지원할 것입니다. 그러나 사용 중인 PHP 버전이 더 이상 공식적으로 지원되지 않는 경우 지원은 1년 이내에 종료될 수 있습니다.
그렇기 때문에 항상 공급업체에서 공식적으로 지원하는 최신 버전의 OS를 사용하는 것이 좋습니다. 최신 버전의 에이전트는 단종된 OS 버전에서 작동할 수 있지만 더 이상 이전 버전의 PHP 에이전트를 테스트하거나 공식적으로 지원하지 않습니다.
PHP 에이전트는 아래 표에 나열된 운영 체제를 지원합니다.
운영 체제 | 지원되는 공급업체 | 호환성 참고사항 |
---|---|---|
리눅스(x86_64) |
| |
리눅스(ARM64) |
|
|
웹 서버
다음 웹 서버가 지원됩니다.
- Apache 2.2 또는 2.4를 통해
mod_php
- PHP-FPM을 사용하여 FastCGI를 지원하는 모든 웹 서버
프레임워크
다음 프레임워크가 지원됩니다.
케이크PHP 2.x | Magento 1.x 및 2.x, CE 및 EE |
코드이그나이터 2.x | 미디어위키 |
슬림 2.x, 3.x 및 4.x | |
줌라 3.x 중요Joomla 3.x는 PHP 8.x에서 지원되지 않습니다. | 심포니 3.x, 4.x 및 5.x |
라미나스 3.x | |
라라벨 6.x, 7.x, 8.x, 9.x, 10.x | 루멘 6.x, 7.x, 8.x, 9.x 및 10.x |
Zend 프레임워크 1.x, 2.x 및 3.x | 이이 1.x |
PHP 에이전트의 프레임워크 목록은 계속해서 증가하고 있습니다. 사용 중인 프레임워크가 여기에 나열되지 않더라도 PHP 에이전트는 앱에 대한 유용한 정보를 제공할 수 있습니다.
다른 널리 사용되는 PHP 프레임워크에 대한 지원을 제안하려면 지원 포럼을 방문하여 Feature Idea
를 만드세요. 자세한 내용은 PHP 프레임워크: New Relic에 대한 지원 통합을 참조하세요.
데이터베이스 및 라이브러리
다음 데이터베이스 및 라이브러리가 지원됩니다.
Firebird(PDO 드라이버 전용) | 신탁 |
인포믹스 | PDO 드라이버 |
멤캐시드 | 포스트그레스 |
MongoDB | |
Microsoft SQL Server(PDO 드라이버 전용) | Redis |
MySQL | SQLite |
ODBC(PDO 드라이버만 해당) | Sybase(PDO 드라이버 전용) |
기타 타사 모니터링 소프트웨어
귀하의 애플리케이션이 추가 모니터링 소프트웨어를 사용하는 경우 당사 에이전트가 올바르게 작동한다고 보장할 수 없으며 기술 지원을 제공할 수 없습니다. 자세한 내용은 다른 모니터링 소프트웨어를 사용할 때 발생하는 오류를 참조하세요.
인스턴스 세부정보
New Relic은 다양한 데이터베이스 및 데이터베이스 드라이버에 대한 인스턴스 세부 정보를 수집합니다. 다음 데이터베이스 및 확장이 지원됩니다.
호스트 정보 수집을 비활성화하려면 newrelic.ini
파일에서 다음 중 하나를 구성합니다.
- 다음을 사용하여 인스턴스 보고를 비활성화합니다.
newrelic.datastore_tracer.instance_reporting.enabled = false
- 데이터베이스 이름을 생략하세요.
newrelic.datastore_tracer.database_name_reporting.enabled = false
현재 PHP 에이전트에 대해 나열되지 않은 데이터 저장소에서 인스턴스 수준 정보를 요청하려면 support.newrelic.com 에서 지원을 받으세요.
메시지 큐잉
다음은 메시지 대기열을 지원합니다.
- HTTP
- 라라벨 큐잉
보안 요구 사항
데이터 수집을 위한 표준 보안 수단으로 앱 서버는 SHA-2(256비트)를 지원해야 합니다. SHA-1은 지원되지 않습니다.
New Relic 기능 지원
PHP 에이전트는 다른 New Relic 기능과 통합되어 엔드 투 엔드 가시성을 제공합니다.
제품 | 완성 |
---|---|
자동 계측을 활성화 하면 PHP 에이전트가 브라우저 에이전트의 JS 코드를 자동으로 삽입합니다. 브라우저 삽입을 활성화한 후 APM 요약 페이지 에서 데이터를 보고 특정 앱에 대한 APM과 브라우저 데이터 간에 빠르게 전환할 수 있습니다. 구성 옵션 및 수동 계측에 대해서는 브라우저 모니터링 및 PHP 에이전트를 참조하세요. | |
New Relic CodeStream은 IDE에 관찰 기능을 제공하여 코드가 프로덕션 환경에서 메서드 수준에서 어떻게 수행되고 있는지 보여줍니다. PHP 버전 7.0 - 7.4 및 8.0 - 8.3은 코드 수준 측정항목을 보고합니다(릴리스 10.4.0부터). | |
인프라와 APM 에이전트를 동일한 호스트에 설치하면 자동으로 서로를 감지합니다. 그런 다음 APM UI에서 호스트 목록을 보고 인프라 UI에서 APM 앱별로 호스트를 필터링할 수 있습니다. 자세한 정보는 인프라 모니터링의 APM 데이터를 참조하십시오. | |
PHP 에이전트는 Monolog 2 및 3 라이브러리에 대한 컨텍스트 내 로그 기능을 지원합니다. | |
PHP 에이전트는 NRQL 쿼리에 대한 기본 이벤트 및 속성 을 보냅니다. 고급 분석을 위해 사용자 정의 이벤트를 기록 할 수도 있습니다. | |
합성 트랜잭션 추적 은 합성 모니터의 요청을 기본 APM 트랜잭션으로 연결합니다. |