Minikube での Web モニタリング PSA および API モニタリング PSA の設定

次のように、Minikube での Web モニタリング PSA と API モニタリング PSA を設定します。

Kubernetes クラスタを作成します。
Docker イメージをビルドしてカスタマイズします。
Minikube の Docker デーモンにイメージを保存します。
Web モニタリング PSA と API モニタリング PSA を展開します。
Kubernetes クラスタをモニタします。

ほとんどの手順は、Web モニタリング PSA と API モニタリング PSA の両方に共通です。該当する場合は、手順の違いが強調表示されています。

このマニュアルには、Kubernetes のマニュアルへのリンクが記載されています。Kubernetes で自身のマニュアルを管理しているため、AppDynamics では Kubernetes のマニュアルの精度については一切保証しません。

Kubernetes クラスタの作成

Minikube で Kubernetes クラスタを作成するには、次の手順を実行します。

次の手順に従って、Minikube をインストールします。
クラスタを開始するには、次のように入力します。
```
minikube start --kubernetes-version=v1.x.x --cpus <number-of-cpus> --memory <amount-of-ram>
```
CODE
Minikube は、デフォルトで Minikube のリリース時に使用可能な Kubernetes の最新バージョンをインストールします。サポートされているバージョンの最新情報については、constants.go の OldestKubernetesVersion と NewestKubernetesVersion を参照してください。

クラスタへのアクセス

Kubernetes クラスタにアクセスするには、次の手順に従って、クラスタとの対話型ユーティリティである kubectl をインストールします。

クラスタが実行されていることを確認するには、次のように入力します。

kubectl get nodes

CODE

イメージのビルドとカスタマイズ

Simple Synth PSA のインストール用の zip ファイルは、Appdynamics ダウンロードポータルまたはベータアップロードツールからダウンロードできます。

このファイルには、エージェントのインストールとモニタリングの設定のための Dockerfile が含まれています。

Web Monitoring PSA:：sum-chrome-agent、sum-heimdall、および Helm チャートの Dockerfile
API Monitoring PSA:：synth-api-monitoring-agent、sum-heimdall、および Helm チャートの Dockerfile

sum-chrome-agent、synth-api-monitoring-agent、および sum-heimdall のイメージをビルドする場合は、Docker がインストールされていることを確認します。インストールされていない場合は、ここから Docker をダウンロードしてインストールできます。

sum-chrome-agent の場合：

zip ファイルを解凍して、sum-chrome-agent ディレクトリにアクセスします。
ディレクトリに移動して、次のコマンドを実行します。
```
docker build -f Dockerfile-PSA -t sum-chrome-agent:<agent-tag> .
```
CODE

synth-api-monitoring-agent の場合：

zip ファイルを解凍して、synth-api-monitoring-agent ディレクトリにアクセスします。
ディレクトリに移動して、次のコマンドを実行します。
```
docker build -f Dockerfile-PSA -t synth-api-monitoring-agent:<agent-tag> .
```
CODE

sum-heimdall の場合：

zip ファイルを解凍して、sum-heimdall ディレクトリにアクセスします。
このディレクトリに移動して、次のコマンドを実行します。
```
docker build -f Dockerfile-PSA -t sum-heimdall:<heimdall-tag> .
```
CODE

<heimdall-tag> および <agent-tag> には、任意の値を使用できます。ただし、以降の手順で同じ値を使用します。

カスタム Python ライブラリの追加

このセクションは、Web モニタリング PSA にのみ適用されます。

使用可能な標準ライブラリセットに加えて、スクリプト測定で使用するカスタム Python ライブラリをエージェントに追加できます。ベースイメージとしてロードしたイメージに基づいて新しいイメージをビルドします。

Dockerfile を作成し、Python pip を実行する RUN ディレクティブを作成します。たとえば、algorithms ライブラリをインストールするには、次のように Dockerfile を作成します。
```
# Use the sum-chrome-agent image we just loaded as the base image
FROM sum-chrome-agent:<agent-tag>
  
# Install algorithm for python3 on top of that
RUN python3 -m pip install algorithms==0.1.4
  
  
# We can add more RUN directives for installing more libraries
# RUN python3 -m pip install ...
```
CODE
任意の数の RUN ディレクティブを作成して、必要なライブラリをインストールできます。
新しいイメージをビルドするには、次のように入力します。
```
docker build -t sum-chrome-agent:<agent-tag> - < Dockerfile
```
CODE
新しくビルドされたエージェントイメージには、必要なライブラリが含まれています。

Minikube の Docker デーモンへのイメージの保存

クラスタがアクセスできるように、イメージにタグを付けてレジストリにプッシュする必要があります。Minikube の Docker にイメージを保存するには、次のコマンドを実行します。

Web Monitoring PSA:

docker save sum-heimdall:<heimdall-tag> | (eval $(minikube docker-env) && docker load)
docker save sum-chrome-agent:<agent-tag> | (eval $(minikube docker-env) && docker load)

CODE

API Monitoring PSA:

docker save sum-heimdall:<heimdall-tag> | (eval $(minikube docker-env) && docker load)
docker save synth-api-monitoring-agent:<agent-tag> | (eval $(minikube docker-env) && docker load)

CODE

Web モニタリング PSA および API モニタリング PSA の展開

Web モニタリング PSA および API モニタリング PSA をインストールするときは、それぞれの該当する一連の手順に必ず従ってください。一部の手順は、両方で共通しています。

イメージがレジストリに登録されると、アプリケーションはクラスタに展開されます。Helm チャートを使用して、必要な順序ですべての Kubernetes リソースを展開および作成します。

次の手順に従って、Helm をインストールします。

Heimdall、Postgres データベース、および測定ポッドを実行する新しい測定名前空間を作成します。

新しい測定名前空間を作成するには、次のように入力します。

kubectl create namespace measurement

CODE

1 つのコマンドを使用して、展開の詳細を含む Helm チャートを展開できます。エージェントを展開するには、以前にダウンロードした zip ファイルの Helm チャート sum-psa-heimdall.tgz を使用します。Private Synthetic Agent を展開する前に、いくつかの設定オプションを設定する必要があります。設定オプションを表示するには、すでにダウンロードした sum-psa-heimdall.tgz ファイルに移動し、次のように入力します。

helm show values sum-psa-heimdall.tgz &gt; values.yaml

CODE

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

Web Monitoring PSA:

設定キー	値
`heimdall > repository`	`sum-heimdall`
`heimdall > tag`	`<heimdall-tag>`
`heimdall > pullPolicy`	`Never`
`chromeAgent > repository`	`sum-chrome-agent`
`chromeAgent > tag`	`<agent-tag>`
`shepherd > url`	`Shepherd URL`
`shepherd > credentials`	`credentials`
`shepherd > location`	`agent location`

API Monitoring PSA:

設定キー	値
`heimdall > repository`	`sum-heimdall`
`heimdall > tag`	`<heimdall-tag>`
`heimdall > pullPolicy`	`Never`
`apiMonitoringAgent > repository`	`synth-api-monitoring-agent`
`apiMonitoringAgent > tag`	`<agent-tag>`
`shepherd > url`	`Shepherd URL`
`shepherd > credentials`	`credentials`
`shepherd > location`	`agent location`

残りの値はデフォルトのままにすることも、要件に基づいて設定することもできます。シェパード URL、ログイン情報、場所、およびオプションのキーと値のペアの詳細については、「Private Synthetic Agent の設定」を参照してください。

上記の設定を使用して Helm チャートを展開するには、すでにダウンロードした sum-psa-heimdall.tgz ファイルに移動し、次のように入力します。
```
helm install heimdall-onprem sum-psa-heimdall.tgz --values values.yaml --namespace measurement
```
CODE
すべての Kubernetes リソースがクラスタに作成され、Heimdall を使用できます。数秒後、Heimdall が初期化され、コントローラに表示されます。
ポッドが実行されているかどうかを確認するには、次のように入力します。
```
kubectl get pods --namespace measurement
```
CODE
初期導入後に values.yaml に変更を加えるには、すでにダウンロードした sum-psa-heimdall.tgz ファイルに移動して、次のように入力します。
```
helm upgrade heimdall-onprem sum-psa-heimdall.tgz --values values.yaml --namespace measurement
```
CODE
展開を削除するには、次のコマンドを実行します。
helm uninstall heimdall-onprem --namespace measurement

CODE
これは、必要でない限り推奨されません。

Kubernetes クラスタのモニタリング

ダウンロードした zip 内の Helm チャート sum-psa-monitoring.tgz により、モニタリングスタックがインストールされます。この Helm チャートは、Private Simple Synthetic Agent をモニタするためのカスタム Grafana ダッシュボードとともに kube-prometheus-stack をインストールします。

この展開のモニタリングはオプションです。ただし、クラスタをモニタして正常性を定期的に確認することを強く推奨します。

モニタリングスタックのインストール

別の monitoring 名前空間を作成するには、次のように入力します。
```
kubectl create namespace monitoring
```
CODE
設定オプションを確認するには、次のように入力します。
```
helm show values sum-psa-monitoring.tgz &gt; values.yaml
```
CODE
これにより、すべての設定オプションを含む values.yaml ファイルが生成されます。Helm チャートのインストール中に生成された values.yaml ファイルを変更して渡すには、次のように入力します。
```
helm install psa-monitoring sum-psa-monitoring.tgz --values values.yaml --namespace monitoring
```
CODE
モニタリングスタックをインストールした後、（クラスタ内で実行される）Grafana を起動してダッシュボードを表示できます。クラスタの外部から Grafana にアクセスするには、ポートフォワーディングを設定するか、Ingress を設定します。ローカルにアクセスするようにポートフォワーディングを設定するには、次のように入力します。
```
kubectl port-forward svc/psa-monitoring-grafana 3000:80 --namespace monitoring
```
CODE
ブラウザから localhost:3000 を起動し、デフォルトのログイン情報（ユーザ名：admin、パスワード：prom-operator）を使用して、ログインします。Private Simple Synthetic Agent という名前のダッシュボードに、Kubernetes クラスタ、Heimdall、Postgres、および実行中の測定に関する詳細が表示されます。