このページでは、JavaScript エージェントバージョンのアップグレード方法について説明します。JavaScript エージェントの最新バージョンにアップグレードすると、最新の機能を使用して最新のバグ修正を受けることができます。

次の項では、互換性の問題の可能性について説明し、JavaScript エージェントを追加する新しい方法を示し、さまざまな JavaScript エージェントのホスティングオプションについて、手動挿入コードの例を示します。 

互換性の 問題

オンプレミス展開の場合、JavaScript エージェントのバージョンは、ご使用の EUM サーバのバージョンと同じか、前のバージョンにする必要があります。たとえば、EUM サーバ 20.3.0 を展開している場合、使用可能な JavaScript エージェントの最新バージョンは 20.3.0 です。EUM サーバを最新のバージョンにアップグレードすることをお勧めします。これにより、最新の JavaScript エージェント機能を利用できるようになります。 

  • オンプレミス EUM サーバを使用していて、adrum.js のホステッドバージョンが必要な場合は、adrum.js のバージョンを EUM サーバのバージョンと一致させる必要があります。
  • コントローラバージョンの場合、JavaScript エージェントバージョンは、同じバージョンまたは古いバージョンのコントローラバージョンと互換性があります。たとえば、JavaScript エージェント 20.6.0 はコントローラ 20.6.0 以下と互換性があります。 

インジェクションコードの変更

JavaScript エージェントをホストしているサーバへの URL が HTTP と HTTPS の両方で同じである場合は、<script> タグを挿入するために document.write を使用する必要はありません。代わりに、次の構文を使用して <script> タグをハードコーディングするだけです。

<script src="//cdn.appdynamics.com/adrum/adrum.js"/>
XML

さまざまなホスティングオプションのインジェクションコード

インジェクションコードは、展開環境(SaaS/オンプレミス)によって若干異なります。次に、展開のタイプごとにコードスニペットを示します。<head> タグの直後にコードスニペットを配置してください。

次の文字列では、

  • 次のコードの文字列 <EUM_APP_KEY> を独自の EUM アプリケーションキーに置き換えます。
  • 次のコードの <eum-col.appdynamics.com> を、対応するコレクタ URL に置き換えます。
<script charset='UTF-8'>
window['adrum-start-time'] = new Date().getTime();
(function(config){
    config.appKey = '<EUM_APP_KEY>';
    config.adrumExtUrlHttp = 'http://cdn.appdynamics.com';
    config.adrumExtUrlHttps = 'https://cdn.appdynamics.com';
    config.beaconUrlHttp = 'http://eum-col.appdynamics.com';
    config.beaconUrlHttps = 'https://eum-col.appdynamics.com';
    config.xd = {enable : false};
})(window['adrum-config'] || (window['adrum-config'] = {}));
<script src='//cdn.appdynamics.com/adrum/adrum-latest.js'></script>
JS

次のコードスニペットでは、

  • 文字列 <EUM_APP_KEY> を独自の EUM アプリケーションキーに置き換えます。
  • 文字列 <your-cdn.com> を JavaScript エージェントをホスティングしているサーバへの URL に置き換えます。 
  • 次のコードの <eum-col.appdynamics.com> を、対応するコレクタ URL に置き換えます。
<script charset='UTF-8'>
window['adrum-start-time'] = new Date().getTime();
(function(config){
    config.appKey = '<EUM_APP_KEY>';
    config.adrumExtUrlHttp = 'http://<your-cdn.com>';
    config.adrumExtUrlHttps = 'https://<your-cdn.com>';
    config.beaconUrlHttp = 'http://eum-col.appdynamics.com';
    config.beaconUrlHttps = 'http://eum-col.appdynamics.com';
    config.xd = {enable : false};
})(window['adrum-config'] || (window['adrum-config'] = {}));
</script>
<script src='//<your-cdn.com>/adrum/adrum.js'></script>
JS

次のコードスニペットでは、

  • 文字列 <EUM_APP_KEY> を独自の EUM アプリケーションキーに置き換えます。
  • 文字列 <your-cdn.com> を JavaScript エージェントをホスティングしている場所への URL に置き換えます。 
  • 次のコードの <eum-col.appdynamics.com> を、対応するコレクタ URL に置き換えます。
<script charset='UTF-8'>
window['adrum-start-time'] = new Date().getTime();
(function(config){
    config.appKey = '<EUM_APP_KEY>';
    config.adrumExtUrlHttp = 'http://cdn.appdynamics.com';
    config.adrumExtUrlHttps = 'https://cdn.appdynamics.com';
    config.beaconUrlHttp = 'http://eum-col.appdynamics.com';
    config.beaconUrlHttps = 'https://eum-col.appdynamics.com';
    config.xd = {enable : false};
})(window['adrum-config'] || (window['adrum-config'] = {}));
</script>
<script src='//<your-cdn.com>/adrum/adrum.js'></script>
JS