Definir configurações de monitoramento de Mobile

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

  Copiar

• Swift:

  NewRelic.start(withApplicationToken:)

  Copiar

  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]; Copiar Desative um sinalizador de recurso: +[NewRelic disableFeatures:(NRMAFeatureFlags)flags]; Copiar 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:...]; Copiar
  Swift	Habilite um sinalizador de recurso: NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) Copiar Desative um sinalizador de recurso: NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) Copiar Exemplo para desativar o rastreamento de interação padrão: NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions) Copiar

  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"); Copiar
  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"); Copiar

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

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

  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) Copiar
  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) Copiar
  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) Copiar
  Habilite ou desabilite a instrumentação automática do WKWebView. O valor padrão é true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_WebViewInstrumentation) Copiar
  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) Copiar

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

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

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

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

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]

analyticsEventEnabled: true

crashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

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

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

sendConsoleEvents: true

fedRampEnabled: false

offlineStorageEnabled: false

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]

CRASH_REPORTING_ENABLED = "true"

INTERACTION_TRACING_ENABLED = "true"

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

LOGGING_ENABLED = "true"

LOG_LEVEL = "INFO"

WEB_VIEW_INSTRUMENTATION = "true"

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

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

sendConsoleEvents: true

FEDRAMP_ENABLED = "false"

FEDRAMP_ENABLED = "false"

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 App()
        {
            InitializeComponent();

            MainPage = new AppShell();

            CrossNewRelic.Current.HandleUncaughtException();
            CrossNewRelic.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 (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]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

interactionTracingEnabled: false

webViewInstrumentation: false

fedRampEnabled: false

logLevel: NREnums.LogLevel.INFO

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

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

offlineStorageEnabled: false

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]

analyticsEventEnabled: true

crashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

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

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

sendConsoleEvents: true

offlineStorageEnabled: false

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]

analyticsEventEnabled: true

crashReportingEnabled: true

interactionTracingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

httpResponseBodyCaptureEnabled: true

loggingEnabled: true

logLevel: NREnums.LogLevel.INFO

webViewInstrumentation: true

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

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

sendConsoleEvents: true

fedRampEnabled: false

offlineStorageEnabled: false

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]

analyticsEventEnabled: true

crashReportingEnabled: true

loggingEnabled: true

networkRequestEnabled: true

networkErrorRequestEnabled: true

logLevel: NREnums.LogLevel.INFO

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

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

interactionTracingEnabled: false

webViewInstrumentation: false

fedRampEnabled: false

offlineStorageEnabled: false