• Minikube は単一のマシンにインストールされます。したがって、Minikube で PSA を設定する場合は、スケーラブルでも高可用性でもありません。
  • 機能的には、Minikube の PSA と AKS、EKS、GKE、またはその他の Kubernetes クラスタの PSA に違いはありません。

次のように、Minikube での Web モニタリング PSA と API モニタリング PSA を設定します。既存の Kubernetes クラスタで PSA を設定する場合は、「Kubernetes クラスタの作成」セクションをスキップします。

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

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

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

Kubernetes クラスタの作成

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

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

  2. クラスタを開始するには、次のように入力します。

    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: sum-api-monitoring-agent、sum-heimdall、および Helm チャートの Dockerfile


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

sum-chrome-agent の場合：

  1. zip ファイルを解凍して、sum-chrome-agent ディレクトリにアクセスします。

  2. ディレクトリに移動して、次のコマンドを実行します。

    docker build -f Dockerfile-PSA -t sum-chrome-agent:<agent-tag> .
    CODE

sum-api-monitoring-agent の場合：

  1. zip ファイルを解凍して、sum-api-monitoring-agent ディレクトリにアクセスします。

  2. ディレクトリに移動して、次のコマンドを実行します。

    docker build -f Dockerfile-PSA -t sum-api-monitoring-agent:<agent-tag> .
    CODE

sum-heimdall の場合：

  1. zip ファイルを解凍して、sum-heimdall ディレクトリにアクセスします。 

  2. このディレクトリに移動して、次のコマンドを実行します。

    docker build -f Dockerfile-PSA -t sum-heimdall:<heimdall-tag> .
    CODE

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

（オプション）カスタム Python ライブラリの追加

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

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

  1. 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 ディレクティブを作成して、必要なライブラリをインストールできます。

  2. 新しいイメージをビルドするには、次のように入力します。

    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 sum-api-monitoring-agent:<agent-tag> | (eval $(minikube docker-env) && docker load)
CODE

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


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

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

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

  2. 次のいずれかのデータベースを使用して PSA をインストールします。

    データベースサポートされている PSA バージョン

    Postgres データベースを使用する Heimdall

    		22.6.0 以前
    インメモリデータベース（Ignite）を使用する Heimdall22.9.0

    For Heimdall with Postgres database:

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


      Postgres データベース、またはインメモリデータベースを使用する Heimdall は、一度にいずれかを使用できます。

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

      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 > repositorysum-heimdall
      heimdall > tag<heimdall-tag>
      heimdall > pullPolicyNever
      chromeAgent > repositorysum-chrome-agent
      chromeAgent > tag<agent-tag>
      shepherd > urlShepherd URL
      shepherd > credentialscredentials
      shepherd > locationagent location

      API Monitoring PSA:

      設定キー

      値

      heimdall > repositorysum-heimdall
      heimdall > tag<heimdall-tag>
      heimdall > pullPolicyNever
      apiMonitoringAgent > repositorysum-api-monitoring-agent
      apiMonitoringAgent > tag<agent-tag>
      shepherd > urlShepherd URL
      shepherd > credentialscredentials
      shepherd > locationagent location

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

    For Heimdall with in-memory database (Ignite):

    1. Ignite を使用するインメモリデータベースを用いる Heimdall、および測定ポッドを実行する新しい測定名前空間を作成します。 

      Postgres データベース、またはインメモリデータベースを使用する Heimdall は、一度にいずれかを使用できます。

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

      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 > repositorysum-heimdall
      heimdall > tag<heimdall-tag>
      heimdall > pullPolicyNever
      heimdall > replicaCount1
      ignite > devmode true
      chromeAgent > repositorysum-chrome-agent
      chromeAgent > tag<agent-tag>
      shepherd > urlShepherd URL
      shepherd > credentialscredentials
      shepherd > locationagent location

      複数のコンテナを作成することはできません。

      API Monitoring PSA:

      設定キー

      値

      heimdall > repositorysum-heimdall
      heimdall > tag<heimdall-tag>
      heimdall > pullPolicyNever
      heimdall > replicaCount1
      ignite > devmode true
      apiMonitoringAgent > repositorysum-api-monitoring-agent
      apiMonitoringAgent > tag<agent-tag>
      shepherd > urlShepherd URL
      shepherd > credentialscredentials
      shepherd > locationagent location

      複数のコンテナを作成することはできません。

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

  3. 上記の設定を使用して Helm チャートを展開するには、すでにダウンロードした sum-psa-heimdall.tgz ファイルに移動し、次のように入力します。

    helm install heimdall-onprem sum-psa-heimdall.tgz --values values.yaml --namespace measurement
    CODE

    すべての Kubernetes リソースがクラスタに作成され、Heimdall を使用できます。数秒後、Heimdall が初期化され、コントローラに表示されます。

  4. ポッドが実行されているかどうかを確認するには、次のように入力します。

    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 をインストールします。

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

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

  1. 別の 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

  2. モニタリングスタックをインストールした後、（クラスタ内で実行される）Grafana を起動してダッシュボードを表示できます。クラスタの外部から Grafana にアクセスするには、ポートフォワーディングを設定するか、Ingress を設定します。ローカルにアクセスするようにポートフォワーディングを設定するには、次のように入力します。

    kubectl port-forward svc/psa-monitoring-grafana 3000:80 --namespace monitoring
    CODE

  3. ブラウザから localhost:3000 を起動し、デフォルトのログイン情報（ユーザ名：admin、パスワード：prom-operator）を使用して、ログインします。[Private Simple Synthetic Agent] という名前のダッシュボードに、Kubernetes クラスタ、Heimdall、インメモリデータベース（Ignite）を使用する Heimdall、Postgres、および実行中の測定に関する詳細が表示されます。