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')

CODE

合成トラフィックをブラウザ 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')

CODE

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>"` API Monitoring PSA： `apiMonitoringAgent:` `enabled: false` `server: "<proxy server address>"`	クラスタを離れるすべての要求にプロキシを使用するように PSA を構成します。`enabled` フィールドを `true` に設定し、次の形式で server フィールドにプロキシサーバーアドレスを指定します。 `<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 アカウントとライセンスキーが必要です。

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

SaaS コントローラに移動します。
右上隅にある設定アイコンをクリックして、[License > Account Usage] に移動します。
[User Experience] セクションまで下にスクロールします。
values.yaml ファイルにアカウント名とライセンスキーを入力します。
設定キー設定値
shepherd > credentials > eumAccount Account Name
shepherd > credentials > eumKey License Key

ロケーション情報

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

name：場所を表すわかりやすい文字列。
code：エージェントが実行されている場所を識別する 4 〜 10 文字の一意の英数字文字列。この ID は、場所の名前に基づいて作成する必要があります。
latitude, longitude：Google マップで GPS 座標に移動し、場所の緯度と経度を取得します。

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