• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

Criar um problema

Definir configurações de monitoramento de Mobile

Use os métodos abaixo para alterar as configurações padrão de monitoramento de Mobile. Todas as configurações, incluindo a chamada para invocar o agente, são chamadas no método onCreate da classe MainActivity .

Para alterar as configurações, você tem duas opções (se a configuração permitir):

  • Altere a configuração em sua própria linha para cada condição específica. Por exemplo:

    NewRelic.disableFeature(FeatureFlag.DefaultInteractions);
    NewRelic.enableFeature(FeatureFlag.CrashReporting);
    NewRelic.withApplicationToken(<NEW_RELIC_TOKEN>).start(this.getApplication());

    OU

  • Altere a configuração como parte da chamada inicial do agente usando o método .with . Por exemplo:

    NewRelic.withApplicationToken(<NEW_RELIC_TOKEN>)
    .withDefaultInteractions(false)
    .withCrashReportingEnabled(true)
    .start(this.getApplication());

    Configurações de análise

    Descrição

    Exemplo

    Habilite ou desabilite a coleta de dados de eventos. Esses eventos podem ser consultados no NRQL e utilizados na páginaCrash analysis .

    O valor padrão é true.

    withAnalyticsEvents(false)

    Habilite ou desabilite o relatório de dados de eventos. o evento collection ainda ocorrerá, mas os eventos não serão enviados ao nosso coletor. Você pode decidir usar isso em vez de withAnalyticsEvents se quiser desativar a coleta, mas ainda conseguir ver o que o agente estava coletando.

    O valor padrão é true.

    FeatureFlag.AnalyticsEvents(true)

    Configurações de tempo de lançamento do aplicativo

    Descrição

    Exemplo

    Habilite ou desabilite o relatório do tempo de lançamento do aplicativo (tempo frio e quente) para a métrica:

    • O tempo de inicialização a frio refere-se ao início de um aplicativo do zero. Isso significa que o processo do aplicativo não foi criado pelo sistema até então.

    • O horário de inicialização a quente refere-se a quando o processo do seu aplicativo já está em execução em segundo plano.

      O valor padrão é true.

    FeatureFlag.AppStartMetrics(false)

    Configurações do aplicativo

    Descrição

    Exemplo

    Defina a versão do aplicativo como uma string. O padrão é o número de versão definido em AndroidManifest.xml.

    withApplicationVersion("MY APP VERSION")

    Defina a versão da compilação como uma string. O padrão é o ID de compilação definido em AndroidManifest.xml.

    withBuildVersion("MY BUILD VERSION")

    Configurações de relatórios de falhas e erros

    Descrição

    Exemplo

    Ativa ou desativa relatórios de falhas adiados. O valor padrão é false.

    withCrashReportingEnabled(true)

    Habilite ou desabilite a gravação de eventos de exceções tratadas, que aparecem na página Exceção tratada. O valor padrão é true.

    FeatureFlag.HandledExceptions(false)

    Ative ou desative a gravação de travamentos de tempo de execução nativo, exceções e condições de aplicativo não respondendo (ANR), que aparecem na página Análise de travamento. O valor padrão é true.

    FeatureFlag.NativeReporting(false)

    Distributed tracing

    Descrição

    Exemplo

    Habilite ou desabilite a adição de cabeçalhos distributed tracing às solicitações de rede.

    O valor padrão é true.

    Consulte Como funciona distributed tracing do New Relic para obter mais informações sobre distributed tracing em aplicativos móveis.

    FeatureFlag.DistributedTracing(false)

    Configurações do FedRamp

    Descrição

    Exemplo

    Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

    O valor padrão é true (a partir da versão 6.11.0 do agente).

    FeatureFlag.FedRampEnabled(false)

    Configurações de interação

    Descrição

    Exemplo

    Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

    O valor padrão é true.

    FeatureFlag.InteractionTracing(false)

    Habilite ou desabilite a interação padrão. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso ativará ou desativará a interação padrão apenas enquanto a interação personalizada permanecer habilitada.

    O valor padrão é true.

    FeatureFlag.DefaultInteractions(false)

    Configurações de registro

    Descrição

    Exemplo

    Habilite ou desabilite o log do agente.

    O valor padrão é true.

    withLoggingEnabled(false)

    Especifica o nível de log. As opções incluem:

    • ERROR (menos detalhado)

    • WARN

    • INFO

    • VERBOSE

    • DEBUG

    • AUDIT (mais detalhado)

      O valor padrão é INFO.

    withLogLevel(AgentLog.ERROR)

    Configurações de rede

    Descrição

    Exemplo

    Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

    O valor padrão é true (a partir da versão 5.15.2 do agente).

    FeatureFlag.NetworkRequests(false)

    Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError . Disponível para agente Android versão 5.11.0 ou superior.

    O valor padrão é true.

    FeatureFlag.NetworkErrorRequests(false)

    Habilite ou desabilite a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

    O valor padrão é true.

    FeatureFlag.HttpResponseBodyCaptureEnabled(false)

    Armazenamento off-line

    Descrição

    Exemplo

    Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível.

    Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

    O armazenamento offline está desabilitado por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

    NewRelic.enableFeature(FeatureFlag.OfflineStorage)

O agente iOS da New Relic fornece definições de configuração para alterar o comportamento padrão do agente. Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar o token do aplicativo. Por exemplo:

  • Objective-C:

    + [NewRelic startWithApplicationToken:]
  • Swift:

    NewRelic.start(withApplicationToken:)

    Habilitar ou desabilitar flags de recurso

    Para configurar flags de recurso, utilize o seguinte método definido em NewRelic.h:

    Idioma iOS

    Procedimento

    Objective-C

    No Objective-C, esses recursos são bitmasked, então você pode usar um | para ativar ou desativar vários recursos ao mesmo tempo.

    Habilite um sinalizador de recurso:

    +[NewRelic enableFeatures:(NRMAFeatureFlags)flags];

    Desative um sinalizador de recurso:

    +[NewRelic disableFeatures:(NRMAFeatureFlags)flags];

    Aqui está um exemplo onde:

    • O rastreamento de interação e a instrumentação de rede experimental estão habilitados.
    • NSURLSession instrumentação e relatórios de falhas estão desativados.
    [NewRelic enableFeatures:NRFeatureFlag_SwiftInteractionTracing | NRFeatureFlag_FedRampEnabled];
    [NewRelic disableFeatures:NRFeatureFlag_NSURLSessionInstrumentation | NRFeatureFlag_CrashReporting];
    [NewRelic startWithApplicationToken:...];

    Swift

    Habilite um sinalizador de recurso:

    NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])

    Desative um sinalizador de recurso:

    NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag])

    Exemplo para desativar o rastreamento de interação padrão:

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions)

    Configurações de endpoint de dados

    Descrição

    Exemplo

    Ative ou desative o relatório de falhas, que aparece na páginaCrash analysis .

    Especifica o componente de autoridade URI do endpoint de upload de dados de coleta. Este endpoint também é usado para uploads de exceções tratadas.

    Para substituir o endpoint de dados que o agente usará ao relatar coletas de dados, adicione andCollectorAddress: à chamada de método NewRelic.start(withApplicationToken:) .

    O valor padrão é mobile-collector.newrelic.com.

    NewRelic.start(withApplicationToken:YOUR_APP_TOKEN
    andCollectorAddress:"harvest-upload.domain.com"
    andCrashCollectorAddress:"crash-upload.domain.com");

    Especifica o componente de autoridade do URI de upload de dados de falha.

    Para substituir o endpoint de dados que o agente usará ao relatar falhas, adicione andCrashCollectorAddress: à chamada do método NewRelic.start(withApplicationToken:) .

    O valor padrão é mobile-crash.newrelic.com.

    NewRelic.start(withApplicationToken:YOUR_APP_TOKEN
    andCollectorAddress:"harvest-upload.domain.com"
    andCrashCollectorAddress:"crash-upload.domain.com");

    Sinalizador de recurso de relatório de falhas e erros

    Se você modificar qualquer uma das configurações de relatório de falhas e erros abaixo, certifique-se de chamar o sinalizador de recurso antes que o agente iOS inicie a chamada.

    Descrição

    Exemplo

    Ative ou desative o relatório de falhas, que aparece na páginaAnálise de falhas .

    Especifica o componente de autoridade URI do endpoint de upload de dados de coleta. Este endpoint também é usado para uploads de exceções tratadas.

    Para substituir o endpoint de dados que o agente usará ao relatar coletas de dados, adicione .usingCollectorAddress() à chamada de método NewRelic.withApplicationToken() .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_CrashReporting)

    Habilite ou desabilite globalmente a gravação de eventos de exceções tratadas, que aparecem na página Exceção tratada.

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HandledExceptionEvents)

    Distributed tracing

    Descrição

    Exemplo

    Habilite ou desabilite a adição de cabeçalhos distributed tracing às solicitações de rede. Consulte Como funciona distributed tracing do New Relic para obter mais informações sobre distributed tracing em aplicativos móveis.

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DistributedTracing)

    interação recurso flags

    Se você modificar qualquer uma das configurações de relatório de falhas e erros abaixo, certifique-se de chamar o sinalizador de recurso pouco antes de o agente iOS da New Relic iniciar a chamada.

    Descrição

    Exemplo

    Habilite ou desabilite o rastreamento de interação apenas para classes e métodos de instrumento padrão. A interação personalizada será relatada. O rastreamento aparecerá na páginaInteractions .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions)

    Habilite ou desabilite globalmente o trace da interação, que aparece na páginaInteractions .

    O rastreamento de interação será desativado após o início do agente. A interação para qualquer atividade ou método executado antes do início do agente ainda poderá aparecer na página Interactions .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_InteractionTracing)

    Cuidado

    Antes de habilitar esse recurso, consulte Habilitar rastreamento de interação do Swift. Se as medidas adequadas não forem tomadas, a ativação deste recurso poderá causar instabilidade.

    Habilite ou desabilite o rastreamento de interação para código Swift. O rastreamento aparece na páginaInteractions . Este recurso estará sempre desativado se NRFeatureFlag_InteractionTracing estiver desativado.

    O valor padrão é false.

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftInteractionTracing)

    Habilite ou desabilite a instrumentação automática do WKWebView.

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_WebViewInstrumentation)

    Cuidado

    Este recurso está obsoleto, habilitar esta chamada de sinalizador de recurso pode diminuir a estabilidade do aplicativo. Evite usar, a menos que seja instruído pela New Relic.

    Ative ou desative a instrumentação automática de gestos.

    O valor padrão é false.

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_GestureInstrumentation)

    Sinalizadores de recursos de rede

    Se você modificar alguma das configurações abaixo, certifique-se de chamar o sinalizador de recurso antes que o agente iOS da New Relic inicie a chamada.

    Descrição

    Exemplo

    Cuidado

    Este recurso está obsoleto, habilitar esta chamada de sinalizador de recurso pode diminuir a estabilidade do aplicativo. Evite usar, a menos que seja instruído pela New Relic.

    Habilite ou desabilite a instrumentação de rede experimental. Isso força todas as NSURLConnection solicitações de rede através do NRMAURProtocol.

    O valor padrão é false.

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_ExperimentalNetworkingInstrumentation)

    Ative ou desative a instrumentação de rede para NSURLSession. Esses rastreamentos de URL são enviados para a página Solicitações HTTP .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NSURLSessionInstrumentation)

    Habilite ou desabilite a instrumentação de rede. Isso envia os dados de resposta HTTP como evento MobileRequest .

    O valor padrão é true (a partir da versão 6.0.0 do agente).

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NetworkRequestEvents)

    Habilitar ou desabilitar erro de solicitação HTTP em caso de geração de chamadas de rede do instrumento que resultem em erro ou falha. Esses eventos são relatados como evento MobileRequestError .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_RequestErrorEvents)

    Ative ou desative a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

    O valor padrão é true.

    NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HttpResponseBodyCapture)

    Habilite ou desabilite a instrumentação para sessões de URL de espera assíncrona.

    O valor padrão é false (a partir da versão 7.4.5 do agente).

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftAsyncURLSessionSupport)

    Configurações de tempo de lançamento do aplicativo

    Descrição

    Exemplo

    Ative ou desative o relatório de horário de início do aplicativo (horário frio e quente) como métrica:

    • O tempo frio refere-se ao tempo entre o início do aplicativo e o primeiro sorteio.

    • O tempo quente refere-se ao tempo que leva para um aplicativo retomar a execução em segundo plano até o primeiro sorteio.

      O valor padrão é true (a partir da versão 7.4.0 do agente).

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics)

    Configurações de endpoint do FedRAMP

    Descrição

    Exemplo

    Habilite ou desabilite usando o endpoint FedRAMP.

    O valor padrão é false (a partir da versão 7.4.5 do agente).

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled)

    Armazenamento off-line

    Descrição

    Exemplo

    Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

    O armazenamento offline está desabilitado por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

    NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_OfflineStorage)

    Relatórios de histórico

    Descrição

    Exemplo

    Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

    Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

    NewRelic.enableFeatures([NRMAFeatureFlags.NRFeatureFlag_BackgroundReporting])

    Pré-requisitos no seu projeto de aplicativo iOS para usar instrumentação em segundo plano:

    • Adicione a chave Permitted background task scheduler identifiers com uma matriz incluindo um item contendo o ID do pacote de aplicativos.
    • Habilite a Background Fetch e Background Processing na seção Background Modes dos recursos do projeto Xcode.

    Observação: o iOS só garante que o iOS coletará em segundo plano uma vez a cada período de vinte e quatro horas.

O SDK do agente Capacitor permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken.

Aqui está um exemplo de configuração:

import { NewRelicCapacitorPlugin, NREnums, AgentConfiguration } from '@newrelic/newrelic-capacitor-plugin';
import { Capacitor } from '@capacitor/core';
var appToken;
if(Capacitor.getPlatform() === 'ios') {
appToken = '<IOS-APP-TOKEN>';
} else {
appToken = '<ANDROID-APP-TOKEN>';
}
let agentConfig : AgentConfiguration = {
analyticsEventEnabled: false,
crashReportingEnabled: false,
interactionTracingEnabled: false,
networkRequestEnabled: false,
networkErrorRequestEnabled: false,
httpResponseBodyCaptureEnabled: false,
loggingEnabled: false,
logLevel: NREnums.LogLevel.INFO,
webViewInstrumentation: false,
collectorAddress: "",
crashCollectorAddress: "",
sendConsoleEvents: false,
fedRampEnabled: false,
offlineStorageEnabled: false
}
NewRelicCapacitorPlugin.start({appKey:appToken, agentConfiguration:agentConfig})

Configuração disponível [#configurations]

Descrição

Exemplo

(Somente Android) Ative ou desative a coleta de dados de eventos.

analyticsEventEnabled: true

Ative ou desative o relatório de falhas.

crashReportingEnabled: true

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

interactionTracingEnabled: true

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Ative ou desative a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

httpResponseBodyCaptureEnabled: true

Habilite ou desabilite o log do agente.

loggingEnabled: true

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

logLevel: NREnums.LogLevel.INFO

(somente iOS) Ativar/desativar instrumentação automática de WebViews.

webViewInstrumentation: true

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

collectorAddress: "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

crashCollectorAddress: "crash-upload-delegate.domain.com"

Ative ou desative o envio de log do console JavaScript para o New Relic.

sendConsoleEvents: true

Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

fedRampEnabled: false

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

offlineStorageEnabled: false

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

backgroundReportingEnabled: true

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • No arquivo Info.plist do seu aplicativo, adicione a chave "Identificador do agendador de tarefas em segundo plano permitido". Essa chave deve ser uma matriz contendo um único valor de string, que é o identificador do pacote do seu aplicativo.
  • Na seção Background Modes dos recursos do projeto Xcode, habilite Background Fetch e Background Processing.

Observação: o iOS só garante que o iOS coletará em segundo plano uma vez a cada período de vinte e quatro horas.

O SDK do agente Cordova permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken

Aqui está um exemplo de configuração:

# Disable Crash Reporting
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git
--variable IOS_APP_TOKEN="{ios-app-token}"
--variable ANDROID_APP_TOKEN="{android-app-token}"
--variable CRASH_REPORTING_ENABLED="false"
--variable OFFLINE_STORAGE_ENABLED="false"

Configuração disponível [#configurations]

Descrição

Exemplo

Ative ou desative o relatório de falhas.

CRASH_REPORTING_ENABLED = "true"

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

INTERACTION_TRACING_ENABLED = "true"

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Ative ou desative a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

httpResponseBodyCaptureEnabled: true

Habilite ou desabilite o log do agente.

LOGGING_ENABLED = "true"

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

LOG_LEVEL = "INFO"

(somente iOS) Ativar/desativar instrumentação automática de WebViews.

WEB_VIEW_INSTRUMENTATION = "true"

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

CRASH_COLLECTOR_ADDRESS = "crash-upload-delegate.domain.com"

Ative ou desative o envio de log do console JavaScript para o New Relic.

sendConsoleEvents: true

Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

FEDRAMP_ENABLED = "false"

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

OFFLINE_STORAGE_ENABLED = "false"

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

BACKGROUND_REPORTING_ENABLED = "true"

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • No arquivo Info.plist do seu aplicativo, adicione a chave "Identificador do agendador de tarefas em segundo plano permitido". Essa chave deve ser uma matriz contendo um único valor de string, que é o identificador do pacote do seu aplicativo.
  • Na seção Background Modes dos recursos do projeto Xcode, habilite Background Fetch e Background Processing.

Observação: o iOS só garante que o iOS coletará em segundo plano uma vez a cada período de vinte e quatro horas.

O SDK do agente .NET MAUI permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken.

Aqui está um exemplo de configuração:

using NewRelic.MAUI.Plugin;
...
public static MauiApp CreateMauiApp()
{
var builder = MauiApp.CreateBuilder();
builder
.UseMauiApp<App>()
.ConfigureFonts(fonts =>
{
fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
fonts.AddFont("OpenSans-Semibold.ttf", "OpenSansSemibold");
});
builder.ConfigureLifecycleEvents(AppLifecycle => {
#if ANDROID
AppLifecycle.AddAndroid(android => android
.OnCreate((activity, savedInstanceState) => StartNewRelic()));
#endif
#if IOS
AppLifecycle.AddiOS(iOS => iOS.WillFinishLaunching((_,__) => {
StartNewRelic();
return false;
}));
#endif
});
return builder.Build();
}
private static void StartNewRelic()
{
CrossNewRelic.Current.HandleUncaughtException();
// Set optional agent configuration
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled, webViewInstrumentation, fedRampEnabled, offlineStorageEnabled, newEventSystemEnabled, backgroundReportingEnabled
// AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled:false);
if (DeviceInfo.Current.Platform == DevicePlatform.Android)
{
CrossNewRelic.Current.Start("<APP-TOKEN-HERE>");
// Start with optional agent configuration
// CrossNewRelic.Current.Start("<APP-TOKEN-HERE>", agentConfig);
} else if (DeviceInfo.Current.Platform == DevicePlatform.iOS)
{
CrossNewRelic.Current.Start("<APP-TOKEN-HERE>");
// Start with optional agent configuration
// CrossNewRelic.Current.Start("<APP-TOKEN-HERE", agentConfig);
}
}

Configuração disponível [#configurations]

Descrição

Exemplo

(Somente Android) Ative ou desative a coleta de dados de eventos.

analyticsEventEnabled: true

Ative ou desative o relatório de falhas.

crashReportingEnabled: true

Habilite ou desabilite o log do agente.

loggingEnabled: true

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada. por padrão falso

interactionTracingEnabled: false

Habilite/desabilite a instrumentação automática de WebViews.

webViewInstrumentation: false

Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

fedRampEnabled: false

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

logLevel: NREnums.LogLevel.INFO

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

collectorAddress: "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

crashCollectorAddress: "crash-upload-delegate.domain.com"

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

offlineStorageEnabled: false

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

backgroundReportingEnabled: true

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • No arquivo Info.plist do seu aplicativo, adicione a chave "Identificador do agendador de tarefas em segundo plano permitido". Essa chave deve ser uma matriz contendo um único valor de string, que é o identificador do pacote do seu aplicativo.

O SDK do agente Flutter permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken.

Aqui está um exemplo de configuração:

if (Platform.isAndroid) {
appToken = AppConfig.androidToken;
} else if (Platform.isIOS) {
appToken = AppConfig.iOSToken;
}
Config config = Config(
accessToken: appToken,
analyticsEventEnabled: false,
networkErrorRequestEnabled: false,
networkRequestEnabled: false,
crashReportingEnabled: false,
interactionTracingEnabled: false,
httpResponseBodyCaptureEnabled: false,
loggingEnabled: false,
webViewInstrumentation: false,
printStatementAsEventsEnabled: false,
httpInstrumentationEnabled: false,
offlineStorageEnabled: true);
// NewrelicMobile.instance.start(config, () {
// runApp(MyApp());
// });
runZonedGuarded(() async {
WidgetsFlutterBinding.ensureInitialized();
FlutterError.onError = NewrelicMobile.onError;
await NewrelicMobile.instance.startAgent(config);
runApp(MyApp());
}, (Object error, StackTrace stackTrace) {
NewrelicMobile.instance.recordError(error, stackTrace);
});

Configuração disponível [#configurations]

Descrição

Exemplo

(Somente Android) Ative ou desative a coleta de dados de eventos.

analyticsEventEnabled: true

Ative ou desative o relatório de falhas.

crashReportingEnabled: true

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

interactionTracingEnabled: true

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Ative ou desative a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

httpResponseBodyCaptureEnabled: true

Habilite ou desabilite o log do agente.

loggingEnabled: true

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

logLevel: NREnums.LogLevel.INFO

(somente iOS) Ativar/desativar instrumentação automática de WebViews.

webViewInstrumentation: true

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

collectorAddress: "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

crashCollectorAddress: "crash-upload-delegate.domain.com"

Ative ou desative o envio de log do console JavaScript para o New Relic.

sendConsoleEvents: true

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

offlineStorageEnabled: false

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

backgroundReportingEnabled: true

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • No arquivo Info.plist do seu aplicativo, adicione a chave "Identificador do agendador de tarefas em segundo plano permitido". Essa chave deve ser uma matriz contendo um único valor de string, que é o identificador do pacote do seu aplicativo.
  • Na seção Background Modes dos recursos do projeto Xcode, habilite Background Fetch e Background Processing.

Observação: o iOS só garante que o iOS coletará em segundo plano uma vez a cada período de vinte e quatro horas.

O SDK do agente React Native permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken.

Aqui está um exemplo de configuração:

import NewRelic from 'newrelic-react-native-agent';
import * as appVersion from './package.json';
import {Platform} from 'react-native';
let appToken;
if (Platform.OS === 'ios') {
appToken = '<IOS-APP-TOKEN>';
} else {
appToken = '<ANDROID-APP-TOKEN>';
}
const agentConfiguration = {
Config config = Config(
analyticsEventEnabled: false,
crashReportingEnabled: false,
interactionTracingEnabled: false,
networkRequestEnabled: false,
networkErrorRequestEnabled: false,
httpResponseBodyCaptureEnabled: false,
loggingEnabled: false,
logLevel: NREnums.LogLevel.INFO,
webViewInstrumentation: false,
collectorAddress: "",
crashCollectorAddress: "",
sendConsoleEvents: false,
fedRampEnabled: false,
offlineStorageEnabled:false
};
NewRelic.startAgent(appToken,agentConfiguration);
NewRelic.setJSAppVersion(appVersion.version);
AppRegistry.registerComponent(appName, () => App);

Configuração disponível [#configurations]

Descrição

Exemplo

(Somente Android) Ative ou desative a coleta de dados de eventos.

analyticsEventEnabled: true

Ative ou desative o relatório de falhas.

crashReportingEnabled: true

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada.

interactionTracingEnabled: true

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Ative ou desative a captura de corpos de resposta HTTP para rastreamento de erro HTTP e evento MobileRequestError .

httpResponseBodyCaptureEnabled: true

Habilite ou desabilite o log do agente.

loggingEnabled: true

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

logLevel: NREnums.LogLevel.INFO

(somente iOS) Ativar/desativar instrumentação automática de WebViews.

webViewInstrumentation: true

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

collectorAddress: "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

crashCollectorAddress: "crash-upload-delegate.domain.com"

Ative ou desative o envio de log do console JavaScript para o New Relic.

sendConsoleEvents: true

Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

fedRampEnabled: false

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

offlineStorageEnabled: false

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

backgroundReportingEnabled: true

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • No arquivo Info.plist do seu aplicativo, adicione a chave "Identificador do agendador de tarefas em segundo plano permitido". Essa chave deve ser uma matriz contendo um único valor de string, que é o identificador do pacote do seu aplicativo.
  • Na seção Background Modes dos recursos do projeto Xcode, habilite Background Fetch e Background Processing.

Observação: o iOS só garante que o iOS coletará em segundo plano uma vez a cada período de vinte e quatro horas.

A New Relic oferece configurações padrão para monitoramento de aplicativos móveis no Unity. Você pode ajustar facilmente essas configurações no editor do Unity para atender às suas necessidades específicas.

Para definir essas configurações:

  1. Lance o Unity Editor e abra seu projeto Unity.

  2. Na barra de menu, selecione Tools > New Relic > Getting Started > New Relic Configuration.

  3. A janela esquerda do Inspector exibe uma lista de configurações padrão. Basta marcar a caixa ao lado de uma configuração para ativá-la ou desmarcar a caixa para desativá-la.

  4. Clique em Add component.

New Relic oferece configurações padrão para monitoramento de aplicativos móveis no Unreal Engine. Você pode ajustar facilmente essas configurações no editor Unreal para atender às suas necessidades específicas.

Para definir essas configurações:

  1. lance o Unreal Editor e abra seu projeto Unreal.

  2. Na barra de menu, selecione Plugins > New Relic > .

O SDK do agente Xamarin permite definir configurações padrão para alterar o comportamento do agente.

Se você fizer alguma alteração nas configurações padrão, adicione os sinalizadores de recurso logo após chamar appToken.

Aqui está um exemplo de configuração:

public App ()
{
InitializeComponent();
MainPage = new MainPage();
Application.Current.PageAppearing += OnPageAppearing;
Application.Current.PageDisappearing += PageDisappearing;
CrossNewRelicClient.Current.HandleUncaughtException();
CrossNewRelicClient.Current.TrackShellNavigatedEvents();
// Set optional agent configuration
// Options are: crashReportingEnabled, loggingEnabled, logLevel, collectorAddress, crashCollectorAddress,analyticsEventEnabled, networkErrorRequestEnabled, networkRequestEnabled, interactionTracingEnabled,webViewInstrumentation, fedRampEnabled, offlineStorageEnabled
AgentStartConfiguration agentConfig = new AgentStartConfiguration(crashReportingEnabled: false, offlineStorageEnabled: false);
if (Device.RuntimePlatform == Device.Android)
{
//CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE>");
// Start with optional agent configuration
CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE", agentConfig);
}
else if (Device.RuntimePlatform == Device.iOS)
{
//CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE>");
// Start with optional agent configuration
CrossNewRelicClient.Current.Start("<APP-TOKEN-HERE", agentConfig);
}
}
}

Configuração disponível [#configurations]

Descrição

Exemplo

(Somente Android) Ative ou desative a coleta de dados de eventos.

analyticsEventEnabled: true

Ative ou desative o relatório de falhas.

crashReportingEnabled: true

Habilite ou desabilite o log do agente.

loggingEnabled: true

Ative ou desative o relatório de solicitações HTTP bem-sucedidas para o tipo de evento MobileRequest .

networkRequestEnabled: true

Ative ou desative a rede de relatórios e erros de solicitação HTTP para o tipo de evento MobileRequestError .

networkErrorRequestEnabled: true

Especifica o nível de log. Omita este campo para o nível de log padrão.

As opções incluem: ERROR (menos detalhado), WARNING, INFO, VERBOSE, AUDIT (mais detalhado).

logLevel: NREnums.LogLevel.INFO

Defina um endereço de coletor específico para envio de dados. Omita este campo para endereço padrão.

collectorAddress: "crash-upload-delegate.domain.com"

Defina um endereço específico do coletor de falhas para enviar falhas. Omita este campo para endereço padrão.

crashCollectorAddress: "crash-upload-delegate.domain.com"

Ative ou desative o rastreamento de interação. a instrumentação trace ainda ocorre, mas nenhum traço é coletado. Isso desativará a interação padrão e personalizada. por padrão falso

interactionTracingEnabled: false

Habilite/desabilite a instrumentação automática de WebViews.

webViewInstrumentation: false

Ative ou desative dados de relatórios usando endpoints diferentes para clientes do governo dos EUA.

fedRampEnabled: false

Ative ou desative o armazenamento de dados offline quando não houver conexão com a Internet disponível. Para configurar a quantidade de armazenamento offline, consulte Definir tamanho máximo de armazenamento offline.

O armazenamento offline está ativado por padrão. Para desativá-lo, adicione o seguinte sinalizador de recurso:

offlineStorageEnabled: false

Habilite ou desabilite relatórios em segundo plano quando o aplicativo passar para o estado de segundo plano.

Os relatórios em segundo plano estão desativados por padrão. Para habilitá-lo, adicione o seguinte sinalizador de recurso:

backgroundReportingEnabled: true

Para usar a instrumentação em segundo plano, você precisará do seguinte em seu projeto de aplicativo iOS:

  • Adicione a chave Permitted background task scheduler identifiers com uma matriz incluindo um item contendo o ID do pacote de aplicativos.
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.