• 로그인

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

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

문제 신고

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, 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)

매개변수

설명

$message

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

newrelic_notice_error(Throwable|Exception $e)

매개변수

설명

$e

예외

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

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

매개변수

설명

$errno

정수

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

$errstr

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

$errfile

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

$errline

정수

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

$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.
}
Copyright © 2022 New Relic Inc.

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