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

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

In-Script Metadata Configuration

When you run Synthetic Jobs as scripted measurements, you can specify certain configuration options using in-script metadata. You must include these yaml-based configurations at the beginning of the script in the form of a comment block.

Set Custom User Agent for Synthetic Scripts

To modify the default browser specific user-agent header to a custom user-agent header, add this in-script metadata at the beginning of the Synthetic script:

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

Include Synthetic Traffic in Browser RUM Traffic

The user-agent request headers in the Synthetic scripts are tagged so that the requests are not included in Browser RUM pages. You can set tagUserAgent to false to include the Synthetic traffic in the Browser RUM pages.

Enter the following in-script metadata at the beginning of the Synthetic script:

'''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 座標に移動し、場所の緯度と経度を取得します。