Surveillance des applications mobiles

Assurez-vous que les prérequis suivants sont remplis avant d'installer l'agent iOS :

• iOS version 12 ou ultérieure
• Swift 5.4 ou une version ultérieure

Pour ajouter le gestionnaire de paquets d' Swift, procédez comme suit :

1. Ouvrez Xcode.
2. Ouvrez votre projet Xcode.
3. Sélectionnez le menu Fichier > Ajouter des dépendances de package ....
4. Dans la fenêtre qui s'affiche, saisissez le dépôt https://github.com/instana/iOSAgent dans le champ « Rechercher ou saisir l' URL du paquet ». Ensuite, sélectionnez iosagent dans les résultats de recherche, puis cliquez Add Package sur.

Pour ajouter CocoaPods,, procédez comme suit :

1. Dans votre spécification Podfile , ajoutez les commandes suivantes:

   pod 'InstanaAgent', '~> 1.8.9'
    

2. Téléchargez les dépendances, exécutez pod install.

Dans la commande, remplacez 1.8.9 par la dernière version de l'agent iOS répertoriée dans https://cocoapods.org/pods/InstanaAgent.

Pour plus d'informations sur la procédure d'installation, consultez la page de l'agent « iOS » à l'adresse API.

Pour ajouter le plug-in Android « Instana », procédez comme suit :

1. Dans votre fichier build.gradle de niveau projet, ajoutez le code suivant:
   Remarque : la version 6.3.0 est utilisée à titre d'exemple dans l'extrait de code suivant. Pour connaître la dernière version de l'agent Instana, consultez la page https://mvnrepository.com/artifact/com.instana/android-agent-runtime.

   buildscript {
      ext {
           instanaAgentVersion = "6.3.0"
       }
      repositories {
           google()
           mavenCentral()
       }
      dependencies {
         classpath "com.instana:android-agent-plugin:$instanaAgentVersion"
       }
   }
    

2. Dans le fichier Gradle de votre module (niveau application) (généralement app/build.gradle) après avoir appliqué le plug-in com.android.application , ajoutez le code suivant:

apply plugin: 'com.android.application'
apply plugin: 'com.instana.android-agent-plugin'
 

Pour ajouter l' Instana Android SDK, procédez comme suit :

1. Dans votre fichier build.gradle de niveau projet, ajoutez le code suivant:

   allprojects {
       repositories {
           google()
           mavenCentral()
       }
   }
    

2. Dans le fichier Gradle de votre module (niveau application) (généralement app/build.gradle), ajoutez le code suivant:

   dependencies {
       implementation 'com.instana:android-agent-runtime:$instanaAgentVersion'
   }
    

3. Si minSdkVersion est antérieur à 24, dans le fichier Gradle de votre module (niveau d'application) (généralement app/build.gradle), ajoutez le code suivant:

   android {
       compileOptions {
           sourceCompatibility JavaVersion.VERSION_1_8
           targetCompatibility JavaVersion.VERSION_1_8
       }
   }
    

4. Facultatif : demander READ_PHONE_STATE l'autorisation. Lorsqu'un utilisateur se connecte à Internet via un réseau mobile, l'agent « Instana » peut indiquer le type précis de réseau mobile utilisé.

Pour activer la génération de rapports sur le type de réseau cellulaire, votre application doit demander l'autorisation READ_PHONE_STATE . Pour plus d'informations sur la demande d'autorisations, consultez la Request App Permissions section correspondante dans la documentation officielle d'Android.

Si votre application ne demande pas cette autorisation ou si l'utilisateur la refuse, l'agent « Instana » ne communique pas le type de réseau cellulaire. Dans votre classe, qui étend Application, remplacez YOUR_REPORTING_URL et YOUR_APP_KEY par les valeurs de configuration que vous trouverez dans votre tableau de bord d' Instana :

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Instana.setup(
            this,
            InstanaConfig(
                key = "YOUR_APP_KEY",
                reportingURL = "YOUR_REPORTING_URL"
            )
        )
    }
}
 

L'initialisation de base est terminée dans cette étape. Pour obtenir la liste complète des options d'initialisation, du suivi des vues et d'autres options, consultez la documentation de l'agent Android API.

Pour configurer l'agent Instana React Native, procédez comme suit :

1. Ajoutez une dépendance, exécutez la commande suivante dans la racine de votre projet:

   npm install @instana/react-native-agent --save
    

2. Dans votre fichier de App.js classe, remplacez YOUR_INSTANA_APP_KEY et YOUR_INSTANA_REPORTING_URL par les valeurs de configuration que vous trouverez dans votre tableau de bord Instana :

export default class App extends Component {
  componentDidMount() {
    Instana.setup(YOUR_INSTANA_APP_KEY, YOUR_INSTANA_REPORTING_URL, null);
  }
}
 

L'initialisation de base est terminée dans cette étape. Pour obtenir la liste complète des options d'initialisation, du suivi des vues et d'autres options, consultez la page de l'agent « React Native » à l'adresse API.

• Pour empêcher l'agent d' Instana s de communiquer avec le bundler Metro, ajoutez http://localhost:8081 à la liste des URL ignorées :

Instana.setIgnoreURLsByRegex(['http://localhost:8081.*']);
 

• Pour prendre en charge les applications « iOS », votre projet doit contenir au moins un fichier « Swift » (qui peut être vide). Si vous n'avez pas de fichiers « Swift », ouvrez votre projet Xcode, <YourReactNativeProject>/ios puis ajoutez un fichier « Swift » vide. Xcode crée l'en-tête de pont pour vous.

• Pour prendre en charge les applications Android, utilisez la version du plug-in Android « Instana » adaptée à votre version d' React Native :

  • Pour l' React Native, 0.63.3 ou une version antérieure, utilisez Instana; pour le plug-in Android, 1.5.3
  • Pour l' React Native, 0.63.4 ou une version ultérieure, utilisez Instana; pour le plug-in Android, 5.2.2 ou une version ultérieure

Suivez ces étapes pour activer la surveillance automatique d' HTTP :

1. Dans votre fichier /android/build.gradle , ajoutez le code suivant:

   buildscript {
       ext {
           INSTANA_ANDROID_PLUGIN_VERSION = "6.2.5"
       }
       dependencies {
           classpath "com.instana:android-agent-plugin:$INSTANA_ANDROID_PLUGIN_VERSION"
       }
   }
    

2. Dans votre fichier /android/app/build.gradle , ajoutez le code suivant:

   apply plugin: 'com.android.application'
   apply plugin: 'com.instana.android-agent-plugin'
    

Le paquet « Flutter » de l'agent d' Instana s est disponible à l'adresse pub.dev.

Pour ajouter le package à votre application, procédez comme suit:

1. Ouvrez le fichier pubspec.yaml situé dans le dossier de l'application, puis ajoutez instana_agent: dans dependencies.

2. Installez le paquet en utilisant l'une des méthodes suivantes :

   • A partir de la console: Exécutez flutter pub get
   • Depuis Android Studio ou IntelliJ:, cliquez sur « Packages » dans le ruban « Get in the action » de pubspec.yaml
   • Depuis VS Code: cliquez sur Obtenir des packages dans le ruban d'action depubspec.yaml

Importez le package dans vos fichiers dart:

import 'package:instana_agent/instana_agent.dart';
 

Arrêtez et redémarrez l'application, si nécessaire.

Configurez Instana dès que possible. Par exemple, dans initState(), ajoutez le code suivant:

@override
  void initState() {
    super.initState();
    InstanaAgent.setup(key: 'YOUR-INSTANA-KEY', reportingUrl: 'YOUR-REPORTING_URL');
  }
 

Si vous souhaitez développer des applications pour l' iOS,, configurez une version de la plateforme ${appFolder}/ios/Podspec avec une valeur minimale de 11.0.

Une fois l'agent « Instana » initialisé, ajoutez InstanaAgent.setView('Home');:

import 'package:instana_agent/instana_agent.dart';

[...]

InstanaAgent.setView('Home');
 

Une fois l'agent « Instana » initialisé, commencez à enregistrer les requêtes « HTTP » :

import 'package:instana_agent/instana_agent.dart';

[...]

InstanaAgent.startCapture(url: 'https://example.com/success', method: 'GET').then((marker) => marker
    ..responseStatusCode = 200
    ..responseSizeBody = 1000
    ..responseSizeBodyDecoded = 2400
    ..finish());
 

Créez votre propre InstrumentedHttpClient extension http.BaseClient , comme illustré dans l'exemple suivant:

class _InstrumentedHttpClient extends BaseClient {
   _InstrumentedHttpClient(this._inner);

   final Client _inner;

   @override
   Future<StreamedResponse> send(BaseRequest request) async {
      final Marker marker = await InstanaAgent.startCapture(url: request.url.toString(), method: request.method);

      StreamedResponse response;
      try {
         response = await _inner.send(request);
         marker
            ..responseStatusCode = response.statusCode
            ..responseSizeBody = response.contentLength
            ..backendTracingID = BackendTracingIDParser.fromHeadersMap(response.headers);
      } finally {
         await marker.finish();
      }

      return response;
   }
}

class _MyAppState extends State<MyApp> {

   [...]

   Future<void> httpRequest() async {
      final _InstrumentedHttpClient httpClient = _InstrumentedHttpClient(Client());
      final Request request = Request("GET", Uri.parse("https://www.ibm.com/products/instana"));
      httpClient.send(request);
   }

   [...]
}
 

Un événement de démarrage de session se produit lorsqu'un utilisateur lance l'application. La vignette « Début de session » affiche le nombre total de balises de début de session envoyées par l'agent Instana au cours de la période que vous avez sélectionnée.

La vignette « Utilisateurs uniques » indique le nombre total d'utilisateurs disposant d'un identifiant unique. Si aucun identifiant utilisateur unique n'est défini, c'est l'identifiant userSessionIdentifier (usi) qui est pris en compte à la place. Dans ce cas, toutes les sessions suivantes utilisent le même identifiant jusqu'à ce que l'application soit désinstallée ou que la mémoire cache soit vidée.

Le champ « usi » a été introduit dans la version 6.0.6 de l'agent Android et dans la version 1.6.5 de l'agent iOS. Si vous utilisez une ancienne version de l'agent, le champ « usi » serait vide et chaque session correspondrait à un nouvel utilisateur.

Les balises de transition entre vues sont envoyées lorsqu'un utilisateur passe d'une vue à une autre dans l'application. Par exemple, lorsque vous passez de l'écran d'accueil à l'écran Produits, la vignette « Transitions de vue » affiche le nombre total de balises de transition de vue pour la période sélectionnée.

La tuile « Taux de sessions affectées par des plantages » indique le pourcentage de sessions au cours desquelles les utilisateurs ont rencontré des plantages au cours de la période sélectionnée. Vous pouvez calculer le nombre de sessions affectées par des plantages en divisant le nombre de sessions au cours desquelles des plantages se sont produits par le nombre total de sessions uniques, comme l'indique la formule suivante :

Crash affected session rate = (Number of sessions with crashes / Total number of unique sessions) * 100
 

La tuile « Taux d'utilisateurs ayant subi un plantage » indique le pourcentage d'utilisateurs uniques ayant subi un plantage au cours de leur session pendant la période sélectionnée. Vous pouvez calculer le taux d'utilisateurs touchés par des plantages en divisant le nombre d'utilisateurs ayant subi des plantages de session par le nombre total d'utilisateurs uniques, comme l'indique la formule suivante :

Crash affected user rate = (Number of users with crashes / Total number of unique users) * 100
 

Le graphique « Plantages » affiche le nombre de plantages de l'application mobile sur une période donnée. L'axe des x représente l'intervalle de temps, tandis que l'axe des y indique le nombre total d'accidents survenus pendant cet intervalle. Cela permet d'identifier les tendances, les heures de pointe ou les périodes spécifiques où la fréquence des accidents est plus élevée. Pour obtenir plus de détails sur l'incident, cliquez sur l'événement correspondant dans le graphique.

Le nombre d'accidents affiché varie en fonction de la période sélectionnée. Par exemple, si l'option « Last Minute » est sélectionnée, chaque barre représente le nombre de plantages par seconde, l'axe des x indiquant les secondes. Lorsque l'option « Dernière heure » est sélectionnée, chaque barre représente le nombre de pannes par minute, et l'axe des x indique le temps en minutes.

Par défaut, la carte « Principaux groupes d'accidents » affiche les groupes d'accidents les plus fréquents. Un ensemble d'erreurs comprend le type d'erreur et le message d'erreur correspondant. Pour afficher les groupes de plantages les plus fréquents en fonction du nombre d'utilisateurs concernés, passez de l'onglet « Occurrences » à l'onglet « Affected Users » dans la fiche.

La fiche « Vues les plus consultées » affiche les occurrences des transitions vers les vues les plus consultées par le client.

La carte « Principales origines des requêtes » ( HTTP ) affiche les principaux points de terminaison vers lesquels les appels sont effectués. Si vous passez à l'onglet « Erreurs », vous pouvez voir le pourcentage d'appels ayant généré des erreurs.