Sobrecargas
Observe un error e informe a New Relic, junto con el atributo personalizado opcional.
NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception);NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception, IDictionary<TKey, TValue> $attributes);NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes);NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes, bool $is_expected);
Requisitos
Esta llamada API es compatible con:
- Todas las versiones del agente
- Todos los tipos de aplicaciones
Descripción
Observe un error e infórmelo a New Relic junto con el atributo personalizado opcional. Para cada transacción, el agente solo conserva la excepción y el atributo de la primera llamada a NoticeError()
. Puede pasar una excepción real o pasar una cadena para capturar un mensaje de error arbitrario.
Si este método se invoca dentro de una transacción, el agente informa la excepción dentro de la transacción principal. Si se invoca fuera de una transacción, el agente crea una traza de error y clasifica el error en la UI de New Relic como una llamada API NewRelic.Api.Agent.NoticeError
. Si se invoca fuera de una transacción, la llamada NoticeError()
no contribuirá a la tasa de errores de una aplicación.
El agente añade el atributo únicamente al error de traza; no los envía a New Relic. Para obtener más información, consulte AddCustomAttribute()
.
Los errores informados con esta API aún se envían a New Relic cuando se informan dentro de una transacción que genera un código de estado HTTP, como 404
, que está configurado para ser ignorado por la configuración del agente. Para obtener más información, consulte nuestra documentación sobre la gestión de errores en APM.
Revise las secciones siguientes para ver ejemplos de cómo utilizar esta llamada.
AvisoError(Excepción)
NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception)
Parámetro | Descripción |
---|---|
Excepción | Requerido. El |
NoticeError(Exception, IDictionary)
NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception, IDictionary<TKey, TValue> $attributes)
Parámetro | Descripción |
---|---|
Excepción | Requerido. El |
IDictionary<TKey, TValue> | Especifique los pares principales de valor del atributo para anotar el mensaje de error. El |
NoticeError(String, IDictionary)
NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes)
Parámetro | Descripción |
---|---|
cadena | Requerido. Especifique una cadena para informar a New Relic como si fuera una excepción. Este método crea tanto error evento como error traza. En error evento solo se retienen los primeros 1023 caracteres, mientras que error traza retiene el mensaje completo. |
IDictionary<TKey, TValue> | Requerido (puede ser nulo). Especifique los pares principales de valor del atributo para anotar el mensaje de error. El |
NoticeError(String, IDictionary, bool)
NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes, bool $is_expected)
Parámetro | Descripción |
---|---|
cadena | Requerido. Especifique una cadena para informar a New Relic como si fuera una excepción. Este método crea tanto error evento como error traza. En error evento solo se retienen los primeros 1023 caracteres, mientras que error traza retiene el mensaje completo. |
IDictionary<TKey, TValue> | Requerido (puede ser nulo). Especifique los pares principales de valor del atributo para anotar el mensaje de error. El |
bool | Marque el error como se esperaba para que no afecte la puntuación Apdex ni la tasa de errores. |
Pasar una excepción sin atributo personalizado
try{ string ImNotABool = "43"; bool.Parse(ImNotABool);}catch (Exception ex){ NewRelic.Api.Agent.NewRelic.NoticeError(ex);}
Pasar una excepción con atributo personalizado
try{ string ImNotABool = "43"; bool.Parse(ImNotABool);}catch (Exception ex){ var errorAttributes = new Dictionary<string, string>() {{"foo", "bar"},{"baz", "luhr"}}; NewRelic.Api.Agent.NewRelic.NoticeError(ex, errorAttributes);}
Pasar una cadena de mensaje de error con atributo personalizado
try{ string ImNotABool = "43"; bool.Parse(ImNotABool);}catch (Exception ex){ var errorAttributes = new Dictionary<string, string>{{"foo", "bar"},{"baz", "luhr"}}; NewRelic.Api.Agent.NewRelic.NoticeError("String error message", errorAttributes);}
Pasar una cadena de mensaje de error sin atributo personalizado
try{ string ImNotABool = "43"; bool.Parse(ImNotABool);}catch (Exception ex){ NewRelic.Api.Agent.NewRelic.NoticeError("String error message", null);}
Pase una cadena de mensaje de error y márquela como se esperaba
try{ string ImNotABool = "43"; bool.Parse(ImNotABool);}catch (Exception ex){ NewRelic.Api.Agent.NewRelic.NoticeError("String error message", null, true);}