통사론
newrelic_notice_error(string $message)newrelic_notice_error(Throwable|Exception $e)newrelic_notice_error(string $errstr, Throwable|Exception $e)newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline, string $errcontext)이러한 호출을 사용하여 PHP 에이전트가 자동으로 수집하지 않는 오류를 수집하고 고유한 오류 및 예외 처리기에 대한 콜백을 설정합니다.
요구 사항
에이전트 버전 2.6 이상.
주의
예외( $e )를 포함하는 경우 사용 중인 PHP 버전에 따라 차이가 있습니다.
- PHP 버전 5 이하 : 유효한 PHP 예외 클래스를 전달해야 합니다.
- PHP 버전 7 이상 : 유효한 PHP Throwable 인터페이스를 전달해야 합니다.
설명
PHP 에이전트는 지원되는 프레임워크에 대해 PHP 오류 및 예외를 자동으로 처리합니다.
New Relic 에서 해당 오류를 쿼리 하고 오류 추적 을 볼 수 있도록 자동으로 처리되지 않는 오류를 수집하려는 경우 newrelic_notice_error 을 사용할 수 있습니다.
고유한 오류 및 예외 핸들러를 사용하려면 newrelic_notice_error 을 콜백으로 설정할 수 있습니다.
자동으로 처리되지 않는 오류 수집
PHP 에이전트가 자동으로 처리하지 않는 오류(예: PHP가 아닌 오류)를 수집하려면 보고하려는 함수에 이 호출을 추가하십시오 .
newrelic_notice_error(Throwable|Exception $e)중요
단일 트랜잭션에서 이 함수에 대한 여러 호출이 있는 경우 PHP 에이전트는 마지막 호출의 예외만 유지합니다.
고유한 오류 및 예외 처리기에 대한 콜백 설정
자체 핸들러를 사용하려면 이러한 호출을 사용하여 PHP 에이전트가 핸들러 내에서 오류와 예외를 인지하도록 합니다.
매개변수
이 함수는 다양한 수의 매개변수를 처리할 수 있습니다. 사용 사례에 따라 1개 또는 5개의 매개변수를 전달할 수 있습니다.
newrelic_notice_error(string $message)매개변수 | 설명 |
|---|---|
끈 | 필수의. 오류 추적 에 표시될 때 의미 있는 오류 메시지를 제공하십시오. |
newrelic_notice_error(Throwable|Exception $e)매개변수 | 설명 |
|---|---|
예외 | 필수의. 기본값은
|
newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline, string $errcontext)매개변수 | 설명 |
|---|---|
정수 | 필수의. 미리 정의된 오류 수준으로 정수로 표시됩니다. |
끈 | 필수의. 오류 추적 에 표시될 때 의미 있는 오류 메시지를 제공하십시오. |
끈 | 선택 과목. 오류가 발생한 파일의 이름입니다. |
정수 | 선택 과목. 오류가 발생한 줄 번호입니다. |
끈 | 선택 과목. 오류가 발생했을 때 활성 상태였던 기호 테이블을 가리키는 배열입니다. |
반환 값
결과에 관계없이 null 를 반환합니다.
예
자동으로 처리되지 않는 오류 수집
자동으로 보고되지 않거나 PHP 오류가 아닌 오류를 추적합니다. 이 예에서 알 수 없는 사용자가 앱에 액세스하면 PHP 에이전트에 오류가 전송됩니다.
try { // Add your code that may throw an error here.} catch (UserNotFoundException $e) { newrelic_notice_error($e); // Handle normally.}자신의 예외 처리기에서 예외 보고
PHP 에이전트가 자신의 예외 처리기 내에서 예외를 통지하도록 합니다.
function example_exception_handler($ex) { if (extension_loaded('newrelic')) { newrelic_notice_error($ex); } //Add your code here.}자체 오류 처리기에서 오류 보고(PHP 버전 5.6 이상)
PHP 버전 5.6 이상 : PHP 에이전트가 자체 오류 처리기 내에서 오류를 알 수 있도록 합니다.
function example_error_handler($errno, $errstr, $errfile = null, $errline = null, $errcontext = null) { if (extension_loaded('newrelic')) { newrelic_notice_error(...func_get_args()); } //Add your code here.}자체 오류 처리기에서 오류 보고(PHP 버전 5.5 이하)
PHP 버전 5.5 이하 : PHP 에이전트가 자체 오류 처리기 내에서 오류를 알 수 있도록 합니다.
function example_error_handler($errno, $errstr, $errfile = null, $errline = null, $errcontext = null) { if (extension_loaded('newrelic')) { call_user_func_array('newrelic_notice_error', func_get_args()); } //Add your code here.}