Web モニタリング PSA および API モニタリング PSA の設定

このページでは、Web モニタリング PSA と API モニタリング PSA の設定方法について説明します。

スクリプト内メタデータの設定

スクリプト測定として合成ジョブを実行する場合、スクリプト内メタデータを使用して特定の設定オプションを指定できます。これらの YAML ベースの設定は、コメントブロックの形式でスクリプトの先頭に含める必要があります。

合成スクリプトのカスタムユーザーエージェントの設定

デフォルトのブラウザ固有の user-agent ヘッダーをカスタム user-agent ヘッダーに変更するには、合成スクリプトの先頭に次のスクリプト内メタデータを追加します。

'''yml
requestHeader:
userAgent: "custom user agent"
'''
driver.get('http://127.0.0.1:20000/green.html')

合成トラフィックをブラウザ RUM トラフィックに含める

合成スクリプトの user-agent リクエストヘッダーには、要求がブラウザ RUM ページに含まれないようにするためのタグが付けられます。tagUserAgent を false に設定すると、ブラウザ RUM ページに合成トラフィックを含めることができます。

合成スクリプトの先頭に次のスクリプト内メタデータを入力します。

'''yml
requestHeader:
userAgent: "custom user agent"
tagUserAgent: false
'''
driver.get('http://127.0.0.1:20000/green.html')

Kubernetes の設定

Kubernetes クラスタを設定し、イメージを Docker レジストリにプッシュし、sum-psa-heimdall.tgz Helm チャートを使用して Web モニタリング PSA または API モニタリング PSA を展開すると、values.yaml ファイルが生成されます。この values.yaml ファイルを使用して、Web モニタリング PSA および API モニタリング PSA の展開時に値を動的に設定します。

キーと値のペアの設定

values.yaml ファイル内のオプションの設定値を次の表の値に置き換えることができます。

設定キーと値のペア説明
Heimdall レプリカ数 heimdall > replicaCount Heimdall レプリカ数を示します。
Heimdall リソース割り当て
  • heimdallResources > min_cpu
  • heimdallResources > max_cpu
  • heimdallResources > min_mem
  • heimdallResources > max_mem
Heimdall リソース割り当てを示します。
測定コンテナのリソース割り当て

Web Monitoring PSA:

  • chromeAgentResources > min_cpu
  • chromeAgentResources > max_cpu
  • chromeAgentResources > min_mem
  • chromeAgentResources > max_mem

API Monitoring PSA:

  • apiMonitoringAgentResources > min_cpu
  • apiMonitoringAgentResources > max_cpu
  • apiMonitoringAgentResources > min_mem
  • apiMonitoringAgentResources > max_mem
測定コンテナのリソース割り当てを示します。
ロギングレベル logging > level to ERROR, WARN, INFO, DEBUG, or TRACE ログレベルを示します。デフォルト値は DEBUG です。
ノードセレクタ
  • heimdallNodeSelector >
  • agentNodeSelector >
Heimdall および測定コンテナのノードセレクタを適用して、特定のノードでこれらのコンポーネントをスケジュールします。
[プロキシ（Proxy）]

Heimdall：

heimdall: enabled: false server: "<proxy server address>"

Web Monitoring PSA：

browserMonitoringAgent: enabled: false server: "<proxy server address>" bypassList: "<specify the domain URLs that you want to bypass separated by semicolon>"

API Monitoring PSA：

apiMonitoringAgent: enabled: false server: "<proxy server address>"

クラスタを離れるすべての要求にプロキシを使用するように PSA を構成します。``enabled`` フィールドを ``true`` に設定します。

<scheme>://<hostname>:<port>

すべてのコンポーネントに同じプロキシサーバーを設定することも、コンポーネントごとに異なるプロキシサーバーを設定することもできます。

注: この設定は展開レベルに設定され、その特定のEUMライセンスのすべてのドメインまたはテストに適用されます。複数のプロキシサーバーがある場合、1つのプロキシサーバーをWebモニタリングに使用し、別のプロキシサーバーをAPIモニタリングに使用できます。すべてのテストは、ドメインに関係なく、設定されたプロキシサーバーを経由します。

エージェントと合成サーバーの接続

Web モニタリング PSA または API モニタリング PSA を Kubernetes クラスタに展開する場合は、values.yaml ファイルでエージェント登録情報を指定する必要があります。Heimdall はこの情報を使用して、それ自身を合成サーバーに登録します。登録が完了すると、コントローラでエージェントを表示し、測定を実行できます。

シェパード URL

エージェントをホスト型シンセティッククラウドに接続するには、次のいずれかのシェパード URL を values.yaml ファイルに入力します。

リージョン シェパード URL
us-west-2 https://synthetic.api.appdynamics.com
eu-central-1 https://fra-synthetic.eum-appdynamics.com
ap-southeast-2 https://syd-synthetic.eum-appdynamics.com
ap-south-1 https://bom-synthetic.eum-appdynamics.com
eu-west-2 https://lon-synthetic.eum-appdynamics.com

ap-east-1

 https://hkg-synthetic.eum-appdynamics.com
sa-east-1 https://gru-synthetic.eum-appdynamics.com
af-south-1 https://cpt-synthetic.eum-appdynamics.com
ap-southeast-1 https://singapore-synthetic.eum-appdynamics.com

エージェントをオンプレミスの合成サーバーに接続するには、values.yaml ファイルにシェパード URL（http://<on-premises-synthetic-server-host>:10101）を入力します。

注: バージョン 21.4.1 以降のオンプレミスの合成サーバーがサポートされています。古いバージョンを使用している場合は、Linux ベースの PSA に接続するために合成サーバーをアップグレードする必要があります。

EUM アカウントとライセンスキー

エージェントをコントローラに接続するには、EUM アカウントとライセンスキーが必要です。

この情報を取得するには、次の手順を実行します。

  1. SaaS コントローラに移動します。
  2. 右上隅にある設定アイコンをクリックして、License > Account Usage に移動します。

  3. values.yaml の [User Experience] セクションまで下にスクロールし、アカウント名とライセンスキーを入力します。

    設定キー設定値
    shepherd > credentials > eumAccount Account Name
    shepherd > credentials > eumKey License Key

ロケーション情報

エージェントの場所を特定するには、values.yaml ファイルに次の [shepherd > location] の詳細情報を入力します。

  • ：場所を表すわかりやすい文字列。

  • ：エージェントが実行されている場所を識別する 4 〜 10 文字の一意の英数字文字列。この ID は、場所の名前に基づいて作成する必要があります。

  • latitude, longitude：Google マップで GPS 座標に移動し、場所の緯度と経度を取得します。