Registro de excepción manejada

Sintaxis

Java

NewRelic.recordHandledException(Exception $exceptionToHandle)
NewRelic.recordHandledException(Exception $exceptionToHandle, Map of String, Object $exceptionAttributes)

NewRelic.recordHandledException(Throwable $throwableToHandle)
NewRelic.recordHandledException(Throwable $throwableToHandle, Map of String, Object $exceptionAttributes)

Kotlin [#kotlin]

NewRelic.recordHandledException(
exception: Exception?,
exceptionAttributes: Map<String?, Any?>?
)

NewRelic.recordHandledException(throwable: Throwable?)
NewRelic. recordHandledException(
throwable: Throwable?,
attributes: Map<String?, Any?>?
)

Descripción [#description]

Registra una excepción manejada u otro tipo que se puede lanzar. Opcionalmente toma un mapa con un atributo adicional que muestra el contexto.

Utilice recordHandledException() dentro de un bloque try{...} catch(){...} para ayudar a comprender con qué frecuencia su aplicación genera excepciones y bajo qué condiciones.

Además del atributo personalizado asociado, el evento también tendrá asociado el atributo de sesión. Puede ver los datos del evento en la UI de monitoreo de móviles en la traza de evento de Crash, o vía NRQL.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`$exceptionToHandle`	`Exception`	Requerido. La excepción que debe registrarse.
`$exceptionAttributes`	`Map of String, Object`	Opcional. Un mapa de atributo que se asociará con la excepción.

Valores de retorno [#return-values]

Devuelve true si se registró correctamente, o false en caso contrario.

Ejemplos [#examples]

A continuación se muestra un ejemplo de grabación de un ClassCastException desde un detector al hacer clic:

Java [#java]

public class MainActivity extends Activity {
  ...
  coolButton.setOnClickListener(new View.OnClickListener() {
            Map myMap = new HashMap<>();
            @Override
            public void onClick(View view) {
                try {
                    myMap.put("Key", "Value");
                    Integer stringVar = (Integer) myMap.get("Key"); //throws ClassCastException
                } catch (Exception e) {
                    NewRelic.recordHandledException(e, myMap);
                }
            }
        });
  ...
}

Kotlin [#kotlin]

class MainActivity : AppCompatActivity() {

....
    binding.fab.setOnClickListener { view ->
        val myMap = mutableMapOf<String,Any>()
        try {
            myMap["Key"] = "Value"
            Snackbar.make(view, "Replace with your own action", Snackbar.LENGTH_LONG)
                .setAnchorView(R.id.fab)
                .setAction("Action", null).show()
        }catch (exception:Exception) {
            NewRelic.recordHandledException(exception,myMap)
        }
    }
........

Sintaxis

C objetivo

recordHandledException:(NSException* __nonnull)exception withAttributes:(NSDictionary* __nullable)attributes;

Descripción [#description]

Registra una excepción manejada (solo Objective-c). Opcionalmente toma un mapa con un atributo adicional que muestra el contexto.

La API recordHandledException es útil para el análisis de fallos; El evento capturado lo ayudará a comprender con qué frecuencia su aplicación genera excepciones y bajo qué condiciones. Además del atributo personalizado asociado, el evento también tendrá asociado el atributo de sesión.

Esta API toma una instancia de un NSException y un diccionario de atributos NSDictionary opcional, luego crea un evento recordHandledException . Puede ver los datos del evento en la UIde Crash traza de evento y consultarlos con NRQL.

Importante

Esta función no debe usarse con código Swift. Utilice recordError para realizar un seguimiento de los errores manejados en el código Swift.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`exception`	`NSException`	Requerido. La excepción que debe registrarse.
`attributes`	`NSDictionary`	Opcional. Diccionario de atributos que dan contexto.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplos [#examples]

A continuación se muestra un ejemplo de una excepción manejada simple:

@try {
       @throw [NSException exceptionWithName:@"versionException"
                                      reason:@"App version no longer supported"
                                    userInfo:nil];
     } @catch (NSException* e) {
       [NewRelic recordHandledException:e];
     }

Aquí hay otro ejemplo o una excepción manejada con un diccionario:

NSException *exception = [NSException exceptionWithName:@"MyException" reason:@"I have my reason" userInfo:nil];

    NSDictionary* dictionary = @{@"int": @1,
                                 @"Test Group" : @"A | B"};

    [NewRelic recordHandledException:exception withAttributes:dictionary];

Sintaxis

recordError(error, StackTrace.current, attributes: attributes);

Descripción [#description]

Registre manualmente las excepciones no fatales.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`exception`	`Exception`	Requerido. La excepción que debe registrarse.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

try {
  some_code_that_throws_error();
} catch (ex) {
NewrelicMobile.instance
        .recordError(error, StackTrace.current, attributes: attributes);
}

Sintaxis

RecordException(System.Exception exception) : void;

Descripción [#description]

Registra una excepción manejada. Opcionalmente toma un mapa con un atributo adicional que muestra el contexto.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`exception`	`Exception`	Requerido. La excepción que debe registrarse.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

try {
      some_code_that_throws_error();
    } catch (Exception ex) {
      CrossNewRelic.Current.RecordException(ex);
    }

Sintaxis

RecordException(System.Exception exception) : void;

Descripción [#description]

Registre manualmente cualquier excepción manejada.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`exception`	`Exception`	Requerido. La excepción que debe registrarse.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

try {
      some_code_that_throws_error();
    } catch (Exception ex) {
      NewRelicAgent.RecordException(e);
    }

Sintaxis

RecordException(System.Exception exception) : void;

Descripción [#description]

Registre manualmente cualquier excepción manejada.

Parámetros [#parameters]

Parámetro	Tipo	Descripción
`exception`	`Exception`	Requerido. La excepción que debe registrarse.

Valores de retorno [#return-values]

Devuelve true si el evento se registra correctamente, o false en caso contrario.

Ejemplo [#example]

try {
      some_code_that_throws_error();
    } catch (Exception ex) {
      CrossNewRelicClient.Current.RecordException(ex);
    }

Te ofrecemos esta traducción automática para facilitar la lectura.

Sintaxis .css-21sua1{background:none;border:none;width:0;padding:0;}

Java

Kotlin [#kotlin]

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplos [#examples]

Java [#java]

Kotlin [#kotlin]

Sintaxis

C objetivo

Descripción [#description]

Importante

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplos [#examples]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis

Descripción [#description]

Parámetros [#parameters]

Valores de retorno [#return-values]

Ejemplo [#example]

Sintaxis