Configuration du client Web CloudWatch RUM - Amazon CloudWatch
ArgumentsOmission des erreursOptions de configuration

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.

Configuration du client Web CloudWatch RUM

Vos applications peuvent utiliser l'un des extraits de code générés par CloudWatch RUM pour installer le client Web CloudWatch RUM. Les extraits générés prennent en charge deux méthodes d'installation : en tant que JavaScript module via NPM ou à partir d'un réseau de diffusion de contenu (CDN). Pour de meilleures performances, nous vous recommandons d'utiliser la méthode d'installation NPM. Pour plus d'informations sur l'utilisation de cette méthode, consultez la section Installation en tant que JavaScript module.

Si vous utilisez l'option d'installation du CDN, les bloqueurs de publicité peuvent bloquer le CDN par défaut fourni par RUM. CloudWatch Cela désactive la surveillance des applications pour les utilisateurs qui ont installé des bloqueurs de publicité. Pour cette raison, nous vous recommandons d'utiliser le CDN par défaut uniquement pour l'intégration initiale avec CloudWatch RUM. Pour plus d'informations sur les moyens d'atténuer ce problème, consultez Instrument the application (Instrumentation de l'application).

L'extrait de code se trouve dans l'identification <head> d'un fichier HTML et installe le client web en le téléchargeant, puis en le configurant pour l'application qu'il surveille. Cet extrait est une fonction auto-exécutable qui ressemble à l'exemple suivant. Dans cet exemple, le corps de la fonction de l'extrait de code a été omis 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',
{ /* Configuration Options Here */ }
);
<script>

Arguments

L'extrait de code accepte six arguments :

  • Un espace de noms permettant d'exécuter des commandes sur le client web, par exemple 'cwr'

  • L'ID du moniteur d'application, par exemple '00000000-0000-0000-0000-000000000000'

  • La version de l'application, par exemple '1.0.0'

  • La AWS région du moniteur de l'application, telle que 'us-west-2'

  • L'URL du client web, par exemple 'https://client.rum.us-east-1.amazonaws.com/1.0.2/cwr.js'

  • Des options de configuration spécifiques à l'application. Pour plus d'informations, consultez la section suivante.

Omission des erreurs

Le client Web CloudWatch RUM écoute tous les types d'erreurs qui se produisent dans vos applications. Si votre application émet JavaScript des erreurs que vous ne souhaitez pas afficher dans le tableau de bord CloudWatch RUM, vous pouvez configurer le client Web CloudWatch RUM pour filtrer ces erreurs afin de ne voir que les événements d'erreur pertinents sur le tableau de bord CloudWatch RUM. Par exemple, vous pouvez choisir de ne pas afficher certaines JavaScript erreurs dans le tableau de bord parce que vous avez déjà identifié un correctif pour celles-ci et que le volume de ces erreurs masque d'autres erreurs. Vous pouvez également ignorer les erreurs que vous ne pouvez pas corriger car elles appartiennent à une bibliothèque appartenant à un tiers.

Pour plus d'informations sur la manière d'instrumenter le client Web pour filtrer des JavaScript erreurs spécifiques, consultez l'exemple dans la section Erreurs dans la documentation Github du client Web.

Options de configuration

Pour plus d'informations sur les options de configuration disponibles pour le client Web CloudWatch RUM, consultez la documentation du client Web CloudWatch RUM