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 Web CloudWatch RUM (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 Web CloudWatch RUM.

Quatre options de configuration importantes sont à connaître, comme expliqué dans les sections suivantes.

Blocage de la collecte d'URL de ressource susceptibles de contenir des informations personnelles

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

Si c'est le cas pour votre application, nous vous recommandons vivement de désactiver la collecte des URL de ressource en définissant recordResourceUrl: false dans 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 consultations de page lorsque la page se charge pour la première fois et lorsque l'API d'historique du navigateur est appelée. 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 dotée d'un URI avec 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 chaque 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 Application-specific Configurations sur GitHub.

Exemple de script intégré :

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

JavaScript exemple de module :

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

Activation du X-Ray suivi de bout en bout

Lorsque vous créez le moniteur d'application, sélectionnez Trace my service with AWS X-Ray (Suivre mon service avec ) pour activer le suivi des demandes XMLHttpRequest et fetch effectuées pendant les sessions utilisateur échantillonnées par le moniteur d'application. Vous pouvez ensuite voir les traces de ces requêtes HTTP dans le tableau de bord CloudWatch RUM, ainsi que sur les pages X-Ray Trace Map et Trace details.

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

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 Web CloudWatch RUM

Envoi de demandes non signées à RUM CloudWatch

Par défaut, le client web RUM signe toutes les requêtes envoyées à RUM. Si vous définissez signing:false la configuration du client, les demandes ne seront pas signées lorsqu'elles seront envoyées à CloudWatch RUM. Les données ne seront ingérées dans RUM que si une stratégie publique basée sur les ressources est associée au moniteur d’application. Pour de plus amples informations, veuillez consulter Utilisation de politiques basées sur les ressources avec RUM CloudWatch.