Configurez une application mobile pour utiliser CloudWatch RUM

Pour surveiller les applications mobiles, vous devez créer un moniteur d'applications, le configurer pour les plateformes mobiles et intégrer le SDK AWS Distro for OpenTelemetry (ADOT) à votre application. Le RUM mobile utilise le OpenTelemetry protocole (OTLP) pour envoyer des données de télémétrie à un point de terminaison OTLP dédié.

Pour créer un moniteur d'applications pour une plateforme mobile

1. Ouvrez la CloudWatch console à l'adresse https://console.aws.amazon.com/cloudwatch/.

2. Dans le volet de navigation, sélectionnez Vigie applicative, puis RUM.

3. Choisissez Add app monitor (Ajouter un moniteur d'application).

4. Pour Nom du moniteur d'application, entrez un nom à utiliser pour identifier ce moniteur d'application dans la console CloudWatch RUM.

5. Sélectionnez Android ou iOS comme plateforme.

6. Sous Stockage des données, vous pouvez choisir de stocker des copies des événements et des intervalles des journaux du RUM OTEL dans les CloudWatch journaux et de configurer la conservation. Par défaut, le groupe de CloudWatch journaux Logs conserve les données pendant 30 jours. Vous pouvez ajuster la période de conservation dans la console CloudWatch Logs.

7. (Facultatif) Sous Stratégie basée sur les ressources, choisissez d'ajouter une politique basée sur les ressources pour contrôler qui peut envoyer des demandes au moniteur de votre application. Si vous choisissez Créer une politique publique, une politique de ressources sera jointe qui permettra à quiconque d'envoyer des demandes au moniteur de votre application. Pour de plus amples informations, veuillez consulter Utilisation de politiques basées sur les ressources avec RUM CloudWatch.

8. Pour activer le AWS X-Ray suivi des sessions utilisateur échantillonnées, choisissez Active tracing, puis sélectionnez Trace my service with AWS X-Ray.

   Si cette option est sélectionnée, les plages OTEL générées lors de sessions utilisateur échantillonnées sont tracées. Vous pouvez ensuite consulter les traces et les intervalles de ces sessions dans le tableau de bord RUM, ainsi que sur les pages de carte des X-Ray traces et de détails des traces. Ces sessions utilisateur apparaîtront également sous forme de pages client dans Application Signals une fois que vous les aurez activées pour votre application.

9. (Facultatif) Pour ajouter des balises au moniteur de l'application :

   1. Choisissez Tags, Ajouter un nouveau tag.

   2. Dans le champ Clé, entrez le nom de la balise. Vous pouvez ajouter une valeur facultative dans Value.

   3. Pour ajouter une autre étiquette, sélectionnez à nouveau Add new tag (Ajouter une nouvelle étiquette).

   Pour plus d'informations, consultez la section AWS Ressources de balisage dans le Guide de l'utilisateur de l'éditeur de AWS balises et de balises.

10. Choisissez Add app monitor (Ajouter un moniteur d'application).

11. Dans la section Exemple de code, vous pouvez copier l'extrait de code à ajouter à votre application. À l'aide du SDK AWS Distro for OpenTelemetry (ADOT), vous pouvez choisir entre une instrumentation manuelle pour configurer la surveillance dans le code de votre application ou une Zero-Code instrumentation qui nécessite des modifications de configuration minimes.

    Pour les applications Android et iOS, Zero-Code Instrumentation est l'option la plus simple car elle initialise automatiquement la collecte de télémétrie à l'aide d'un fichier de configuration. L'instrumentation manuelle vous permet de mieux contrôler le processus d'initialisation et de configuration.

12. Choisissez Copy (Copier) ou Download (Télécharger), puis Done (Terminé).

Configuration de l'application iOS

Pour les applications iOS, intégrez le SDK AWS Distro for OpenTelemetry (ADOT) iOS pour activer la surveillance du RUM. Le SDK prend en charge iOS 16 et les versions ultérieures et fournit une instrumentation automatique pour les scénarios de performances courants.

Configuration de l'application Android

Pour les applications Android, intégrez le SDK Android AWS Distro for OpenTelemetry (ADOT) pour activer la surveillance du RUM. Le SDK fournit une instrumentation automatique et prend en charge les modèles d'authentification signés et non signés.

Authentification et sécurité

Mobile RUM prend en charge des modèles d'authentification flexibles tels que définis dans leurs SDK.

• Les applications iOS utilisent le AWS SDK Distro for OpenTelemetry (ADOT) iOS.

• Les applications Android utilisent le AWS SDK Distro for OpenTelemetry (ADOT) Android.