monitoring des navigateurs et de l' agent PHP

Par défaut, l' agent PHP ajoute automatiquement monitoring des navigateurs aux pages Web de votre application. Dans ce processus automatisé, l'agent PHP injecte le snippet JavaScript de l'agent de navigateur dans vos pages Web. Cela signifie que vous bénéficiez d'un monitoring des performances du navigateur frontal sans avoir à insérer manuellement l'extrait JavaScript dans l'élément d'en-tête de votre page.

Vous pouvez activer ou désactiver auto-instrumentation dans votre agent fichier de configuration PHP, ou vous pouvez utiliser l'agent PHP API pour configurer manuellement monitoring des navigateurs.

Utiliser ou désactiver l'auto-instrumentation

Par défaut, l'agent PHP injecte automatiquement l'monitoring JavaScript des navigateurs snippet dans vos pages. Pour modifier ce paramètre, modifiez le paramètre newrelic.browser_monitoring.auto_instrument dans votre fichier INI.

newrelic.browser_monitoring.auto_instrument=1

L'auto-instrumentation ne fonctionne pas lorsque le champ d'en-tête HTTP Content-Length est défini. Pour utiliser monitoring des navigateurs dans cette situation, désactivez auto-instrumentation et insérez manuellement l'en-tête et le pied de page JavaScript dans vos modèles.

Instrumenter manuellement via API d' agent

Pour configurer manuellement monitoring des navigateurs, incluez le script approprié dans vos pages. L'agent PHP New Relic dispose d'une API pour générer automatiquement l'en-tête et le pied de page JavaScript requis.

Important

Les appels à l'API de l'agent PHP sont conditionnés au chargement de l'extension newrelic afin que l'agent PHP soit en cours d'exécution. Si l'agent n'est pas en cours d'exécution, les appels pour générer l'en-tête et le pied de page JavaScript entraîneront des erreurs, car les fonctions ne seront pas définies.

Pour plus d'informations, voir :

auto_instrument paramètres de l'agent
newrelic_get_browser_timing_header()
newrelic_get_browser_timing_footer()

Instrumenter manuellement pour divers frameworks

Ce document ne fournit pas de procédures détaillées pour insérer manuellement l' agent de navigateur via l' API d' agent. C’est parce qu’il existe trop de manières possibles de construire un framework.

Les exemples instrumentation manuelle montrent comment ajouter instrumentation à un framework qui prend déjà en charge auto-instrumentation. Si vous utilisez un autre framework ou des versions modifiées de Drupal ou WordPress, assurez-vous d'appeler les fonctions API pour instrumentation au bon endroit.

Insérez la valeur de retour de newrelic_get_browser_timing_header() dans le cadre de la tag <head> de la page de sortie, de préférence comme toute première chose.
En tant que toute dernière chose avant la tag de fermeture </body> dans le document, ou aussi près que possible, insérez la valeur de retour de newrelic_get_browser_timing_footer().

Voici quelques exemples de base.

Cet exemple montre comment appeler l'API de l'agent PHP pour générer des en-têtes et des pieds de page pour une installation WordPress en utilisant le thème par défaut twentyten .

Insérer un appel pour générer l'en-tête JavaScript dans website home dir/wordpress/wp-content/themes/twentyten/header.php.

<body <?php body_class(); ?>>
<div id="wrapper" class="hfeed">
  <div id="header">
    <?php if( extension_loaded('newrelic') ) { echo newrelic_get_browser_timing_header(); } ?>
    <div id="masthead">
    ...

Insérer un appel pour générer le pied de page monitoring final de l'utilisateur dans website home dir/wordpress/wp-content/themes/twentyten/footer.php.

...
    </div><!-- #site-generator -->
  </div><!-- #colophon -->
  <?php if( extension_loaded('newrelic') ) { echo newrelic_get_browser_timing_footer(); } ?>
</div><!-- #footer -->

Cet exemple montre comment appeler l'API de l'agent PHP pour générer des en-têtes et des pieds de page pour une installation Drupal en utilisant le thème par défaut garland .

Insérez un appel pour générer l'en-tête JavaScript juste après la tag en-tête d'ouverture dans website home dir/drupal/themes/garland/page.tpl.php.

<div id="container" class="clear-block">
  <div id="header">
    <?php if( extension_loaded('newrelic') ) { echo newrelic_get_browser_timing_header(); } ?>
    <div id="logo-floater">
    ...

Insérer un appel pour générer le pied de page juste avant la dernière tag de mise en page de fermeture :
```
...
    </div>
    <?php if( extension_loaded('newrelic') ) { echo newrelic_get_browser_timing_footer(); } ?>
      
    <?php print $closure ?>
  </body>
</html>
```
Important
Dans Drupal 7.15, Compress cached pages est activé par défaut. Si vous sélectionnez également Cache pages for anonymous users, le JavaScript (newrelic.js) n'est pas inséré dans les pages servies pour l'utilisateur anonyme. C'est parce que les pages de Drupal sont compressées directement à partir de la base de données avant d'être stockées dans le cache (avec gzip), donc l'agent PHP de New Relic n'a aucune chance d'analyser le HTML. Dans cette situation, instrumentation manuelle offre une meilleure opportunité de capturer des données pour un utilisateur anonyme.
Important
Drupal 10.2 a introduit un nouveau changement qui lui permet de définir un en-tête content-length . L'agent PHP New Relic ne peut pas injecter automatiquement l'auto-instrumentation du navigateur lorsque le champ d'en-tête HTTP Content-Length est défini. Pour continuer à utiliser monitoring des navigateurs, désactivez auto-instrumentation du navigateur et insérez manuellement l'en-tête et le pied de page JavaScript dans vos modèles.

Afficher les données du navigateur

Une fois que vous avez activé monitoring des navigateurs et généré du trafic pour votre application, les données apparaîtront sur la page Summary du navigateur de votre application. Il y a un court délai la première fois que vous démarrez le daemon (ou lorsque l'agent PHP rencontre une nouvelle application) pendant que le daemon vérifie les paramètres. Après cela, l’ New Relic JavaScript snippet est disponible.

Désactiver l'auto-instrumentation

Pour savoir comment désactiver monitoring des navigateurs avec l' agent de configuration PHP, consultez l'option de configuration demonitoring des navigateurs.

Pour savoir comment utiliser l' API pour désactiver monitoring des navigateurs, voir newrelic_disable_autorum().