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 は、プロキシサーバーにリダイレクトされます。

ジョブレベルでのプロキシサーバーの設定

特定のジョブのプロキシサーバーとバイパスリストを設定できます。エージェントレベルで設定されているプロキシサーバーの URL とバイパスリストは、ジョブレベルで設定されたプロキシサーバーの URL とバイパスリストによって上書きされます。ジョブレベルでプロキシサーバーを設定するには、次の手順を実行します。
  1. 合成ジョブを作成または編集します。
  2. [Run a script] オプションを選択します。
  3. 次の詳細をスクリプトの先頭に追加します。
    CODE 
    '''yml
jobLevelProxyConfig:
  proxyServer: "<proxy-server-address>"
  bypassProxyList: "<list of URLs that you want to bypass, separated by semi-colon>"
'''
    例：
    CODE 
    '''yml
jobLevelProxyConfig：
  proxyServer: "http://tinyproxy: tinyproxy.svc.cluster.local:8888"
  bypassProxyList: "*abc.com;*xyz1.com;*xyz2.com"
'''

pageUrl = "https://help.splunk.com/en"
driver.get(pageUrl)
assert "Splunk" in driver.title, "Title should contain Splunk"

Docker での PSA の展開

  1. PSA インストール zip ファイルを解凍します。
  2. 次のコマンドを実行して、Docker エンジンで PSA をインストールします。
    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 <serviceaccount-name> -U <userID> -G <groupID> -N <run_as_a_non-root_user> -F <file_system_groupID> -O <override_the_security_context>
    サンプルのインストールコマンドを次に示します。
    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 -A serviceaccount-name -U 9001 -G 9001 -N true -F 9001 -O true
    install_psa スクリプトは構成ファイルからパラメータを読み取ることもできるため、複雑なインストールの管理が容易になります。.txt 構成ファイルを使用して PSA をインストールする場合は、次のコマンドを使用します。
    CODE 
    ./install_psa --config <path-to-config-file.txt>
    注:
    インストールパッケージには、config.sample.txt という名前のサンプル構成ファイルが含まれています。このファイルをコピーして、値を編集できます。コマンドラインフラグで指定したパラメータ値は、テキストファイルで指定した値を上書きします。
    CODE 
    ./install_psa --config production.txt -e kubernetes -r 5 -v
次の表では、コマンドでのフラグの使用について説明します。説明のアスタリスク（*）は、必須パラメータを示しています。
フラグ 設定キー 説明
-a EUM_ACCOUNT

*EUM アカウント

たとえば、Ati-23-2-saas-nov2
-A SERVICE_ACCOUNT sum-chrome-agent および sum-api-monitoring-agent Pod のサービスアカウントを指定します。
-B BYPASS_LIST

プロキシサーバーからバイパスするドメイン URL を指定します。

例："*abc.com;*xyz1.com;*xyz2.com"
-c LOCATION_CODE

*ロケーションコード

たとえば、DEL NY
-C CHROME_PERFORMANCE_LOGS Chrome ブラウザでのパフォーマンスログを有効にするには true を指定します。デフォルト値は false です。
-d LOCATION_DESCRIPTION

*ロケーションの説明

たとえば、「Delhi, 100001」
-e 環境

*環境

たとえば、Docker、Minikube、または Kubernetes などです。
-F FS_GROUP sum-chrome-agent または sum-api-monitoring-agent コンテナのファイルシステムグループ識別子を指定します。
-g LOCATION_LONGITUDE

ロケーションの経度

たとえば、77.10
-G RUN_AS_GROUP sum-chrome-agent または sum-api-monitoring-agent コンテナを実行するグループ識別子を指定します。
-i LOCATION_LATITUDE

ロケーションの緯度

たとえば、28.70
-k EUM_KEY

*EUM キー

たとえば、2d35df4f-92f0-41a8-8709-db54eff7e56c
-m

最初の値：CHROME_MIN_MEMORY

2 番目の値：CHROME_MAX_MEMORY

*sum-chrome-agent の最小/最大メモリ（Mi/Gi 単位）
-n

最初の値：API_MIN_MEMORY

2 番目の値：API_MAX_MEMORY

*sum-api-monitoring-agent の最小/最大メモリ（Mi/Gi 単位）
-N RUN_AS_NON_ROOT sum-chrome-agent または sum-api-monitoring-agent コンテナを非ルートユーザーとして実行するかどうかを指定します。デフォルト値は true です。
-o LOCATION_COUNTRY

*ロケーションの国

たとえば、India、United States
-O OVERRIDE_SECURITY_CONTEXT_FOR_WEB_API_MON Web および API モニタリングのセキュリティコンテキストをオーバーライドするには、true を指定します。デフォルト値は false です。
-p TAG

*PSA リリースタグ

たとえば、23.12
-q IGNITE_PERSISTENCE true または false を指定して、Ignite Persistence を有効または無効にします。
-r HEIMDALL_REPLICA *Heimdall レプリカ数
-s LOCATION_STATE

*ロケーションの州

たとえば、CA
-t LOCATION_CITY

*ロケーションの都市

たとえば、Delhi
-u EUM_URL

*シェパード URL

たとえば、https://sum-shadow-master-shepherd.saas.appd-test.com/

シェパード URL のリストについては、「シェパード URL」を参照してください。
-U RUN_AS_USER sum-chrome-agent または sum-api-monitoring-agent コンテナを実行するユーザー識別子を指定します。
-v 詳細 デバッグモード
-w

最初の値：HEIMDALL_PROXY

2 番目の値：API_MON_PROXY

3 番目の値：WEB_MON_PROXY

Heimdall、API、および Web モニタリング用のプロキシ サーバーをチルダ（~）で区切って指定します。

プロキシサーバーを設定する必要がない場合は、空白のままにすることができます。
-x

最初の値：CHROME_MIN_CPU

2 番目の値：CHROME_MAX_CPU

*sum-chrome-agent の最小/最大 CPU
-y

最初の値：API_MIN_CPU

2 番目の値：API_MAX_CPU

*sum-api-monitoring-agent の最小/最大 CPU
-z AGENT_TYPE

*エージェントタイプ

たとえば、web、api、または all

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>