Monitorez votre application mobile Cordova

Créer un ou plusieurs jeton(s) d'application

1. Accédez à one.newrelic.com > Browser & Mobile > (choose Android or iOS), puis terminez les étapes d’instrumentation dans l’interface utilisateur.
2. Depuis Step 4 dans l'interface utilisateur, copiez le(s) jeton(s) d'application (un pour iOS et Android le cas échéant).

Ajoutez l'agent Cordova

Dans votre répertoire de projet Cordova, ajoutez l'agent Cordova à votre projet à l'aide de votre outil de ligne de commande et collez le(s) jeton(s) d'application dans l'argument --variable :

$
# Install from github repository
$
cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"

(Facultatif) Configurer l'agent

Ajoutez la configuration facultative suivante à l’argument --variable , qui les appellera au démarrage de l’agent :

• CRASH_REPORTING_ENABLED: Activer ou désactiver les rapports de plantage.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• DISTRIBUTED_TRACING_ENABLED: Activer ou désactiver l'ajout d'en-têtes de tracing distribués aux requests réseau.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• INTERACTION_TRACING_ENABLED: Activer ou désactiver le tracing interaction . instrumentation de traces est toujours effectuée, mais aucune trace n'est récoltée. Cela désactivera l'interaction par défaut et personnalisée.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• DEFAULT_INTERACTIONS_ENABLED: Activer ou désactiver l'interaction par défaut. instrumentation de traces est toujours effectuée, mais aucune trace n'est récoltée. Cela activera ou désactivera l'interaction par défaut uniquement pendant que l'interaction personnalisée reste activée.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• LOGGING_ENABLED: Activer ou désactiver le logging de l'agent.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• LOG_LEVEL: Spécifie le niveau de log.

  • Les valeurs possibles sont ERROR (le moins verbeux), WARNING INFO, VERBOSE, DEBUG, AUDIT (le plus verbeux).
  • La valeur par défaut est INFO sur Android et WARNING sur iOS.

• WEB_VIEW_INSTRUMENTATION (iOS UNIQUEMENT) : activer (par défaut) ou désactiver l'instrumentation automatique WKWebView.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• COLLECTOR_ADDRESS:Spécifie le composant d'autorité URI du point de terminaison de téléchargement des données de récolte.

• CRASH_COLLECTOR_ADDRESS:Spécifie le composant d'autorité de l'URI de téléchargement des données de crash.

• FEDRAMP_ENABLED: Activer ou désactiver les données de rapport à l'aide de différents points de terminaison pour les clients du gouvernement américain.

  • Les valeurs possibles sont true et false. La valeur par défaut est false.

• OFFLINE_STORAGE_ENABLED: Activez ou désactivez le stockage de données hors ligne lorsqu'aucune connexion Internet n'est disponible.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• NEW_EVENT_SYSTEM_ENABLED: Activez ou désactivez l'utilisation de notre nouvel agent système d'événements plus stable pour iOS.

  • Les valeurs possibles sont true et false. La valeur par défaut est true.

• BACKGROUND_REPORTING_ENABLED: Activer ou désactiver le rapport d'événements en arrière-plan lorsque l'application est en arrière-plan.

  • Les valeurs possibles sont true et false. La valeur par défaut est false.

  Ces options ne sont disponibles que sur l'agent Cordova v6.2.1 et supérieur.

  Par exemple, si vous souhaitez désactiver les rapports d'incident, appelez la commande suivante :

  bash

  Copier

  $
  cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN" --variable CRASH_REPORTING_ENABLED="false"

(Ionic Cordova uniquement) Configurez votre framework Ionic

Si vous utilisez un framework ionique, ajoutez ceci à votre répertoire de projet Cordova :

$
ionic cordova plugin add https://github.com/newrelic/newrelic-cordova-plugin.git --variable IOS_APP_TOKEN="YOUR_IOS_APP_TOKEN" --variable ANDROID_APP_TOKEN="YOUR_ANDROID_APP_TOKEN"
$
npm install @awesome-cordova-plugins/newrelic

Assurez-vous de coller vos jetons d'application dans appToken = "" dans le code ci-dessus. Si vous lancez votre application hybride sur les plateformes iOS et Android , vous devrez ajouter deux jetons distincts : un pour iOS et un pour Android.

déployez votre application

Ensuite, lancez votre application. Après quelques activités de l'application, vous devriez voir des données dans New Relic (cela peut prendre quelques minutes après le déploiement de votre application).