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 |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
|
| 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 |
|---|---|---|
|
| Obrigatório. A exceção a ser registrada. |
|
| 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 |
|---|---|---|
|
| 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 |
|---|---|---|
|
| 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 |
|---|---|---|
|
| 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 |
|---|---|---|
|
| 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); }