本文へスキップ

マスターおよびノードエージェントのインストール

次のように、マスター及びノードエージェントのインストール手順を案内します。 インストール案内画面と同じ手順です。

ノート

EKS Fargateは、対応予定です。

インストール方法の選択​

アクセスキー確認後、インストールの案内画面でインストール方法の選択タブを選択します。 WhaTap KubernetesエージェントがサポートするYamlファイルとHelmチャートのインストール方法の中から希望するインストール方法を選択し、ユーザーのKubernetes環境に合わせて適切な項目を選択します。

インストール方式の選択

  1. WhaTap Kubernetesエージェントのイメージバージョンを推奨するStableバージョンとPreviewバージョンの中から選択します。

  2. YAMLファイルとHelmチャートのインストール方法の中から希望するインストール方式を選択します。

  3. 1.16以降バージョンまたは1.16未満バージョンの中で該当するKubernetesバージョンを選択します。

  4. containerd, Docker Engine, CRI-Oの中、コンテナランタイムを選択します。

  5. ユーザーKubernetes環境(GKE, OpenShift, Istio, GPU Cluster) の中、該当する項目がある場合は選択します。

  6. インストール方法に関する項目を選択した後、画面右下の次ボタンをクリックするか、左の追加機能の適用タブを選択して次のステップへ移動します。

追加機能の適用​

WhaTap Kubernetesモニタリングは、現在コントロールプレーンモニタリングを追加機能として提供します。 追加機能の適用を希望する場合、Control Planeチェックボックスを選択します。

追加機能の適用

追加適用された機能が多いほど、収集されるデータの量とエージェントが使用するリソースの量が増加する可能性があります。 インストール後、エージェント設定により、その機能を活性化または非活性化できます。

追加機能を適用するかどうかを選択した後、画面右下の次へボタンをクリックするか、左のインストールファイルのダウンロードタブを選択して次のステップへ移動します。

ノート

コントロールプレーンモニタリングについての詳細は、次の文書を参照してください。

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

インストールファイルをダウンロードする前に、ユーザーKubernetes環境に適した項目が選択されていることを確認してください。 選択項目を確認した後、インストールファイルのダウンロードボタンをクリックしてインストールに必要なデフォルト設定ファイル(values.yaml)をダウンロードします。

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

ダウンロード後、画面右下の次へボタンをクリックするか、実行コマンドの入力タブを選択して次のステップへ移動します。

実行コマンドの入力​

インストール方法の選択タブで選択した環境とインストール方法の案内に沿って、実行コマンドを入力し、インストールします。

実行コマンドの入力

Kubernetes環境​

インストール方法の選択タブでGKEまたはOpenShift環境を選択した場合は、次のガイドを参照してください。 該当しない場合は、次のKubernetesエージェント作成 ステップに進みます。

インストール方法の選択タブでGoogle Kubernetes Engine(GKE) 環境を選択した場合は、ユーザークラスターを作成した後、権限設定のために次のコマンドを実行します。

ACCOUNT=$(gcloud info --format='value(config.account)')
kubectl create clusterrolebinding owner-cluster-admin-binding \
  --clusterrole cluster-admin \
  --user $ACCOUNT
ノート

gcloudコマンドのインストールの詳細については、グーグルクラウド文書を参照してください。

Kubernetesエージェント作成​

WhaTap Kubernetesエージェントのインストール時Yamlファイル基準のインストール方法の案内とHelmチャート基準のインストール方法の案内を次のように提供します。

Yamlファイル基準インストール​

インストール方法の選択タブでYamlファイルのインストール方法を選択した場合は、エージェントを生成するために次のコマンドを実行します。

kubectl apply -f whatap_kube_agent.yaml
ノート

マスターエージェントが使用するリソースの量は、ユーザー環境のノード数にある程度比例します。 つまり、クラスタ内にノード数が多い場合、既定値に設定されたメモリLimit(350MB)以上のリソースを使ってOOM(Out Of Memory)が発生する可能性があります。 マスターエージェントに割り当てられたメモリLimitは、エージェントのインストールYAMLファイルから変更できます。

エージェントのインストール確認​

Kubernetesエージェントのインストールが正常に完了した場合、次のコマンドを実行してマスターエージェントとノードエージェントの状態を確認できます。

kubectl get pod -n whatap-monitoring

Running状態の場合​

次のようにSTATUS項目がRunningである場合は、インストール済みです。 マスター及びノードエージェントのインストールを完了すると、Kubernetes環境のリソースモニタリングを開始します。 WhaTapモニタリングサービスに移動し、プロジェクトリストとダッシュボード >コンテナマップメニューから性能情報を収集することを確認します。

Running状態でない場合​

次のようにSTATUS項目がRunningでない場合、インストールが正しく行われていない状態です。

  1. マスターノードで次のコマンドを実行し、Podの生成に失敗した原因を特定します。

    kubectl describe pod {POD_NAME} -n whatap-monitoring

  2. 実行結果の下部の Events: 項目を確認してください。

Tips

kubectlコマンドを使用する場合、-n {ネームスペース}オプションを使用すると、特定のネームスペースを対象にタスクを実行します。 WhaTapエージェントは、基本的にwhatap-monitoringというネームスペースにインストールされるため、-n whatap-monitoringというオプションを追加します。

ノート

  • 画面右下にモニタリング開始ガイドボタンを選択すると、WhaTap Kubernetesモニタリングの主要メニューに関する案内を確認できます。 ガイド画面の下側にある各メニューのボタンをクリックすると、そのメニューへ移動します。

  • アプリケーションエージェントのインストールを進めるには、メニューの画面右下の追加モニタリングのインストールボタンを選択してください。 詳細については、次の文書を参照してください。

  • エージェントを最新バージョンにアップデートするには次の文書を参照してください。