newrelic_notice_error(PHP 에이전트 API)

통사론

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)  (PHP 8+)
newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline, string $errcontext) (PHP 7)

이러한 호출을 사용하여 PHP 에이전트가 자동으로 수집하지 않는 오류를 수집하고 고유한 오류 및 예외 처리기에 대한 콜백을 설정합니다.

요구 사항

에이전트 버전 2.6 이상.

주의

예외( $e )를 포함하는 경우 사용 중인 PHP 버전에 따라 차이가 있습니다.

PHP version 5 or lower: 유효한 PHP Exception 클래스를 전달해야 합니다.
PHP version 7 or higher: 유효한 PHP Throwable 인터페이스를 전달해야 합니다.

설명

PHP 에이전트는 지원되는 프레임워크에 대해 PHP 오류 및 예외를 자동으로 처리합니다.

New Relic 에서 해당 오류를 쿼리 하고 오류 추적 을 볼 수 있도록 자동으로 처리되지 않는 오류를 수집하려는 경우 newrelic_notice_error 을 사용할 수 있습니다.

고유한 오류 및 예외 핸들러를 사용하려면 newrelic_notice_error 을 콜백으로 설정할 수 있습니다.

자동으로 처리되지 않는 오류 수집

PHP 에이전트가 자동으로 처리하지 않는 오류(예: PHP가 아닌 오류)를 수집하려면 보고하려는 함수에 이 호출을 추가하십시오 .

newrelic_notice_error(Throwable|Exception $e)

중요

단일 트랜잭션에서 이 함수에 대한 여러 호출이 있는 경우 PHP 에이전트는 마지막 호출의 예외만 유지합니다.

고유한 오류 및 예외 처리기에 대한 콜백 설정

자체 핸들러를 사용하려면 이러한 호출을 사용하여 PHP 에이전트가 핸들러 내에서 오류와 예외를 인지하도록 합니다.

set_exception_handler() 에 대한 콜백 로 newrelic_notice_error 제공하려면 다음을 사용하십시오.

newrelic_notice_error(Throwable|Exception $e)

set_error_handler() 에 대한 콜백 로 newrelic_notice_error 제공하려면 다음을 사용하십시오.

한국어: PHP 7.x

newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline, string $errcontext)

한국어: PHP 8.x

newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline)

매개변수

이 기능은 다양한 수의 시위를 처리할 수 있습니다. 사용 사례에 따라 1, 4 또는 5개를 전달할 수 있습니다.

newrelic_notice_error(string $message)

매개변수	설명
`$message` 끈	필수의. 오류 추적 에 표시될 때 의미 있는 오류 메시지를 제공하십시오.

매개변수

설명

$message

끈

필수의. 오류 추적 에 표시될 때 의미 있는 오류 메시지를 제공하십시오.

newrelic_notice_error(Throwable|Exception $e)

매개변수	설명
`$e` 예외	필수의. 기본값은 `null` 입니다. 에이전트는 `Exception` 또는 `Throwable` 을 사용하여 스택 프레임을 캡처하고 오류 클래스를 예외 클래스 이름으로 설정합니다. `null` 또는 생략된 경우 에이전트는 `Exception::__toString` 에 의해 생성된 것과 동일한 형식으로 "예외"를 보고합니다.

매개변수

설명

$e

예외

필수의. 기본값은 null 입니다.

에이전트는 Exception 또는 Throwable 을 사용하여 스택 프레임을 캡처하고 오류 클래스를 예외 클래스 이름으로 설정합니다.
null 또는 생략된 경우 에이전트는 Exception::__toString 에 의해 생성된 것과 동일한 형식으로 "예외"를 보고합니다.

페소 7.3

newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline, string $errcontext)

한국어: PHP 8.x

newrelic_notice_error(int $errno, string $errstr, string $errfile, int $errline)

매개변수	설명
`$errno` 정수	필수의. 미리 정의된 오류 수준으로 정수로 표시됩니다.
`$errstr` 끈	필수의. 오류 트레이스 에 표시될 때 귀하에게 의미가 있는 오류 메시지를 제공하세요. 여기에는 추가적으로 알고 싶은 정보를 포함하는 데 사용할 수 있습니다.
`$errfile` 끈	선택 과목. 오류가 발생한 파일의 이름입니다. 참고: 이 측정값은 에이전트에 의해 무시됩니다. 에이전트는 이 정보로 그리드 추적을 제공합니다.
`$errline` 정수	선택 과목. 오류가 발생한 줄 번호입니다. 참고: 이 측정값은 에이전트에 의해 무시됩니다. 에이전트는 이 정보로 그리드 추적을 제공합니다.
`$errcontext` 끈	선택 과목. 오류가 발생했을 때 활성 상태였던 기호 테이블을 가리키는 배열입니다. 참고: 에이전트는 이 조치를 무시하며 PHP 8+에서는 지원되지 않습니다.

매개변수

설명

$errno

정수

필수의. 미리 정의된 오류 수준으로 정수로 표시됩니다.

$errstr

끈

필수의. 오류 트레이스 에 표시될 때 귀하에게 의미가 있는 오류 메시지를 제공하세요. 여기에는 추가적으로 알고 싶은 정보를 포함하는 데 사용할 수 있습니다.

$errfile

끈

선택 과목. 오류가 발생한 파일의 이름입니다.

참고: 이 측정값은 에이전트에 의해 무시됩니다. 에이전트는 이 정보로 그리드 추적을 제공합니다.

$errline

정수

선택 과목. 오류가 발생한 줄 번호입니다.

참고: 이 측정값은 에이전트에 의해 무시됩니다. 에이전트는 이 정보로 그리드 추적을 제공합니다.

$errcontext

끈

선택 과목. 오류가 발생했을 때 활성 상태였던 기호 테이블을 가리키는 배열입니다.

참고: 에이전트는 이 조치를 무시하며 PHP 8+에서는 지원되지 않습니다.

반환 값

결과에 관계없이 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 version 5.6 or higher: 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 version 5.5 or lower: 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.
}

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

newrelic_notice_error(PHP 에이전트 API)

통사론

요구 사항

주의

설명

자동으로 처리되지 않는 오류 수집

중요

고유한 오류 및 예외 처리기에 대한 콜백 설정

`set_exception_handler()`

`set_error_handler()`

매개변수

반환 값

예

자동으로 처리되지 않는 오류 수집

자신의 예외 처리기에서 예외 보고

자체 오류 처리기에서 오류 보고(PHP 버전 5.6 이상)

자체 오류 처리기에서 오류 보고(PHP 버전 5.5 이하)

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

newrelic_notice_error(PHP 에이전트 API)

통사론.css-21sua1{background:none;border:none;width:0;padding:0;}

요구 사항

주의

설명

자동으로 처리되지 않는 오류 수집

중요

고유한 오류 및 예외 처리기에 대한 콜백 설정

set_error_handler()

매개변수

반환 값

예

자동으로 처리되지 않는 오류 수집

자신의 예외 처리기에서 예외 보고

자체 오류 처리기에서 오류 보고(PHP 버전 5.6 이상)

자체 오류 처리기에서 오류 보고(PHP 버전 5.5 이하)

통사론

`set_error_handler()`