NoticeError (API del agente .NET)

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)

NoticeError(Exception, IDictionary)

NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception, IDictionary<TKey, TValue> $attributes)

NoticeError(String, IDictionary)

NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes)

NoticeError(String, IDictionary, bool)

NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes, bool $is_expected)

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);
}