newrelic_notice_error (API do agente PHP)

Sintaxe

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)

Use essas chamadas para coletar erros que o agente PHP não coleta automaticamente e para definir o retorno de chamada para seu próprio manipulador de erros e exceções.

Requisitos

Versão do agente 2.6 ou superior.

• PHP version 5 or lower: você deve passar uma classe PHP Exception válida.
• PHP version 7 or higher: Você deve passar uma interface PHP Throwable válida.

Descrição

O agente PHP trata erros e exceções de PHP automaticamente para a estrutura suportada.

Se você deseja coletar erros que não são tratados automaticamente para poder consultá -los no New Relic e visualizar o rastreamento de erros, você pode usar newrelic_notice_error.

Se quiser usar seus próprios manipuladores de erros e exceções, você pode definir newrelic_notice_error como retorno de chamada.

Colete erros que não são tratados automaticamente

Para coletar erros que o agente PHP não trata automaticamente, como erros não-PHP, adicione esta chamada à função que você deseja relatar:

newrelic_notice_error(Throwable|Exception $e)

Defina o retorno de chamada para seu próprio manipulador de erros e exceções

Para usar seu próprio manipulador, use essas chamadas para garantir que o agente PHP perceba os erros e exceções de seu manipulador.

newrelic_notice_error(Throwable|Exception $e)

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

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

Parâmetro

Esta função pode manipular um número variável de parâmetros. Você pode passar 1, 4 ou 5 parâmetros, dependendo do seu caso de uso.

newrelic_notice_error(string $message)

newrelic_notice_error(Throwable|Exception $e)

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

Valores de retorno

Retorna null independentemente do resultado.

Exemplos

Colete erros que não são tratados automaticamente

Rastreie erros que não são relatados automaticamente ou que não são erros de PHP. Neste exemplo, um erro é enviado ao agente PHP se um usuário desconhecido acessar seu aplicativo.

try {
    // Add your code that may throw an error here.
} catch (UserNotFoundException $e) {
    newrelic_notice_error($e);
    // Handle normally.
}

Relatar exceções do seu próprio manipulador de exceções

Faça o agente PHP notar exceções de dentro do seu próprio manipulador de exceções.

function example_exception_handler($ex) {
    if (extension_loaded('newrelic')) {
        newrelic_notice_error($ex);
    }
    //Add your code here.
}

Relate erros do seu próprio manipulador de erros (PHP versão 5.6 ou superior)

PHP version 5.6 or higher: Faça com que o agente PHP perceba erros dentro do seu próprio manipulador de erros.

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.
}

Relate erros do seu próprio manipulador de erros (PHP versão 5.5 ou inferior)

PHP version 5.5 or lower: Faça com que o agente PHP perceba erros dentro do seu próprio manipulador de erros.

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.
}