• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

newrelic_set_error_group_callback (API do agente PHP)

Sintaxe

newrelic_set_error_group_callback($callback)

Agrupe erros com sua própria função de retorno de chamada de impressão digital personalizada.

Requisitos

Versão do agente 10.12 ou superior.

Descrição

Esta API permite que um usuário registre uma função de retorno de chamada personalizada com o agente PHP que será chamada quando o aplicativo encontrar um erro.

O retorno de chamada fornecerá duas matrizes PHP do agente - uma contendo dados de transação e outra contendo dados de erro.

Usando as informações de contexto fornecidas, o retorno de chamada deve retornar uma sequência não vazia com base na lógica definida pelo usuário que servirá como o nome do grupo de erros exibido na interface da Errors Inbox .

Importante

  • Quando há múltiplas chamadas para esta função em uma única transação, o agente PHP retém o retorno de chamada apenas da última chamada.
  • Retorno de chamada são registrados por solicitação. Essa API deve ser chamada em um caminho de código com execução garantida para cada solicitação, ou o retorno de chamada não será invocado.
  • É altamente recomendável manter a função de retorno de chamada o mínimo possível. O retorno de chamada com uso intensivo de CPU (como chamadas de banco de dados) ou outra lógica complexa resultará em impactos no desempenho do seu aplicativo.

Parâmetro

Esta API aceita um único retorno de chamada do tipo função como argumento. O retorno de chamada fornecido deve aceitar 2 parâmetros.

Parâmetro API

Descrição

$callback (função)

Obrigatório. Forneça uma função de retorno de chamada que será registrada no agente PHP.

Parâmetro de retorno de chamada

Descrição

$transaction_data (matriz)

Obrigatório. Uma matriz de dados de transação fornecidos ao seu retorno de chamada pelo agente PHP.

$error_data (matriz)

Obrigatório. Uma matriz de dados de erro fornecidos ao seu retorno de chamada pelo agente PHP.

Matriz de pares de valores principais

$transaction_data - Dados de transação do agente PHP fornecidos ao seu retorno de chamada

Chave

Valor

"request_uri"

(string) Solicitar URI

"caminho"

(string) Caminho do arquivo

"método"

(string) Método HTTP (GET, POST, etc.)

"status_code"

(int) Código de status HTTP (200, 404, etc.)

$error_data - Dados de erro do agente PHP fornecidos ao seu retorno de chamada

Chave

Valor

"classe"

(string) Nome da classe

"mensagem"

(string) mensagem de erro

"arquivo"

(string) Caminho do arquivo

"pilha"

(string) tracede rastreamento de erro JSON

Importante

  • Nem todas as chaves contêm valores garantidos. Isso depende muito do aplicativo do usuário e da natureza do erro.
  • As chaves da matriz sempre serão definidas, independentemente de conterem ou não valores vazios.

Valores de retorno

A API retorna true se o retorno de chamada for registrado com sucesso, caso contrário false.

Exemplos

if (extension_loaded('newrelic')) { // Ensure PHP agent is available
$callback = function(array $transaction_data, array $error_data)
{
$fingerprint = "";
//
// Add custom code to parse array data
//
// Example code
if ($error_data["klass"] == "E_USER_ERROR") {
$fingerprint = "USER ERROR";
};
return $fingerprint; // Non-empty string error group name
};
newrelic_set_error_group_callback($callback);
};
Copyright © 2024 New Relic Inc.

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