New Relic의 PHP 에이전트는 에이전트 동작을 사용자 정의하기 위한 API 를 제공합니다. 에이전트는 널리 사용되는 많은 PHP 프레임워크 를 자동으로 계측하지만 PHP API를 사용하여 기본적으로 에이전트가 아직 계측하지 않은 활동을 계측할 수 있습니다.
이 가이드에서는 몇 가지 일반적인 작업에 대한 PHP API 호출에 대해 설명합니다. 예를 들어:
팁
디렉토리당 또는 newrelic.ini 에서 이러한 옵션을 많이 설정할 수도 있습니다. API를 통해 설정하는 경우 API가 다른 방법보다 우선합니다 .
오류 확인 또는 무시
일반적으로 에이전트는 오류를 자동으로 감지합니다. 그러나 에이전트를 사용하여 수동으로 오류를 표시 할 수 있습니다.
원하는 경우... | 이게 ... |
|---|---|
에이전트가 자동으로 보고하지 않는 오류 보고 |
|
오류 무시 |
|
트랜잭션의 메타데이터 향상
때로는 대상 코드가 New Relic에서 볼 수 있지만 메서드의 일부 세부 정보는 유용하지 않습니다. 예를 들어:
- 기본 이름이 도움이 되지 않거나 측정항목 그룹화 문제 를 일으키고 있습니다.
- NRQL 쿼리로 필터링할 수 있도록 트랜잭션 또는 범위에 사용자 지정 속성 을 추가하려고 합니다.
New Relic에서 이미 볼 수 있는 트랜잭션을 New Relic에서 계측하는 방법을 변경하려면 다음 방법을 사용하세요.
원하는 경우... | 이게 ... |
|---|---|
트랜잭션 이름 변경 |
|
거래 또는 범위에 메타데이터(예: 고객의 계정 이름 또는 구독 수준)를 추가합니다. | 사용자 정의 속성 을 사용하십시오. 트랜잭션 및 범위(활성화된 경우)에 추가될 사용자 정의 속성은 스팬에만 추가될 사용자 정의 속성은 |
트랜잭션을 백그라운드 작업으로 표시 |
|
거래가 Apdex 점수 에 영향을 미치지 않도록 방지 |
|
관련 로그 보기
애플리케이션의 오류 및 추적 컨텍스트 내에서 직접 로그를 보려면 다음 API 호출을 사용하여 로그에 주석을 추가하십시오.
로그 데이터와 다른 원격 측정 데이터의 상관 관계에 대한 자세한 내용은 컨텍스트 문서의 로그를 참조하세요.
이름보고 앱
New Relic UI는 애플리케이션 이름 을 지정하는 방식으로 데이터를 구성합니다. 각 이름은 다른 앱으로 나타납니다. 코드의 모든 부분에 대해 보고 앱의 이름을 바꾸면 다음과 같은 작업을 더 잘 수행할 수 있습니다.
이는 다중 사이트 애플리케이션 또는 동일한 PHP 설치를 사용하는 개별 애플리케이션 코드 세트가 있는 경우에 특히 유용합니다.
또는 newrelic.appname 구성 값, Apache 또는 PHP-FPM 을 통해 더 높은 수준에서 앱 이름을 설정할 수 있습니다.
원하는 경우... | 이게 ... |
|---|---|
코드의 특정 부분에 대한 보고 앱 이름 바꾸기 | 앱 이름을 설정합니다. |
트랜잭션으로 코드의 누락된 섹션 계측
앱을 계측하기 위해 New Relic은 코드를 통한 각 경로를 자체 트랜잭션으로 분리합니다. 새 유물 시간(또는 "계측기")은 이러한 트랜잭션의 상위 메서드로 앱의 전체 성능을 측정하고 추가 세부 정보를 위해 장기 실행 트랜잭션에서 트랜잭션 추적을 수집합니다. 트랜잭션에 대한 자세한 내용은 트랜잭션 및 트랜잭션 추적 을 참조하십시오.
New Relic이 코드의 특정 부분을 전혀 계측하지 않을 때 다음 방법을 사용하십시오.
원하는 경우... | 이게 ... |
|---|---|
New Relic이 자동으로 계측하지 않는 방법의 타이밍 시작 | 거래를 시작합니다. |
작업이 완료된 후 메서드 타이밍 중지 | 트랜잭션을 중지합니다. |
트랜잭션이 New Relic에 보고되는 것을 방지 | 트랜잭션을 무시하십시오. |
세그먼트를 사용한 시간별 방법
New Relic UI에 트랜잭션이 이미 표시되어 있지만 해당 트랜잭션 중에 호출된 특정 메서드에 대한 데이터가 충분하지 않은 경우 세그먼트를 생성하여 개별 메서드의 시간을 더 자세히 확인할 수 있습니다. 예를 들어 복잡한 논리로 특히 중요한 방법의 시간을 정하고 싶을 수 있습니다.
기존 트랜잭션 내에서 메소드를 계측하려면 이 메소드를 사용하십시오.
원하는 경우... | 이게 ... |
|---|---|
특정 방법 시간 |
|
계기 비동기 작업
PHP 에이전트가 계측하는 유일한 비동기 작업은 기본적으로 계측되는 Guzzle입니다.
앱에서 맞춤 이벤트 및 측정항목 데이터 보내기
New Relic에는 임의의 사용자 지정 데이터를 기록하는 다양한 방법이 포함되어 있습니다. New Relic 데이터 유형에 대한 설명은 데이터 수집 을 참조하십시오.
원하는 경우... | 이게 ... |
|---|---|
이벤트에 대한 데이터를 보내 New Relic에서 분석할 수 있습니다. | 맞춤 이벤트 를 만듭니다. APM 에이전트(PHP)를 통해 사용자 지정 이벤트 삽입을 참조하십시오. |
이벤트를 필터링하고 패싯하기 위해 메타데이터로 이벤트에 태그 지정 | 사용자 정의 속성 을 추가합니다. |
맞춤 실적 데이터 보고 | 맞춤 측정항목 을 만듭니다. |
외부 서비스에 대한 호출 계측
다음 방법을 사용하여 다른 앱 또는 데이터 저장소에 대한 앱의 연결에 대한 데이터를 수집합니다.
원하는 경우... | 이게 ... |
|---|---|
기본적으로 계측되지 않는 데이터 저장소에 대한 호출 시간 측정 |
|
분산 시스템을 통해 이동할 때 요청이 취하는 경로 확인 | PHP 에이전트 버전 9.8 미만의 경우 다음 API 호출을 참조하세요.
|
특정 브라우저 페이지 모니터링
브라우저 에이전트를 페이지에 자동으로 추가하거나 JavaScript 스니펫을 복사하여 붙여넣어 특정 페이지에 구현, 배포하여 설치할 수 있습니다. 에이전트 API 호출을 사용하여 에이전트를 제어할 수도 있습니다. 자세한 내용은 브라우저 모니터링 및 PHP 에이전트를 참조하세요.