Docker エンジンでの PSA の設定

インストール zip ファイルに含まれている自動化スクリプトを使用して、Docker エンジンで PSA を設定できます。インストールコマンドを実行すると、スクリプトによって docker イメージが自動的に構築され、PSA が展開されます。

Supported Operating System

  • Linux（CentOS および Ubuntu）
  • Intel または M1 プロセッサを搭載した macOS

  • Windows

    注: 自動化スクリプトを使用した PSA のインストールは、Windows ではサポートされていません。Windows で PSA をインストールするには、次を参照してください。

    PSA の手動展開

次の表は、Kubernetes と Docker での PSA のインストールの違いを示しています。

Kubernetes Docker

Heimdall と Ignite は、Helm チャートを介して既存の Kubernetes クラスタにポッドとして展開されます。

Heimdall と Ignite はコンテナとして展開されます。
Heimdall は、Kube API を介して Web モニタリングと API モニタリングの測定ジョブポッドを作成します。 Heimdall は、Docker API を介して Web モニタリングと API モニタリングの測定ジョブコンテナを作成します。
測定の準備ができると、Heimdall は Kube API を介してジョブポッドを削除します。 測定の準備ができると、Heimdall は Docker API を介してジョブコンテナを削除します。

PSA インストールファイルのダウンロード

Splunk AppDynamicsPSA インストール zip ファイルを、Cisco AppDynamics ダウンロードセンターまたはベータアップロードツールからダウンロードします。このファイルには、sum-chrome-agent、sum-api-monitoring-agent、sum-heimdall、Helm チャート、および自動化スクリプトの Docker ファイルが含まれています。sum-chrome-agent、sum-api-monitoring-agent、および sum-heimdall のイメージをビルドする場合は、Docker がインストールされていることを確認します。インストールされていない場合は、ここから Docker をダウンロードしてインストールできます。

（オプション）プロキシサーバーの設定

プロキシサーバーを設定すると、すべてのドメインに適用されます。application-onprem.yaml ファイルにプロキシサーバーアドレスを指定して、プロキシサーバーを設定します。キーと値のペアの設定

プロキシサーバーからドメインをバイパスするには、次の手順を実行します。

  1. application-onprem.yaml ファイルを開きます。
  2. noProxy proxyConfig にドメイン URL を追加します。例：proxyServer : "*noProxy noProxy で指定するドメイン URL
    CODE 
    proxyConfig:
apiMonitoringAgent:
enabled: true
proxyServer: <proxy-server-address>
browserMonitoringAgent:
enabled: true
proxyServer: <proxy-server-address>
heimdall:
enabled: true
proxyServer: <proxy-server-address>
noProxy:
enabled: true
proxyServer: "<specify the domain URLs that you want to bypass separated by comma>"

    例：proxyServer: "*abc.com,*xyz1.com,*xyz2.com"

    noProxy で指定したドメイン URL は、プロキシサーバーにリダイレクトされません。[noProxy] フィールドに任意の数のドメインを追加できます。他のすべての指定されていないドメイン URL は、プロキシサーバーにリダイレクトされます。

Deploy PSA in Docker

  1. Unzip the PSA installation zip file.
  2. Run the following command to install PSA in a Docker engine:
    CODE 
    ./install_psa -e docker -v -u <Shepherd-URL> -a <EUM-account> -k <EUM-key> -c <location-code> -d <location-description> -t <location-name> -s <location-state> -o <location-country> -i <location-latitude> -g <location-longitude> -p <PSA-tag> -r <heimdall-replica-count> -z <agent-type> -m <chrome-agent_min/max-memory> -n <API-agent_min/max-memory> -x <chrome-agent_min/max-CPU> -y <API-agent_min/max-CPU> -w <heimdall_proxy_server>~<web_monitoring_proxy_server>~<api_monitoring_proxy_server> -B <bypass-proxy-domains> -q <ignite-persistence> -C true
    A sample installation command looks like this :
    CODE 
    ./install_psa -e docker -v -u <Shepherd-URL> -a <EUM-account> -k <EUM-key> -c DEL -d Delhi -t Delhi -s DEL -o India -i 28.70 -g 77.10 -p 23.5 -r 1 -z all -m 100Mi/500Mi -n 100Mi/100Mi -x 0.5/1.5 -y 0.1/0.1 -w http://testproxy-heimdall.net:3213~http://testproxy-chrome.net:3213~http://testproxy-api.net:3213 -B "www.test.com,*.appdynamics.com" -q true -C true
The following table describes the usage of the flags in the command. Asterisk (*) on the description denotes mandatory parameters.
Flag Description
-e

*Environment

For example, Docker, Minikube, or Kubernetes.
-v Debug mode
-u

*Shepherd URL

For example, https://sum-shadow-master-shepherd.saas.appd-test.com/

See Shepherd URL.
-a

*EUM Account

For example, a ti-23-2-saas-nov2
-k

*EUM Key

For example, 2d35df4f-92f0-41a8-8709-db54eff7e56c
-c

*Location Code

For example, DEL NY
-d

*Location Description

For example, 'Delhi, 100001'
-t

*Location City

For example, Delhi
-s

*Location State

For example, CA
-o

*Location Country

For example, India, United States
-i

Location Latitude

For example, 28.70
-g

Location Longitude

For example, 77.10
-p

*PSA release tag

For example, 23.5
-r Heimdall replica count
-z

*Agent type

For example, web, api, or all

-m

 *Minimum/Maximum memory in Mi/Gi for sum-chrome-agent
-n *Minimum/Maximum memory in Mi/Gi for sum-api-monitoring-agent
-x *Minimum/Maximum CPU for sum-chrome-agent
-y *Minimum/Maximum CPU for sum-api-monitoring-agent
-w

Specify the proxy servers for Heimdall, Web, and API monitoring, separated by a tilde(~).
-B

Specify the domain URLs that you want to bypass from the proxy server.

For example, "*abc.com,*xyz1.com,*xyz2.com"
-q Specify true or false to enable or disable Ignite Persistence.
-C Specify true to enable performance logs on the Chrome browser. The default value is false.

PSA のモニター

Heimdall コンテナと Ignite コンテナの CPU とメモリの使用率をモニターするには、次のコマンドを実行します。

CODE 
./monitoring_psa

PSA の手動展開

以下の手順を実行します。

  1. エージェント Docker イメージをプルします。
    CODE 
    docker pull appdynamics/heimdall-psa
docker pull appdynamics/chrome-agent-psa
docker pull appdynamics/api-monitoring-agent-psa
  2. ./docker-psa/appdynamics に移動して、onprem.yaml ファイル内の次の詳細を更新します。
    • シェパード URL
    • EUM ログイン情報
    • 登録ロケーション
    • エージェントタグ

      以下は、onprem.yaml ファイルで編集する必要がある設定キーと値のペアです。

      Web Monitoring PSA:

      設定キー 値
      chromeAgent > image <agent-tag>
      shepherd > url Shepherd URL
      shepherd > credentials credentials
      shepherd > location agent location
      proxyConfig > enabled

      true

      このフィールドは、プロキシサーバーを使用している場合にのみ指定してください。Heimdall にも同じ変更を加えます。
      proxyConfig > proxyServer プロキシ サーバ URL（Proxy server URL）

      API Monitoring PSA:

      設定キー 値
      apiMonitoringAgent > image <agent-tag>
      shepherd > url Shepherd URL
      shepherd > credentials credentials
      shepherd > location agent location
      proxyConfig > enabled

      true

      このフィールドは、プロキシサーバーを使用している場合にのみ指定してください。Heimdall にも同じ変更を加えます。
      proxyConfig > proxyServer プロキシ サーバ URL（Proxy server URL）
  3. ./docker-psa docker-compose.yaml に移動します。
    設定キー 値
    heimdall > image <heimdall-tag>
  4. Docker の作成を実行します。
    CODE 
    docker-compose up -d

PSA のアップグレード

PSA をアップグレードするには、次の手順を実行します。

  1. PSA インストール zip ファイルをダウンロードして解凍します。
    注: upgrade_psa -h コマンドは、指定できるパラメータを表示します。
  2. 以下のコマンドを実行します：
    CODE 
    ./upgrade_psa -d -v <PSA-release-tag>
次の表では、コマンドでのフラグの使用について説明します。説明のアスタリスク（*）は、必須パラメータを示しています。
フラグ 説明
-d デバッグモード
-v

*PSA リリースタグ。

これは、アップグレードするバージョンです。たとえば、23.9.0 などです。

PSA のアンインストール

PSA をアンインストールするには、次のコマンドを実行します。

オペレーティングシステム コマンド
Linux および macOS
CODE 
./uninstall_psa -e docker -p
Windows
  1. CODE 
    docker ps -a
  2. CODE 
    docker rm <heimdall-containerID>
docker rm <ignite-containerID>