Création d'un moniteur d'application CloudWatch RUM - Amazon CloudWatch

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Pour commencer à utiliser CloudWatch RUM avec votre application, vous devez créer un moniteur d'applications. Lorsque le moniteur d'applications est créé, RUM génère un JavaScript extrait que vous pouvez coller dans votre application. Cet extrait importe le code du client web RUM. Le client web RUM capture les données provenant d'un pourcentage des sessions utilisateur de votre application et les envoie à RUM.

Pour créer un moniteur d'application

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

  2. Dans le volet de navigation, choisissez Application Signals, RUM.

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

  4. Saisissez les informations et les paramètres de votre application :

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

    • Pour la liste des domaines de l'application, entrez les noms de domaine enregistrés pour lesquels votre application dispose de l'autorité administrative. Vous pouvez également utiliser un caractère générique * pour autoriser n'importe quel sous-domaine ou domaine 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 erreurs — Recueille des informations sur les JavaScript erreurs non gérées signalées par votre application

      Vous pouvez sélectionner Unminify JavaScript error stack traces pour corriger les erreurs non minimisées. JavaScript Pour utiliser cette fonctionnalité, téléchargez vos fichiers de carte source dans un compartiment ou un dossier Amazon S3 et fournissez l'URI Amazon S3. Une fois activé, RUM utilisera ces cartes sources et enrichira les événements JavaScript d'erreur en ajoutant la trace de pile non minimisée. Notez qu'une fois activée, cette fonctionnalité ne traite que les nouveaux événements JavaScript d'erreur et ne peut pas être utilisée sur des données collectées précédemment. Pour de plus amples informations, veuillez consulter Activation de la minimisation des traces de pile JavaScript d'erreurs.

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

    La sélection de ces options fournit plus d'informations sur votre application, mais génère également davantage d'événements CloudWatch RUM et entraîne donc des frais supplémentaires.

    Si vous ne sélectionnez aucune de ces options, le moniteur de l'application collecte toujours les événements et les pages de démarrage de session IDs afin que vous puissiez voir combien d'utilisateurs utilisent votre application, y compris les ventilations par type et version de système d'exploitation, type et version de navigateur, type d'appareil et emplacement.

  6. Sélectionnez cette option pour autoriser le client Web CloudWatch RUM à définir des cookies si vous souhaitez pouvoir collecter des utilisateurs IDs et des sessions à IDs partir d'échantillons de sessions utilisateur. Les utilisateurs IDs sont générés aléatoirement par RUM. Pour de plus amples informations, veuillez consulter CloudWatch Cookies du client Web 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 d'utilisateur final que vous collectez pour CloudWatch RUM sont conservées pendant 30 jours, puis supprimées. Si vous souhaitez conserver des copies des événements RUM dans les CloudWatch journaux et configurer la durée de conservation de ces copies, choisissez Cocher cette option pour stocker les données de télémétrie de votre application dans votre compte CloudWatch Logs sous Stockage des données. 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.

  9. (Facultatif) Choisissez d'ajouter une politique basée sur les ressources à votre moniteur d'applications afin de contrôler qui peut envoyer des PutRumEvents demandes à votre moniteur d'applications. Si vous choisissez Créer une politique publique, une politique de ressources sera attachée à votre moniteur d'applications pour permettre à quiconque d'envoyer des PutRumEvents demandes à votre moniteur d'applications. Pour plus d'informations sur cette méthode, consultezUtilisation de politiques basées sur les ressources avec RUM CloudWatch .

  10. Si vous avez joint une politique basée sur les ressources à l'étape 9, vous n'avez pas besoin de signer les demandes adressées à CloudWatch RUM avec des AWS informations d'identification et vous pouvez ignorer la configuration de l'autorisation. Sinon, pour Autorisation, spécifiez si vous souhaitez utiliser un pool d'identités Amazon Cognito nouveau ou existant ou utiliser 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, veuillez consulter Politiques IAM pour utiliser RUM CloudWatch .

  11. (Facultatif) Par défaut, lorsque vous ajoutez l'extrait de code RUM à votre application, le client Web injecte la JavaScript balise 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-la complète URLs. Pour spécifier des pages supplémentaires, choisissez Add URL (Ajouter une URL).

  12. Pour activer le AWS X-Ray suivi des sessions utilisateur échantillonnées par le moniteur de l'application, choisissez Suivi actif, puis sélectionnez Tracer mon service avec AWS X-Ray.

    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 des modifications de configuration supplémentaires au client Web CloudWatch RUM, vous pouvez ajouter un en-tête de trace X-Ray aux requêtes HTTP afin de permettre le end-to-end suivi des sessions utilisateur jusqu'aux services AWS gérés en aval. Pour de plus amples informations, veuillez consulter Activation du end-to-end traçage par rayons X.

  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 la section AWS Ressources de balisage.

  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 JavaScriptou TypeScriptd'utiliser NPM pour installer le client Web CloudWatch RUM en tant que JavaScript module.

    Vous pouvez également choisir le format HTML pour utiliser un réseau de diffusion de contenu (CDN) afin d'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é).