PHP 에이전트를 설치 하기 전에 시스템이 아래 나열된 버전 요구 사항을 충족하는지 확인하세요.
PHP 에이전트 호환성
PHP 버전 | 에이전트 버전 | 현재 지원됨 |
|---|---|---|
8.3 | ≥ | 네 |
8.2 | 지원되는 모든 에이전트 버전 | 네 |
8.1 | 지원되는 모든 에이전트 버전 | 네 |
8.0 | 지원되는 모든 에이전트 버전 | 네 |
7.4 | 지원되는 모든 에이전트 버전 | 네 |
7.3 | 지원되는 모든 에이전트 버전 | 네 |
7.2 | 지원되는 모든 에이전트 버전 | 네 |
7.1 | ≤ | 아니요 |
7.0 | ≤ | 아니요 |
최신 PHP 에이전트 릴리스는 PHP 에이전트 릴리스 노트를 참조하세요.
현재 지원되는 모든 PHP 에이전트 릴리스의 최신 목록을 보려면 PHP 에이전트 EOL 정책을 참조하세요.
지원되지 않는 PHP 버전이나 플랫폼(예: 32비트 OS, FreeBSD 또는 ZTS 빌드)을 사용하는 경우 PHP 에이전트 패키지에 대한 자동 업데이트 메커니즘을 비활성화하는 것이 좋습니다. 자동 업그레이드를 방지하지 못하면 실수로 최신 에이전트 버전이 설치될 수 있습니다. 최신 버전에서는 더 이상 APM 데이터 수집에 필수적인 중요한 기능을 지원하지 않아 모니터링 기능이 중단될 수 있습니다.
자동 업데이트를 비활성화하려면 다음 두 가지 옵션이 있습니다.
패키지 업그레이드를 위해 제외 목록에 PHP 에이전트 패키지를 추가하거나
버전은 지원되지 않는 이전 기능을 지원하는 에이전트 버전에 PHP 에이전트 패키지를 고정합니다. 영향을 받는 PHP 에이전트 패키지는 다음과 같습니다.
newrelic-php5newrelic-php5-commonnewrelic-daemon
Zend 스레드 안전
Zend Thread Safety(ZTS)로 컴파일된 PHP 빌드는 지원되지 않습니다.
적시 생산(JIT)
Just-In-Time 컴파일은 에이전트 릴리스 10.18.0.8 부터 지원됩니다. PHP는 이전 버전의 PHP 에이전트에 대해 JIT를 자동으로 비활성화합니다.
섬유
섬유는 지원되지 않습니다.
권한
PHP 에이전트 설치 requires 루트 액세스:
- PHP 확장 디렉터리에 대한 읽기/쓰기 액세스입니다.
- PHP 구성 디렉터리(권장) 또는
php.ini에서 PHP 구성 데이터에 대한 읽기/쓰기 액세스입니다. - 웹 서버 또는 PHP 프로세스 풀을 다시 시작합니다.
에이전트 does not require 루트 액세스를 실행합니다. 에이전트는 다음 파일에 대한 읽기/쓰기 액세스 권한이 필요합니다(이러한 파일의 위치는 PHP 에이전트 설정에서 사용자 정의 할 수 있음):
라이센스 키
귀하의 뉴렐릭 은 귀하가 계정에 가입할 때 뉴렐릭에서 제공하는 40자리 16진수 문자열입니다. 자세한 내용은 PHP 설치 스크립트 또는 PHP ini 파일의 라이선스 키 설정을 참조하세요.
프로세서
다음 프로세서 아키텍처가 지원됩니다.
- x86_64(amd64라고도 함)
- aarch64(ARM64라고도 함)
중요
aarch64(ARM64) 지원은 PHP 8.0 이상에서만 사용할 수 있습니다.
운영체제
공급업체가 지원 종료를 발표하면(예: Ubuntu의 표준 지원 종료 페이지), 당사는 공급업체의 지원 종료일로부터 1년 동안 해당 최신 버전을 계속 지원합니다. 하지만 사용하고 있는 PHP 버전이 더 이상 공식적으로 지원되지 않을 경우, 지원은 1년도 채 지나지 않아 종료될 수 있습니다.
그렇기 때문에 항상 공급업체에서 공식적으로 지원하는 최신 버전의 OS를 사용하는 것이 좋습니다. 최신 버전의 에이전트는 단종된 OS 버전에서 작동할 수 있지만 더 이상 이전 버전의 PHP 에이전트를 테스트하거나 공식적으로 지원하지 않습니다.
위 정보를 토대로 PHP 에이전트는 아래 표에 나열된 설치 방법을 사용하여 운영 시스템에 설치할 수 있습니다.
운영 체제 | 풀어 주다 | CPU 아키텍처 | 설치 방법 |
|---|---|---|---|
알파인 리눅스 | 3.15, 3.16, 3.17, 3.18, 3.19, 3.20 | x86_64, aarch64 | |
아마존 리눅스 | 2 | x86_64 | |
아마존 리눅스 | 2 | aarch64 | |
아마존 리눅스 | 2023 | x86_64, aarch64 | |
센트OS 리눅스 | 7 | x86_64 | |
센트OS 리눅스 | 7 | aarch64 | |
CentOS 스트림 | 8, 9 | x86_64 | |
CentOS 스트림 | 8, 9 | aarch64 | |
RedHat 엔터프라이즈 리눅스 | 7, 8, 9 | x86_64 | |
RedHat 엔터프라이즈 리눅스 | 7, 8, 9 | aarch64 | |
데비안 | 10, 11, 12 | x86_64 | |
데비안 | 10, 11, 12 | aarch64 | |
우분투 | 20, 22, 24 | x86_64 | |
우분투 | 20, 22, 24 | aarch64 | |
다음이 포함된 Linux 배포판: | 해당 없음 | x86_64, aarch64 |
웹 서버
다음 웹 서버가 지원됩니다.
- Apache 2.2 또는 2.4를 통해
mod_php - PHP-FPM을 사용하여 FastCGI를 지원하는 모든 웹 서버
프레임워크
다음 프레임워크가 지원됩니다.
뼈대 | 버전 | 고려 사항 |
|---|---|---|
드루팔 | 7.x, 8.x, 9.x, 10.x, 11.x | |
줌라 | ≤ 3.7 | 에이전트 버전 ≤ 사용 |
라미나스 | 3.x | |
라라벨 | 6.x, 7.x, 8.x, 9.x, 10.x, 11.x | Laravel Horizon은 지원되지 않습니다. |
루멘 | 6.x, 7.x, 8.x, 9.x, 10.x | |
마젠토 | 2.x (CE 및 EE) | |
미디어위키 | 1.31+ | |
날씬한 | 2.x, 3.x, 4.x | |
심포니 | 4.x, 5.x, 6.x, 7.x | |
워드프레스 | 5.9+ | |
이 | 2.0 | |
젠드 프레임워크 | 3.x |
다른 인기 있는 PHP 프레임워크에 대한 지원을 제안하려면 지원 포럼을 방문하여 Feature Idea 을 만드세요. 자세한 내용은 PHP 프레임워크: 뉴렐릭 지원 통합을 참조하세요.
데이터베이스 및 라이브러리
다음 데이터베이스 및 라이브러리가 지원됩니다.
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
- Laravel 큐잉
중요
Laravel Horizon은 지원되지 않습니다.
보안 요구 사항
데이터 수집을 위한 표준 보안 수단으로 앱 서버는 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 트랜잭션으로 연결합니다. |