Création d'un moniteur d' CloudWatch RUMapplications - 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' CloudWatch RUMapplications

Pour commencer à utiliser CloudWatch RUM votre application, vous devez créer un moniteur d'application. Lorsque le moniteur d'applications est créé, il RUM génère un JavaScript extrait que vous pouvez coller dans votre application. L'extrait extrait le code du client RUM Web. Le client RUM Web capture les données 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, sélectionnez 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 CloudWatch RUM console.

    • Pour Application domain (Domaine de l'application), saisissez le nom du domaine de premier niveau sur lequel votre application dispose d'une autorité administrative. Cela doit être dans un format URL de domaine.

      Choisissez Include sub domains (Inclure les sous-domaines) pour que le moniteur d'application collecte également des données de tous les sous-domaines situés dans le domaine de premier niveau.

  5. Pour Configurer la collecte de RUM données, spécifiez si vous souhaitez que le moniteur de l'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

    • HTTPerreurs — Recueille des informations sur HTTP les erreurs générées par votre application

    La sélection de ces options fournit plus d'informations sur votre application, mais génère également davantage d' CloudWatch RUMévénements 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 Cochez cette option pour autoriser le client CloudWatch RUM Web à définir des cookies si vous souhaitez pouvoir collecter les utilisateurs IDs et les sessions à IDs partir d'échantillons de sessions utilisateur. Les utilisateurs IDs sont générés aléatoirement parRUM. Pour de plus amples informations, veuillez consulter CloudWatch RUMcookies de clients Web (ou technologies similaires).

  7. Pour les exemples de session, entrez le pourcentage de sessions utilisateur qui seront utilisées pour collecter RUM des données. 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 RUM tarification, consultez la section RUMtarification.

  8. Les données d'utilisateur final que vous collectez CloudWatch RUM sont conservées pendant 30 jours, puis supprimées. Si vous souhaitez conserver des copies des RUM événements 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. Pour Authorization (Autorisation), spécifiez s'il faut utiliser un groupe 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 de plus amples informations, veuillez consulter Autoriser votre application à envoyer des données à AWS à travers CloudWatch RUM.

    La création d'un nouveau groupe d'identités Amazon Cognito nécessite des autorisations administratives. Pour de plus amples informations, veuillez consulter IAMpolitiques à utiliser CloudWatch RUM.

  10. (Facultatif) Par défaut, lorsque vous ajoutez l'extrait de RUM code à votre application, le client Web injecte la JavaScript balise pour surveiller l'utilisation dans le HTML code 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èteURLs. Pour spécifier des pages supplémentaires, choisissez Ajouter URL.

  11. Pour activer AWS X-Ray suivi des sessions utilisateur échantillonnées par le moniteur de l'application, choisissez Suivi actif et 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 traces et les segments de ces sessions utilisateur dans le RUM tableau de bord, ainsi que sur les pages de carte de suivi et de détails des traces de 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 CloudWatch RUM Web, vous pouvez ajouter un en-tête de trace X-Ray aux HTTP demandes afin de permettre le end-to-end suivi des sessions utilisateur jusqu'en aval AWS services gérés. Pour de plus amples informations, veuillez consulter Activation du end-to-end traçage par rayons X.

  12. (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 Balisage AWS Ressources.

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

  14. 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 CloudWatch RUM Web en tant que JavaScript module.

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

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