Création d’un moniteur d’application CloudWatch RUM

Pour créer un moniteur d'application

1. Ouvrez la console CloudWatch à 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. Saisissez les informations et les paramètres de votre application :

   • Pour App monitor name (Nom du moniteur d'application), saisissez un nom à utiliser pour identifier ce moniteur d'application dans la console CloudWatch RUM.

   • Pour Liste des domaines d’application, saisissez les noms de domaine enregistrés sur lesquels votre application dispose d’une autorité administrative. Vous pouvez également utiliser un caractère générique * pour autoriser les sous-domaines ou domaines de premier niveau (par exemple, *.amazon.com, amazon.*, *.amazon.*).

5. Pour Configure RUM data collection (Configurer la collecte des données RUM), indiquez si vous souhaitez que le moniteur d'application collecte chacun des éléments suivants :

   • Performance telemetry (Télémétrie de performance) : collecte des informations sur le chargement des pages et les temps de chargement des ressources.

   • JavaScript errors (Erreurs JavaScript) : collecte des informations sur les erreurs JavaScript non gérées signalées par votre application.

     Vous pouvez sélectionner Déminifier les suivis de pile d’erreurs JavaScript pour déboguer les erreurs JavaScript non minifiées. Pour utiliser cette fonctionnalité, chargez vos fichiers de sourçage dans un compartiment ou dossier Amazon S3, puis indiquez l’URI Amazon S3 correspondant. Une fois activée, RUM utilisera ces fichiers de sourçage pour enrichir les événements d’erreurs JavaScript en y ajoutant le suivi de pile déminifiée. Notez qu’après activation, cette fonctionnalité ne s’applique qu’aux nouvelles erreurs JavaScript ; elle ne peut pas traiter les données déjà collectées. Pour de plus amples informations, consultez Activation de la déminification des suivis de pile d’erreurs JavaScript.

   • HTTP errors (Erreurs HTTP) : collecte des informations sur les erreurs HTTP levées par votre application.

   En sélectionnant ces options, vous obtiendrez plus d'informations sur votre application, mais cela générera également davantage d'événements CloudWatch RUM et entraînera par conséquent plus de frais.

   Si vous ne sélectionnez aucun de ces éléments, le moniteur d'application continue de collecter les événements de démarrage de session et les ID de page. Ainsi, vous pouvez voir combien d'utilisateurs utilisent votre application, y compris des répartitions par type et version de système d'exploitation, type et version de navigateur, type d'appareil et emplacement.

6. Sélectionnez Check this option to allow the CloudWatch RUM Web Client to set cookies (Cochez cette option pour autoriser le client web CloudWatch RUM à définir des cookies) si vous souhaitez pouvoir collecter des ID utilisateur et des ID de session à partir de sessions utilisateur échantillonnées. Les ID utilisateur sont générés aléatoirement par RUM. Pour de plus amples informations, consultez Cookies du client web CloudWatch RUM (ou technologies similaires).

7. Pour Session samples (Exemples de session), saisissez le pourcentage de sessions utilisateur qui seront utilisées pour collecter des données RUM. La valeur par défaut est 100 %. Si vous réduisez cette valeur, vous obtiendrez moins de données, mais vos frais seront réduits. Pour plus d'informations sur la tarification RUM, consultez Tarification RUM.

8. Les données des utilisateurs finaux que vous collectez pour CloudWatch RUM sont retenues pendant 30 jours, puis supprimées. Si vous souhaitez conserver des copies des événements RUM dans CloudWatch Logs et configurer la durée de rétention de ces copies, choisissez Check this option to store your application telemetry data in your CloudWatch Logs account (Cochez cette option pour stocker les données de télémétrie de votre application dans votre compte CloudWatch Logs) sous Data storage (Stockage de données). Par défaut, le groupe de journaux CloudWatch Logs retient les données pendant 30 jours. Vous pouvez ajuster la période de rétention dans la console CloudWatch Logs.

9. (Facultatif) Ajoutez une politique basée sur les ressources à votre moniteur d’application pour contrôler qui peut envoyer des requêtes PutRumEvents à votre moniteur. Si vous sélectionnez Créer une politique publique, une politique de ressources sera attachée à votre moniteur d’application, ce qui permettra à n’importe qui d’envoyer des requêtes PutRumEvents à votre moniteur. Pour plus d’informations sur cette méthode, consultez Utilisation des politiques basées sur les ressources avec CloudWatch RUM.

10. Si vous avez attachée une politique basée sur les ressources à l’étape 9, il n’est pas nécessaire de signer les requêtes envoyées à CloudWatch RUM avec des informations d’identification AWS, et vous pouvez ignorer la configuration de l’autorisation. Sinon, pour Autorisation, indiquez si vous souhaitez utiliser un nouvel groupe d’identités Amazon Cognito, un groupe existant, ou un autre fournisseur d’identité. La création d'un nouveau groupe d'identités est l'option la plus simple et ne nécessite aucune autre étape de configuration. Pour plus d’informations, consultez Étape 1 : autorisez votre application à envoyer des données à AWS.

    La création d'un nouveau groupe d'identités Amazon Cognito nécessite des autorisations administratives. Pour de plus amples informations, consultez Stratégies IAM pour utiliser CloudWatch RUM.

11. (Facultatif) Par défaut, lorsque vous ajoutez l'extrait de code RUM à votre application, le client web injecte l'identification JavaScript pour surveiller l'utilisation dans le code HTML de toutes les pages de votre application. Pour modifier ce comportement, choisissez Configure pages (Configurer les pages), puis choisissez Include only these pages (Inclure uniquement ces pages) ou Exclude these pages (Exclure ces pages). Ensuite, spécifiez les pages à inclure ou à exclure. Pour spécifier une page à inclure ou à exclure, saisissez ses URL complètes. Pour spécifier des pages supplémentaires, choisissez Add URL (Ajouter une URL).

12. Pour activer le suivi AWS X-Ray des sessions utilisateur échantillonnées par le moniteur d'application, choisissez Active tracing (Suivi actif) et sélectionnez Trace my service with AWS X-Ray (Suivre mon service avec ).

    Si vous sélectionnez cette option, les demandes XMLHttpRequest et fetch effectuées pendant les sessions utilisateur échantillonnées par le moniteur d'application sont suivies. Vous pouvez ensuite voir les suivis et les segments de ces sessions utilisateur dans le tableau de bord RUM, ainsi que sur les pages de la carte de suivi X-Ray et de détails des suivis X-Ray. 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.

    En apportant d'autres modifications à la configuration du client web CloudWatch RUM, vous pouvez ajouter un en-tête de suivi X-Ray aux demandes HTTP pour activer le suivi de bout en bout des sessions utilisateur jusqu'aux services managés AWS en aval. Pour de plus amples informations, consultez Activation du suivi X-Ray de bout en bout.

13. (Facultatif) Pour ajouter des identifications au moniteur d'application, choisissezTags (Identifications), Add new tag (Ajouter une nouvelle identification).

    Ensuite, pour Key (Clé), saisissez un nom pour l'identification. Vous pouvez ajouter une valeur en option pour la balise dans Value (Valeur).

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

    Pour plus d'informations, consultez Identification des ressources AWS.

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

15. Dans la section Sample code (Exemple de code), vous pouvez copier l'extrait de code à utiliser pour ajouter à votre application. Nous vous recommandons de choisir JavaScript ou TypeScript et d'utilise NPM pour installer le client web CloudWatch RUM en tant que module JavaScript.

    Vous pouvez également choisir HTML pour utiliser un réseau de diffusion de contenu (CDN) et installer le client web CloudWatch RUM. L'inconvénient de l'utilisation d'un CDN est que le client web est souvent bloqué par des bloqueurs de publicités.

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