本文へスキップ

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

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

ノート

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エージェントイメージリポジトリの追加対応​

WhaTap Kubernetesエージェントは、従来のDockerHubの他にPublic ECRに追加対応します。 使用環境に応じて、2つのイメージリポジトリのいずれかを選択してインストールできます。

Public ECR​

  • リポジトリ: public.ecr.aws/whatap/kube_mon 推奨

ECRは、pull制限ポリシーの影響を受けないため、頻繁なアップデートや大規模な配布環境で安定的に使用できるのでお勧めします。

DockerHub​

  • リポジトリ: whatap/kube_mon

DockerHubは、認証されていないクライアントに対してpull制限(policy)が適用されることがあります。 ノード数が多かったり、同時にpullリクエストが発生した場合、rate limitに引っかかってインストールが失敗する可能性が高いです。 詳しくはDockerHubポリシー案内の公式文書を参考にしてください。

注意

pull制限が発生した場合は、次の文書を参考にしてください。

追加機能の適用​

WhaTap Kubernetesモニタリングは、様々な追加機能を提供します。

追加機能の適用

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

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

コントロールプレーンモニタリング活性化​

コントロールプレーンモニタリングアクティベーションと各機能の詳細については、次の文書を参照してください。

Custom Resourceモニタリング活性化​

WhaTap Kubernetesエージェント設置yamlファイルでClusterRoleリソースのrules下位のresources項目に使用しようとするcustomResourceを追加します。

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  creationTimestamp: "2025-01-15T01:48:26Z"
  name: whatap
  resourceVersion: "125200773"
  uid: 54b0bcdb-1f12-4779-b0cb-e8de2f6be64a
rules:
- apiGroups:
  - '*'
  resources:
  - namespaces
  - pods
  - pods/log
  - configmaps
  - services
  - endpoints
  - daemonsets
  - ingresses
  - deployments
  - nodes
  - persistentvolumes
  - persistentvolumeclaims
  - events
  - replicasets
  - roles
  - rolebindings
  - clusterroles
  - clusterrolebindings
  - jobs
  - cronjobs
  - statefulsets
  - serviceaccounts
  - configmaps
  - storageclasses
  - horizontalpodautoscalers
  - replicationcontrollers
  - customresourcedefinitions # CRD収集権限を追加
  - samplecrds # モニタリングするCustom Resourceの名前を追加
  verbs:
  - get
  - list
  - watch
- apiGroups:
  - ""
  resources:
  - pods/exec
  verbs:
  - create
- apiGroups:
  - ""
  resources:
  - configmaps
  verbs:
  - '*'
- nonResourceURLs:
  - /metrics
  verbs:
  - '*'
ノート

Object ManifestメニューでCustom Resourceモニタリングができます。

新規収集対象のClusterRole権限​

次の収集機能は、ClusterRoleリソースのrules配下のresources項目に照会権限を追加した場合にのみ動作します。

ResourceFeatureDescription
networkpoliciesNetworkPolicyイベント収集kube_network_policyカテゴリーの収集に必要
resourcequotasネームスペースのResourceQuota収集kube_statカテゴリーのquota_*フィールドの収集に必要
  • 権限がない場合、その収集のみが省略され、残りの収集は継続されます。

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

インストールファイルをダウンロードする前に、ユーザー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モニタリングの主要メニューに関する案内を確認できます。 ガイド画面の下側にある各メニューのボタンをクリックすると、そのメニューへ移動します。

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

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

最終修正：