このページでは、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 ページに含まれないようにするためのタグが付けられます。tagUserAgentfalse に設定すると、ブラウザ 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 > replicaCountHeimdall レプリカ数を示します。
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
測定コンテナのリソース割り当てを示します。
Postgres DB リソース割り当て
  • postgresResources > min_cpu
  • postgresResources > max_cpu
  • postgresResources > min_mem
  • postgresResources > max_mem
Postgres DB リソース割り当てを示します。
カスタム Postgres DB
  • postgres> enable to false
  • databaseConfig >
Postgres DB インスタンスをセットアップし、DB インスタンスに接続するように Heimdall を設定する場合は、DB が Heimdall と同じ名前空間(測定名前空間)で実行されていることを確認します。
ログレベルlogging > level to ERROR, WARN, INFO, DEBUG, or TRACEログレベルを示します。デフォルト値は DEBUG です。
ノードセレクタ
  • heimdallNodeSelector > 
  • agentNodeSelector > 
Heimdall および測定コンテナのノードセレクタを適用して、特定のノードでこれらのコンポーネントをスケジュールします。
[プロキシ(Proxy)]
  • proxy > enabled
  • proxy > server

クラスタを離れるすべての要求にプロキシを使用するように PSA を構成します。enabled フィールドを true に設定し、次の形式で server フィールドにプロキシサーバーアドレスを指定します。

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

エージェントとシンセティックサーバの接続

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

シェパード URL

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

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

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

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

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

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

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

    設定キー設定値
    shepherd > credentials > eumAccountAccount Name
    shepherd > credentials > eumKeyLicense Key

ロケーション情報

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

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

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

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