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 |
|---|---|
| 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 |
|---|---|
| Obrigatório. Uma matriz de dados de transação fornecidos ao seu retorno de chamada pelo agente PHP. |
| 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 ( |
"status_code" | (int) Código de status HTTP ( |
$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);};