• 로그인지금 시작하기

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

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

문제 신고

PHP 에이전트 API 사용 가이드

New Relic의 PHP 에이전트는 에이전트 동작을 사용자 정의하기 위한 API 를 제공합니다. 에이전트는 널리 사용되는 많은 PHP 프레임워크 를 자동으로 계측하지만 PHP API를 사용하여 기본적으로 에이전트가 아직 계측하지 않은 활동을 계측할 수 있습니다.

이 가이드에서는 몇 가지 일반적인 작업에 대한 PHP API 호출에 대해 설명합니다. 예를 들어:

디렉토리당 또는 newrelic.ini 에서 이러한 옵션을 많이 설정할 수도 있습니다. API를 통해 설정하는 경우 API가 다른 방법보다 우선합니다 .

오류 확인 또는 무시

일반적으로 에이전트는 오류를 자동으로 감지합니다. 그러나 에이전트를 사용하여 수동으로 오류를 표시 할 수 있습니다.

원하는 경우...

이게 ...

에이전트가 자동으로 보고하지 않는 오류 보고

newrelic_notice_error() 을(를) 참조하세요.

오류 무시

newrelic.ini 파일에서error_collector.ignore_exceptions 또는 error_collector.ignore_errors 를 수정합니다.

트랜잭션의 메타데이터 향상

때로는 대상 코드가 New Relic에서 볼 수 있지만 메서드의 일부 세부 정보는 유용하지 않습니다. 예를 들어:

New Relic에서 이미 볼 수 있는 트랜잭션을 New Relic에서 계측하는 방법을 변경하려면 다음 방법을 사용하세요.

원하는 경우...

이게 ...

트랜잭션 이름 변경

newrelic_name_transaction() 을(를) 참조하세요.

거래 또는 범위에 메타데이터(예: 고객의 계정 이름 또는 구독 수준)를 추가합니다.

사용자 정의 속성 을 사용하십시오.

트랜잭션 및 범위(활성화된 경우)에 추가될 사용자 정의 속성은 newrelic_add_custom_parameter() 을(를) 참조하십시오.

스팬에만 추가될 사용자 정의 속성은 newrelic_add_custom_span_parameter() 을(를) 참조하십시오.

트랜잭션을 백그라운드 작업으로 표시

newrelic_background_job() 을(를) 참조하세요.

거래가 Apdex 점수 에 영향을 미치지 않도록 방지

newrelic_ignore_apdex() 을(를) 참조하세요.

관련 로그 보기

애플리케이션의 오류 및 추적 컨텍스트 내에서 직접 로그를 보려면 다음 API 호출을 사용하여 로그에 주석을 추가하십시오.

로그 데이터와 다른 원격 측정 데이터의 상관 관계에 대한 자세한 내용은 컨텍스트 문서의 로그를 참조하세요.

이름보고 앱

New Relic UI는 애플리케이션 이름 을 지정하는 방식으로 데이터를 구성합니다. 각 이름은 다른 앱으로 나타납니다. 코드의 모든 부분에 대해 보고 앱의 이름을 바꾸면 다음과 같은 작업을 더 잘 수행할 수 있습니다.

이는 다중 사이트 애플리케이션 또는 동일한 PHP 설치를 사용하는 개별 애플리케이션 코드 세트가 있는 경우에 특히 유용합니다.

또는 newrelic.appname 구성 값, Apache 또는 PHP-FPM 을 통해 더 높은 수준에서 앱 이름을 설정할 수 있습니다.

원하는 경우...

이게 ...

코드의 특정 부분에 대한 보고 앱 이름 바꾸기

앱 이름을 설정합니다. newrelic_set_appname() 을(를) 참조하세요.

트랜잭션으로 코드의 누락된 섹션 계측

앱을 계측하기 위해 New Relic은 코드를 통한 각 경로를 자체 트랜잭션으로 분리합니다. 새 유물 시간(또는 "계측기")은 이러한 트랜잭션의 상위 메서드로 앱의 전체 성능을 측정하고 추가 세부 정보를 위해 장기 실행 트랜잭션에서 트랜잭션 추적을 수집합니다. 트랜잭션에 대한 자세한 내용은 트랜잭션트랜잭션 추적 을 참조하십시오.

New Relic이 코드의 특정 부분을 전혀 계측하지 않을 때 다음 방법을 사용하십시오.

원하는 경우...

이게 ...

New Relic이 자동으로 계측하지 않는 방법의 타이밍 시작

거래를 시작합니다. newrelic_start_transaction() 을(를) 참조하세요.

작업이 완료된 후 메서드 타이밍 중지

트랜잭션을 중지합니다. newrelic_end_transaction() 을(를) 참조하세요.

트랜잭션이 New Relic에 보고되는 것을 방지

트랜잭션을 무시하십시오. newrelic_ignore_transaction() 을(를) 참조하세요.

세그먼트를 사용한 시간별 방법

New Relic UI에 트랜잭션이 이미 표시되어 있지만 해당 트랜잭션 중에 호출된 특정 메서드에 대한 데이터가 충분하지 않은 경우 세그먼트를 생성하여 개별 메서드의 시간을 더 자세히 확인할 수 있습니다. 예를 들어 복잡한 논리로 특히 중요한 방법의 시간을 정하고 싶을 수 있습니다.

기존 트랜잭션 내에서 메소드를 계측하려면 이 메소드를 사용하십시오.

원하는 경우...

이게 ...

특정 방법 시간

newrelic_add_custom_tracer() 을(를) 참조하십시오.

계기 비동기 작업

PHP 에이전트가 계측하는 유일한 비동기 작업은 기본적으로 계측되는 Guzzle입니다.

앱에서 맞춤 이벤트 및 측정항목 데이터 보내기

New Relic에는 임의의 사용자 지정 데이터를 기록하는 다양한 방법이 포함되어 있습니다. New Relic 데이터 유형에 대한 설명은 데이터 수집 을 참조하십시오.

원하는 경우...

이게 ...

이벤트에 대한 데이터를 보내 New Relic에서 분석할 수 있습니다.

맞춤 이벤트 를 만듭니다. APM 에이전트(PHP)를 통해 사용자 지정 이벤트 삽입을 참조하십시오.

이벤트를 필터링하고 패싯하기 위해 메타데이터로 이벤트에 태그 지정

사용자 정의 속성 을 추가합니다. newrelic_add_custom_parameter() 을(를) 참조하세요.

맞춤 실적 데이터 보고

맞춤 측정항목 을 만듭니다. newrelic_custom_metric() 을(를) 참조하세요.

외부 서비스에 대한 호출 계측

다음 방법을 사용하여 다른 앱 또는 데이터 저장소에 대한 앱의 연결에 대한 데이터를 수집합니다.

원하는 경우...

이게 ...

기본적으로 계측되지 않는 데이터 저장소에 대한 호출 시간 측정

newrelic_record_datastore_segment() 을(를) 참조하세요.

분산 시스템을 통해 이동할 때 요청이 취하는 경로 확인

PHP 에이전트 버전 9.8 미만의 경우 다음 API 호출을 참조하세요.

특정 브라우저 페이지 모니터링

브라우저 에이전트를 페이지에 자동으로 추가하거나 JavaScript 스니펫을 복사하여 붙여넣어 특정 페이지에 배포 하여 브라우저 에이전트를 설치할 수 있습니다. APM 에이전트 API 호출을 사용하여 브라우저 에이전트를 제어할 수도 있습니다. 자세한 내용은 브라우저 모니터링 및 PHP 에이전트 를 참조하세요.

Copyright © 2022 New Relic Inc.

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