Download PDF
Download page 合成プライベートエージェントのインストール.
合成プライベートエージェントのインストール
次の手順は、合成プライベートエージェントを取得してインストールする方法を示しています。
合成プライベートエージェントのインストールでは、システムに次の変更を加えます。
- 合成プライベートエージェントをインストールします。
- ブラウザをインストールします。
- 複数の Windows レジストリ設定の変更など、Windows のさまざまな側面を構成して、ブラウザからパフォーマンスデータを収集できるようにします。
- Windows ファイアウォールを有効にして、サーバへのインバウンドネットワーク接続を防止します。
前提条件
インストールを開始する前に、次のことを完了していることを確認します。
インストールの手順
合成プライベートエージェントをインストールするには、以下の手順を実行します。
合成プライベートエージェントの取得
AppDynamics ダウンロードに移動し、合成プライベートエージェントをダウンロードします。
管理者としてログインします。
合成プライベート エージェント インストーラをコピーして実行するには、その前に、合成プライベートエージェント用の専用 Windows マシンに管理者としてログインする必要があります。
合成プライベートエージェントを専用マシンにコピー/移動
合成プライベートエージェントを含む圧縮アーカイブファイル
SyntheticAgentInstaller.zip
をこのマシンに移動またはコピーします。- アーカイブファイルを解凍します。
- ディレクトリ
SyntheticAgentInstaller
にインストーラスクリプトinstall.ps1
が含まれていることを確認します。
アカウントと場所情報の準備
合成プライベートエージェントをインストールする前に、次の情報が必要になります。
- EUM Account Name / EUM License Key:
- SaaS コントローラに移動します。
- [License > Peak Usage] に移動します。
- [User Experience] セクションまで下にスクロールします。
- [Account Name] と [License Key] のフィールドの値をコピーします。
- Location name:場所のユーザフレンドリな文字列。複数のコンピュータで同じ場所情報を使用すると、その場所にキャパシティを追加できます。たとえば、プライベートの場所が SF の会社オフィスから実行されている複数のマシンの場所である場合は、「SF Office」を使用できます。
- Location ID:1 つ以上のエージェントが実行されている可能性がある場所を識別する 4 ~ 10 文字の一意の英数字文字列。この ID は、場所の名前に基づいて作成する必要があります。
Latitude and longitude of the location:GPS Coordinates with Google Mapsツール(
https://www.gps-coordinates.net/
)に移動して、場所の緯度と経度を取得します。
インストーラの実行
アーカイブファイルを解凍した後、次の手順を実行します。
- PowerShell コンソールを開きます。
ディレクトリ
SyntheticAgentInstaller
に移動します。PowerShell 実行ポリシーを
Unrestricted
に設定します。> Set-ExecutionPolicy Unrestricted
POWERSHELLPowerShell スクリプト
install.ps1
を実行して、合成プライベートエージェント、インターネットブラウザをインストールし、Windows の設定を変更します。> .\install.ps1
POWERSHELL- コマンドプロンプトで、最後の手順で準備した情報を入力します。
エージェントと合成サーバの接続(オプション)
デフォルトでは、合成プライベートエージェントは、アメリカのビジネス地域にある SaaS 合成サーバに測定結果を報告します。したがって、合成プライベートエージェントがアメリカのビジネス地域にあり、SaaS 合成サーバに報告している場合は、合成プライベートエージェントの起動を続行します。
合成プライベートエージェントがオンプレミスの合成サーバに測定結果を報告している場合、設定手順については合成エージェントと合成サーバの接続を参照してください。
EMAC または APAC のビジネス地域で SaaS 合成サーバに報告するように合成プライベートエージェントを構成するには、次の手順を実行します。
次の表の [EMAC] または [APAC] タブを選択し、地域内の SaaS 合成サーバへの URL を見つけます。
SaaS Domains and IP RangesAmericas
Platform Components Domains AWS Region IP Addresses/Ranges AppDynamics Cloud https://observe.appdynamics.com
us-west-2-pdx-1a
(AWS Local Zone)AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) https://pdx-sls-agent-api.saas.appdynamics.com
us-west-2
Please refer to the AWS IP range JSON file for the IP ranges for the us-west-2
region.Serverless Service Analytics https://analytics.api.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://col.eum-appdynamics.com
orhttp://pdx-col.eum-appdynamics.com
(EUM Collector)As part of a critical infrastructure upgrade, AppDynamics will be deprecating support for static IP ranges for the PDX/Oregon SaaS EUM collector
https://col.eum-appdynamics.com/
on May 27th, 2022. This upgrade is required to improve the scalability of the cloud infrastructure used by the AppDynamics EUM solution. If your organization currently utilizes firewall rules based on static IP ranges, you will need to update them to add thehttps://col.eum-appdynamics.com/
domain to the allowlist instead. This change needs to be made before May 27th, 2022, otherwise EUM data will be lost (including Mobile and Browser RUM) for any applications being monitored which sit behind the firewall. Please contact your account team or support team if you have any questions.Please refer to the AWS IP range JSON file for the IP ranges for the
us-west-2
region.IoT REST API https://iot-col.eum-appdynamics.com
Screenshot Service https://image.eum-appdynamics.com
Synthetic Server https://synthetic.api.appdynamics.com
52.40.35.5
(Boardman, Oregon)52.201.103.47
(Ashburn, Virginia)
Synthetic Server Feeder wss://synthetic-feeder.api.appdynamics.com
Please refer to the AWS IP range JSON file for the IP ranges for the us-west-2
region.Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Oregon Datacenter environment will have one of the following source IP addresses:
34.218.183.67
52.88.49.75
34.218.135.55
44.224.91.190
44.224.93.208
100.21.44.47
35.163.240.75
100.21.168.150
44.224.41.204
Platform Components Domains AWS Region IP Addresses/Ranges AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) Coming soon sa-east-1
Please refer to the AWS IP range JSON file for the IP ranges for the sa-east-1
region.Serverless Service Analytics https://gru-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://gru-col.eum-appdynamics.com
(EUM Collector)https://gru-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP ranges for the
sa-east-1
region.IoT REST API https://gru-iot-col.eum-appdynamics.com
Synthetic Server Feeder wss://gru-synthetic-feeder.eum-appdynamics.com
Synthetic Server https://gru-synthetic.eum-appdynamics.com
Synthetic Server Feeder https://gru-image.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Sao Paolo Datacenter environment will have one of the following source IP addresses:
54.94.50.188
54.233.178.89
18.229.226.158
EMEA
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) https://fra-sls-agent-api.saas.appdynamics.com
eu-central-1
Please refer to the AWS IP range JSON file for the IP range for the AWS region eu-central-1
.Serverless Service Analytics https://fra-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS. EUM Cloud https://fra-col.eum-appdynamics.com
(EUM Collector)https://fra-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
eu-central-1
.IoT REST API https://fra-iot-col.eum-appdynamics.com
Screenshot Service https://fra-image.eum-appdynamics.com
Synthetic Server https://fra-synthetic.eum-appdynamics.com
52.48.243.82
(Dublin, Ireland)Synthetic Server Feeder wss://fra-synthetic-feeder.eum-appdynamics.com
Please refer to the AWS IP range JSON file for the IP range for the AWS region eu-central-1
.Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Frankfurt Datacenter environment will have one of the following source IP addresses:
18.195.41.33
18.195.153.182
18.195.58.148
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) Coming soon eu-west-2
Please refer to the AWS IP range JSON file for the IP range for the AWS region eu-west-2
.Serverless Service Analytics https://lon-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS. EUM Cloud https://lon-col.eum-appdynamics.com
(EUM Collector)https://lon-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
eu-west-2
.IoT REST API https://lon-iot-col.eum-appdynamics.com
Screenshot Service https://lon-image.eum-appdynamics.com
Synthetic Server Feeder wss://lon-synthetic-feeder.eum-appdynamics.com
Synthetic Server https://lon-synthetic.eum-appdynamics.com
Synthetic Server Feeder wss://lon-synthetic-feeder.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the London Datacenter environment will have one of the following source IP addresses:
3.8.253.170
18.135.187.156
18.135.213.75
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) Coming soon af-south-1
Please refer to the AWS IP range JSON file for the IP range for the AWS region af-south-1
.Serverless Service Analytics https://cpt-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS. EUM Cloud https://cpt-col.eum-appdynamics.com
(EUM Collector)https://cpt-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
af-south-1
.IoT REST API https://cpt-iot-col.eum-appdynamics.com
Screenshot Service https://cpt-image.eum-appdynamics.com
Synthetic Server https://cpt-synthetic.eum-appdynamics.com
Synthetic Server Feeder wss://cpt-synthetic-feeder.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Capetown Datacenter environment will have one of the following source IP addresses:
13.244.227.238
13.244.225.154
- 1
3.244.174.250
APAC
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) Coming soon ap-east-1
Please refer to the AWS IP range JSON file for the IP range for the AWS region ap-east-1
.Serverless Service Analytics https://hkg-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://hkg-col.eum-appdynamics.com (EUM Collector)
https://hkg-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
ap-east-1
.IoT REST API https://hkg-iot-col.eum-appdynamics.com
Screenshot Service https://hkg-image.eum-appdynamics.com
Synthetic Server https://hkg-synthetic.eum-appdynamics.com
Synthetic Server Feeder wss://hkg-synthetic-feeder.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Hong Kong Datacenter environment will have one of the following source IP addresses:
18.163.88.143
18.162.92.41
18.166.80.78
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) https://bom-sls-agent-api.saas.appdynamics.com
ap-south-1
Please refer to the AWS IP range JSON file for the IP range for the AWS region ap-south-1.
Serverless Service Analytics https://bom-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://bom-col.eum-appdynamics.com (EUM Collector)
https://bom-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
ap-south-1
.IoT REST API https://bom-iot-col.eum-appdynamics.com
Please refer to the AWS IP range JSON file for the IP range for the AWS region
ap-south-1
.Screenshot Service https://bom-image.eum-appdynamics.com
Synthetic Server Feeder wss://bom-synthetic-feeder.eum-appdynamics.com
Synthetic Server https://bom-synthetic.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Mumbai Datacenter environment will have one of the following source IP addresses:
13.232.191.174
3.7.186.32
13.127.49.48
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics for OpenTelemetry https://sin-sls-agent-api.saas.appdynamics.com
ap-southeast-1
Please refer to the AWS IP range JSON file for the IP range for the AWS region ap-southeast-1
.Serverless Service Analytics https://sin-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://sin-col.eum-appdynamics.com (EUM Collector)
https://sin-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
ap-southeast-1
.IoT REST API https://sin-iot-col.eum-appdynamics.com
Screenshot Service https://sin-image.eum-appdynamics.com
Synthetic Server https://sin-synthetic.eum-appdynamics.com
Synthetic Server Feeder wss://sin-synthetic-feeder.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Singapore Datacenter environment will have one of the following source IP addresses:
13.228.123.222
54.169.20.120
13.229.165.25
Platform Components Domains AWS Region IP Addresses/Range AppDynamics Content Delivery Network (CDN) https://cdn.appdynamics.com
AppDynamics uses Amazon CloudFront for the CDN.
See the CloudFront IP ranges for the possible IP addresses used for the AppDynamics CDN.
AppDynamics OpenTelemetry Service (SaaS Controller) https://syd-sls-agent-api.saas.appdynamics.com
ap-southeast-2
Please refer to the AWS IP range JSON file for the IP range for the AWS region ap-southeast-2
.Serverless Service Analytics https://syd-ana-api.saas.appdynamics.com
Controller Tenant https://my-controller-tenant.saas.appdynamics.com
AppDynamics will provide a unique set of IP addresses at the time of provisioning the Controller Tenant within AWS.
EUM Cloud https://syd-col.eum-appdynamics.com (EUM Collector)
https://syd-api.eum-appdynamics.com
(EUM API)Please refer to the AWS IP range JSON file for the IP range for the AWS region
ap-southeast-2
.IoT REST API https://syd-iot-col.eum-appdynamics.com
Screenshot Service https://syd-image.eum-appdynamics.com
Synthetic Server https://syd-synthetic.eum-appdynamics.com
Synthetic Server Feeder wss://syd-synthetic-feeder.eum-appdynamics.com
Synthetic Hosted Agents See Synthetic Hosted Agents. Notes:
All traffic originating from the Sydney Datacenter environment will have one of the following source IP addresses:
13.210.238.7
13.54.206.49
13.55.209.28
- ディレクトリ
C:\appdynamics\synthetic-agent\synthetic-driver\conf
に移動します。 - ファイル
synthetic-driver.yml
を編集します。 次に示すように、地域の SaaS 合成シェパードへの URL を
shepherdUrl
に設定します。## Use the SaaS Synthetic Server URL from the table above for EMAC or APAC. shepherdUrl: http://<saas_synthetic-server_url>
POWERSHELL変更内容を保存して、
synthetic-driver.yml
ファイルを閉じます。
合成プライベートエージェントの起動
インストールが完了した後(インストーラによってコンピュータが再起動される場合があります)、デスクトップショートカット [Start Agent] をダブルクリックして、合成プライベートエージェントを起動します。
インストールが成功したことの確認
- SaaS コントローラに移動し、次に移動します。Synthetic Job List.
- [Create a Job] をクリックします。
- [Choose Locations] で、ドロップダウンから Private を選択して、アカウントに関連付けられているすべての合成プライベートエージェントを表示します。
- 使用可能な場所の 1 つとしてプライベートの場所が表示されていることを確認します。
自動ログオンの構成
起動後のマシンが自動的に管理者アカウントにログオンするように、自動ログオンを設定する必要があります。自動ログオンを設定するには、無料の Microsoft Sysinternals ユーティリティAutologon.exe
を使用することをお勧めします。Autologon.exe
は使いやすく、さらに重要なこととして、Windows レジストリに保存されているアカウントログイン情報を暗号化します。
自動ログオンを構成するには、次の手順を実行します。
- https://docs.microsoft.com/en-us/sysinternals/downloads/autologon から
Autologon.exe
をダウンロードします。 - 実行可能ファイル Autologon.exe をダブルクリックします。
- 要求された情報(ユーザ名、ドメイン、パスワードなど)を入力します。
- [Enable] をクリックします。
コマンドラインから Autologon.exe
を実行することもできますが、パスワード内の特殊文字は必ずエスケープするようにします。
レジストリを編集して手動で自動ログオンを構成するには、「How to turn on automatic logon in Windows」を参照してください。使用している Windows のバージョンによっては、記載された手順が若干変わることがあるので注意してください。
ログオン時に合成プライベートエージェントが起動するスケジュール設定
自動ログオンを設定したら、マシンが管理者アカウントにログインした後に合成プライベートエージェントを自動的に起動するようにスケジュールする必要があります。
- PowerShell コンソールを開きます。
ファイル
startagent.xml
をダウンロードし、$HOME
ディレクトリに保存します。$HOME
ディレクトリに移動します。- 「管理者」以外のユーザとしてログオンしている場合は、
startagent.xml
ファイルを編集して、次の XML 要素の値 "Administrator" をユーザ名に置き換えます(ユーザアカウントには引き続き管理者権限が必要です)。<Author>
<UserId>
合成プライベートエージェントを起動するタスクをスケジュールします。
> schtasks /create /f /tn "Start the Synthetic Private Agent"/xml .\startagent.xml
POWERSHELLマシンを再起動します。
- マシンが起動すると、「Administrator: Windows PowerShell」というタイトルの Windows コンソールが開いて、ログメッセージ「Synthetic-agent is running」が表示されます。
詳細オプション
複数のエージェントのインストール
1 つの合成プライベートエージェントをインストールした後、さらに合成プライベートエージェントをインストールする必要があるかどうかを検討する必要があります。
次の使用例では、複数のエージェントをインストールすることをお勧めします。
- 複数の場所をテストする。test multiple locations 複数のマシンに合成プライベートエージェントをインストールし、インストール中にさまざまな場所情報を指定する必要があります。それぞれの場所は、Job Editor で個別に表示されます。
- さらにテストを実行するためにさらにスループットが必要である。more throughput to run more tests 1 つの場所から多数の合成ジョブを実行すると、「Location is overloaded」のようなエラーが表示されることがあります。これは、マシンがキャパシティに達していて、別のマシンを追加する必要があることを意味します。別のマシンにエージェントをインストールすることにより、同じ場所情報を指定することができます。
- Internet Explorer の複数のバージョンをサポートする。support for multiple versions of Internet Explore 詳細については、ソフトウェア要件を参照してください。