Configurar los ajustes de monitoreo de móviles

El agente iOS de New Relic proporciona ajustes de configuración para cambiar el comportamiento predeterminado del agente. Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar las banderas características justo después de llamar al token de la aplicación. Por ejemplo:

• Objective-C:

  + [NewRelic startWithApplicationToken:]

  Copia

• Swift:

  NewRelic.start(withApplicationToken:)

  Copia

  Activar o desactivar indicadores de características

  Para configurar indicadores de características, utilice el siguiente método definido en NewRelic.h:

  idioma iOS	Procedimiento
  Objective-C	En Objective-C, estas características tienen máscara de bits, por lo que puede usar un | para habilitar o deshabilitar múltiples características al mismo tiempo. Habilite una bandera de característica: +[NewRelic enableFeatures:(NRMAFeatureFlags)flags]; Copia Deshabilitar una bandera de característica: +[NewRelic disableFeatures:(NRMAFeatureFlags)flags]; Copia Aquí hay un ejemplo donde: Se habilita el seguimiento de interacciones y la instrumentación de redes experimentales. NSURLSession La instrumentación y los informes de fallos están deshabilitados. [NewRelic enableFeatures:NRFeatureFlag_SwiftInteractionTracing | NRFeatureFlag_FedRampEnabled]; [NewRelic disableFeatures:NRFeatureFlag_NSURLSessionInstrumentation | NRFeatureFlag_CrashReporting]; [NewRelic startWithApplicationToken:...]; Copia
  Swift	Habilite una bandera de característica: NewRelic.enableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) Copia Deshabilitar una bandera de característica: NewRelic.disableFeatures(NRMAFeatureFlags.[NRMAFeatureFlag]) Copia Ejemplo para deshabilitar el seguimiento de interacción predeterminado: NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions) Copia

  Configuración de extremos de datos

  Descripción	Ejemplo
  Habilite o deshabilite los informes de fallos, que aparecen en la páginaCrash analysis . Especifica el componente de autoridad URI del extremo de carga de datos de recolección. Este extremo también se utiliza para cargas de excepciones controladas. Para reemplazar el extremo de datos que utilizará el agente al informar sobre la recopilación de datos, agregue andCollectorAddress: a su llamada al método NewRelic.start(withApplicationToken:) . El valor predeterminado es mobile-collector.newrelic.com.	NewRelic.start(withApplicationToken:YOUR_APP_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com"); Copia
  Especifica el componente de autoridad del URI de carga de datos de fallos. Para reemplazar el extremo de datos que usará el agente al informar fallas, agregue andCrashCollectorAddress: a su llamada de método NewRelic.start(withApplicationToken:) . El valor predeterminado es mobile-crash.newrelic.com.	NewRelic.start(withApplicationToken:YOUR_APP_TOKEN andCollectorAddress:"harvest-upload.domain.com" andCrashCollectorAddress:"crash-upload.domain.com"); Copia

  Marca de característica de informe de fallas y errores

  Si modifica cualquiera de las configuraciones de informes de fallas y errores a continuación, asegúrese de llamar al indicador de característica antes de que el agente de iOS inicie la llamada.

  Descripción	Ejemplo
  Habilite o deshabilite los informes de fallas, que aparecen en la páginade análisis de fallas . Especifica el componente de autoridad URI del extremo de carga de datos de recolección. Este extremo también se utiliza para cargas de excepciones controladas. Para reemplazar el extremo de datos que utilizará el agente al informar sobre la recopilación de datos, agregue .usingCollectorAddress() a su llamada al método NewRelic.withApplicationToken() . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_CrashReporting) Copia
  Habilite o deshabilite globalmente la grabación del evento de excepciones manejadas, que aparecen en la página Excepción manejada. El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HandledExceptionEvents) Copia

  rastreo distribuido

  Descripción	Ejemplo
  Habilite o deshabilite la adición de encabezados de rastreo distribuido a las solicitudes de red. Consulte Cómo funciona el rastreo distribuido de New Relic para obtener más información sobre el rastreo distribuido en aplicaciones móviles. El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DistributedTracing) Copia

  interacción característica banderas

  Si modifica cualquiera de las configuraciones de informes de fallas y errores a continuación, asegúrese de llamar al indicador de característica justo antes de que el agente iOS de New Relic comience la llamada.

  Descripción	Ejemplo
  Habilite o deshabilite el seguimiento de interacción solo para clases y métodos instrumentados predeterminados. Se informará la interacción personalizada. La traza aparecerá en la páginaInteractions . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_DefaultInteractions) Copia
  Habilitar o deshabilitar globalmente las trazas de interacción, que aparecen en la páginaInteractions . El seguimiento de la interacción se desactivará una vez iniciado el agente. La interacción para cualquier actividad o método ejecutado antes de iniciar el agente aún puede aparecer en la página Interactions . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_InteractionTracing) Copia
  Advertencia Antes de habilitar esta característica, consulte Habilitar traza de interacción Swift. Si no se toman las medidas adecuadas, habilitar esta característica puede causar inestabilidad. Habilite o deshabilite el seguimiento de interacción para el código Swift. La traza aparece en la páginaInteractions . Esta característica siempre estará deshabilitada si NRFeatureFlag_InteractionTracing está deshabilitado. El valor predeterminado es false.	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftInteractionTracing) Copia
  Habilite o deshabilite la instrumentación automática de WKWebView. El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_WebViewInstrumentation) Copia
  Advertencia Esta característica está obsoleta; habilitar esta llamada de bandera de característica puede disminuir la estabilidad de la aplicación. Evite su uso a menos que New Relic se lo indique. Habilite o deshabilite la instrumentación automática de gestos. El valor predeterminado es false.	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_GestureInstrumentation) Copia

  Banderas de características de red

  Si modifica alguna de las configuraciones a continuación, asegúrese de llamar al indicador de característica antes de que el agente iOS de New Relic comience la llamada.

  Descripción	Ejemplo
  Advertencia Esta característica está obsoleta; habilitar esta llamada de bandera de característica puede disminuir la estabilidad de la aplicación. Evite su uso a menos que New Relic se lo indique. Habilite o deshabilite la instrumentación de redes experimental. Esto fuerza todas las NSURLConnection solicitudes de red a través del NRMAURProtocol. El valor predeterminado es false.	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_ExperimentalNetworkingInstrumentation) Copia
  Habilite o deshabilite la instrumentación de red para NSURLSession. Estas trazas de URL se envían a la página de Solicitudes HTTP . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NSURLSessionInstrumentation) Copia
  Habilite o deshabilite la instrumentación de red. Esto envía los datos de respuesta HTTP como evento MobileRequest . El valor predeterminado es true (a partir de la versión 6.0.0 del agente).	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_NetworkRequestEvents) Copia
  Habilita o deshabilita el error de solicitud HTTP en caso de generación de llamadas de red instrumentadas que resulten en un error o falla. Estos eventos se informan como evento MobileRequestError . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_RequestErrorEvents) Copia
  Habilite o deshabilite la captura de cuerpos de respuesta HTTP para traza de error HTTP y evento MobileRequestError . El valor predeterminado es true.	NewRelic.disableFeatures(NRMAFeatureFlags.NRFeatureFlag_HttpResponseBodyCapture) Copia
  Habilite o deshabilite la instrumentación para sesiones de URL de espera asíncronas. El valor predeterminado es false (a partir de la versión 7.4.5 del agente).	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_SwiftAsyncURLSessionSupport) Copia

  Configuración de tiempo de lanzamiento de la aplicación

  Descripción

  Ejemplo

  Habilite o deshabilite la hora de inicio de la aplicación de informes (hora fría y caliente) como métrica: El tiempo frío se refiere al tiempo entre el inicio de la aplicación y el primer sorteo. El tiempo activo se refiere al tiempo que tarda una aplicación en reanudarse desde su ejecución en segundo plano hasta el primer sorteo. El valor predeterminado es true (a partir de la versión 7.4.0 del agente).

  NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_AppStartMetrics) Copia

  Configuración extrema de FedRAMP

  Descripción	Ejemplo
  Habilite o deshabilite el uso del extremo FedRAMP. El valor predeterminado es false (a partir de la versión 7.4.5 del agente).	NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_FedRampEnabled) Copia

  Almacenamiento sin conexión

  Descripción	Ejemplo
  Habilite o deshabilite el almacenamiento de datos sin conexión cuando no haya conexión a Internet disponible. Para configurar la cantidad de almacenamiento sin conexión, consulte Establecer el tamaño máximo de almacenamiento sin conexión.	El almacenamiento sin conexión está deshabilitado de forma predeterminada. Para habilitarlo, agregue el siguiente indicador de característica: NewRelic.enableFeatures(NRMAFeatureFlags.NRFeatureFlag_OfflineStorage) Copia

El SDK del agente Capacitor le permite configurar ajustes predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken.

Aquí hay una configuración de muestra:

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

Configuración disponible [#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

El SDK del agente Cordova le permite configurar ajustes predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken. 

Aquí hay una configuración de muestra:

# 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"

Configuración disponible [#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"

El SDK del agente .NET MAUI le permite configurar valores predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken.

Aquí hay una configuración de muestra:

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



    }

Configuración disponible [#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

El SDK del agente Flutter le permite configurar ajustes predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken.

Aquí hay una configuración de muestra:

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

Configuración disponible [#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

El SDK del agente React Native le permite configurar ajustes predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken.

Aquí hay una configuración de muestra:

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

Configuración disponible [#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

New Relic ofrece configuraciones predeterminadas para el monitoreo de aplicaciones móviles en Unity. Puede ajustar fácilmente estas configuraciones dentro del editor de Unity para satisfacer sus necesidades específicas.

Para configurar estos ajustes:

1. Inicie el Editor de Unity y abra su proyecto de Unity.

2. En la barra de menú, seleccione Tools > New Relic > Getting Started > New Relic Configuration.

3. La ventana del Inspector de la izquierda muestra una lista de configuraciones predeterminadas. Simplemente marque la casilla junto a una configuración para habilitarla o desmarque la casilla para deshabilitarla.

   

4. Haga clic en Add component.

New Relic ofrece configuraciones predeterminadas para el monitoreo de aplicaciones móviles en Unreal Engine. Puede ajustar fácilmente estas configuraciones dentro del editor Unreal para satisfacer sus necesidades específicas.

Para configurar estos ajustes:

1. Lanza el Unreal Editor y abre tu proyecto Unreal.

2. En la barra de menú, seleccione Plugins > New Relic > .

   

El SDK del agente de Xamarin le permite configurar valores predeterminados para cambiar el comportamiento del agente.

Si realiza algún cambio en la configuración predeterminada, asegúrese de agregar los indicadores característicos justo después de llamar appToken.

Aquí hay una configuración de muestra:

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

Configuración disponible [#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