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 [#android-syntax-kotlin]
NewRelic.recordHandledException( exception: Exception?, exceptionAttributes: Map<String?, Any?>?)NewRelic.recordHandledException(throwable: Throwable?)NewRelic. recordHandledException( throwable: Throwable?, attributes: Map<String?, Any?>?)Descrição [#android-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 [#android-parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
|
| Opcional. Um mapa de atributo a ser associado à exceção. |
Valores de retorno [#android-return-values]
Retorna true se registrado com sucesso ou false caso contrário.
Exemplos [#android-examples]
Aqui está um exemplo de gravação de um ClassCastException de um ouvinte ao clicar:
Java [#android-examples-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 [#android-examples-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 [#ios-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 tratados no código Swift.
Parâmetro [#ios-parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
|
| Opcional. Dicionário de atributo que contextualiza. |
Valores de retorno [#ios-return-values]
Retornará true se o evento for registrado com sucesso ou false se não.
Exemplos [#ios-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
RecordException(System.Exception exception) : void;Descrição [#maui-description]
Registre manualmente exceções não fatais.
Parâmetro [#maui-parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
Valores de retorno [#maui-return-values]
Retornará true se o evento for registrado com sucesso ou false se não.
Exemplo [#maui-example]
try { some_code_that_throws_error(); } catch (Exception ex) { CrossNewRelic.Current.RecordException(ex); }Sintaxe
RecordException(System.Exception exception) : void;Descrição [#unity-description]
Registra uma exceção tratada. Opcionalmente, leva o mapa com atributo adicional mostrando o contexto.
Parâmetro [#unity-parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
Valores de retorno [#unity-return-values]
Retornará true se o evento for registrado com sucesso ou false se não.
Exemplo [#unity-example]
try { some_code_that_throws_error();} catch(Exception ex) { NewRelicAgent.RecordException(e);}Sintaxe
RecordException(System.Exception exception) : void;Descrição [#xamarin-description]
Registre manualmente quaisquer exceções tratadas.
Parâmetro [#xamarin-parameters]
Parâmetro | Tipo | Descrição |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
Valores de retorno [#xamarin-return-values]
Retornará true se o evento for registrado com sucesso ou false se não.
Exemplo [#xamarin-example]
try { some_code_that_throws_error();} catch(Exception ex) { CrossNewRelicClient.Current.RecordException(ex);}