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.

Modification de l'extrait de code pour configurer le client CloudWatch RUM Web (facultatif)

Vous pouvez modifier l'extrait de code avant de l'insérer dans votre application, pour activer ou désactiver plusieurs options. Pour plus d'informations, consultez la documentation du client CloudWatch RUM Web.

Il y a trois options de configuration que vous devez absolument connaître. Celles-ci sont décrites dans ces sections.

Empêcher la collecte de ressources URLs susceptibles de contenir des informations personnelles

Par défaut, le client CloudWatch RUM Web est configuré pour enregistrer les URLs ressources téléchargées par l'application. Ces ressources incluent HTML des fichiers, CSS des images, JavaScript des fichiers, des fichiers, etc. Pour certaines applications, URLs peut contenir des informations personnellement identifiables (PII).

Si tel est le cas pour votre application, nous vous recommandons vivement de désactiver la collecte de ressources recordResourceUrl: false en URLs définissant la configuration de l'extrait de code, avant de l'insérer dans votre application.

Enregistrement manuel des consultations de page

Par défaut, le client Web enregistre les pages consultées lors du premier chargement de la page et lorsque l'historique du navigateur API est appelé. L'ID de page par défaut est window.location.pathname. Toutefois, dans certains cas, vous devrez peut-être remplacer ce comportement et utiliser l'application pour qu'elle enregistre les consultations de page par programmation. Cela vous permet de contrôler l'ID de page et le moment où il est enregistré. Prenons l'exemple d'une application Web URI dotée d'un identifiant variable, tel que /entity/123 ou/entity/456. Par défaut, CloudWatch RUM génère un événement d'affichage de page pour chacune URI avec un ID de page distinct correspondant au nom du chemin, mais vous pouvez plutôt les regrouper par le même identifiant de page. Pour ce faire, désactivez l'automatisation de la consultation de page du client Web à l'aide de la configuration disableAutoPageView, puis utilisez la commande recordPageView pour définir l'ID de page souhaité. Pour plus d'informations, consultez la section Configurations spécifiques à l'application sur. GitHub

Exemple de script intégré :

cwr('recordPageView', { pageId: 'entityPageId' });

JavaScript exemple de module :

awsRum.recordPageView({ pageId: 'entityPageId' });

Activation du end-to-end traçage par rayons X

Lorsque vous créez le moniteur d'applications, sélectionnez Trace my service with AWS X-Raypermet le suivi XMLHttpRequest et les fetch demandes effectuées pendant les sessions utilisateur qui sont échantillonnées par le moniteur de l'application. Vous pouvez ensuite voir les traces de ces HTTP demandes dans le CloudWatch RUM tableau de bord, ainsi que sur les pages de détails de X-Ray Trace Map et Trace.

Par défaut, ces suivis côté client ne sont pas connectés à des suivis côté serveur en aval. Pour connecter les traces côté client aux traces côté serveur et activer le end-to-end suivi, définissez l'addXRayTraceIdHeaderoption sur true dans le client Web. Cela oblige le client CloudWatch RUM Web à ajouter un en-tête de trace X-Ray aux HTTP demandes.

Le bloc de code suivant présente un exemple d'ajout de suivis côté client. Certaines options de configuration sont omises de cet exemple pour des raisons de lisibilité.

<script>
    (function(n,i,v,r,s,c,u,x,z){...})(
        'cwr',
        '00000000-0000-0000-0000-000000000000',
        '1.0.0',
        'us-west-2',
        'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js',
        {
            enableXRay: true,
            telemetries: [ 
                'errors', 
                'performance',
                [ 'http', { addXRayTraceIdHeader: true } ]
            ]
        }
    );
</script>

Pour plus d'informations, consultez la documentation du client CloudWatch RUM Web