Exceção tratada por registro

Sintaxe

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?>?
)

Descrição [#description]

Registra uma exceção tratada ou outro tipo que pode ser lançado. Opcionalmente, leva o mapa com atributo adicional mostrando o contexto.

Use recordHandledException() em um bloco try{...} catch(){...} para ajudar a entender com que frequência seu aplicativo lança exceções e sob quais condições.

Além do atributo personalizado associado, o evento também terá sessão atributo associada. Você pode visualizar os dados do evento na interface de monitoramento de Mobile na trilha Crash de evento ou via NRQL.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`$exceptionToHandle`	`Exception`	Obrigatório. A exceção a ser registrada.
`$exceptionAttributes`	`Map of String, Object`	Opcional. Um mapa de atributo a ser associado à exceção.

Valores de retorno [#return-values]

Retorna true se registrado com sucesso ou false caso contrário.

Exemplos [#examples]

Aqui está um exemplo de gravação de um ClassCastException de um ouvinte ao clicar:

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

Sintaxe

Objetivo-c

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

Descrição [#description]

Registra uma exceção tratada (somente Objective-c). Opcionalmente, leva um mapa com atributos adicionais mostrando o contexto.

A API recordHandledException é útil para análise de falhas; o evento capturado ajudará você a entender com que frequência seu aplicativo lança exceções e sob quais condições. Além do atributo personalizado associado, o evento também terá sessão atributo associada.

Esta API usa uma instância de um NSException e um dicionário de atributo NSDictionary opcional e, em seguida, cria um evento recordHandledException . Você pode visualizar os dados do evento na interface Crash trilha de evento, e consultá-los com NRQL.

Importante

Esta função não deve ser usada com código Swift. Use recordError para rastrear erros manipulados no código Swift.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`exception`	`NSException`	Obrigatório. A exceção a ser registrada.
`attributes`	`NSDictionary`	Opcional. Dicionário de atributo que contextualiza.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplos [#examples]

Aqui está um exemplo de uma exceção tratada simples:

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

Aqui está outro exemplo ou uma exceção tratada com um dicionário:

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];

Sintaxe

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

Descrição [#description]

Registre manualmente exceções não fatais.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`exception`	`Exception`	Obrigatório. A exceção a ser registrada.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

RecordException(System.Exception exception) : void;

Descrição [#description]

Registra uma exceção tratada. Opcionalmente, leva o mapa com atributo adicional mostrando o contexto.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`exception`	`Exception`	Obrigatório. A exceção a ser registrada.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

RecordException(System.Exception exception) : void;

Descrição [#description]

Registre manualmente quaisquer exceções tratadas.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`exception`	`Exception`	Obrigatório. A exceção a ser registrada.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

Sintaxe

RecordException(System.Exception exception) : void;

Descrição [#description]

Registre manualmente quaisquer exceções tratadas.

Parâmetro [#parameters]

Parâmetro	Tipo	Descrição
`exception`	`Exception`	Obrigatório. A exceção a ser registrada.

Valores de retorno [#return-values]

Retornará true se o evento for registrado com sucesso ou false se não.

Exemplo [#example]

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

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

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

Java

Kotlin [#kotlin]

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplos [#examples]

Java [#java]

Kotlin [#kotlin]

Sintaxe

Objetivo-c

Descrição [#description]

Importante

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplos [#examples]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe

Descrição [#description]

Parâmetro [#parameters]

Valores de retorno [#return-values]

Exemplo [#example]

Sintaxe