デプロイメント

ThousandEyes Agent

Kubernetes に ThousandEyes Enterprise Agent をデプロイし、ThousandEyes Cloud に正しく登録されていることを確認します。

20 minutes

このセクションでは、Kubernetes クラスターに ThousandEyes Enterprise Agent をデプロイする手順を説明します。

インストール手順

ステップ 1: ThousandEyes トークンの作成

  1. ThousandEyes プラットフォーム(app.thousandeyes.com/login )にログインします

  2. Network & App Synthetics > Agent Settings > Enterprise Agents > Add New Enterprise Agent に移動します

  3. Appliance タブをクリックします

  4. Account Group Token をコピーします

  5. トークンを Base64 エンコードします:

bash
echo -n 'your-token-here' | base64
  1. Base64 エンコードされた出力を次のステップのために保存します

Get ThousandEyes Token

ステップ 2: Secret の作成

Base64 エンコードされたトークンを使用して、credentialsSecret.yaml という名前のファイルを作成します:

yaml
apiVersion: v1
kind: Secret
metadata:
  name: te-creds
type: Opaque
data:
  TEAGENT_ACCOUNT_TOKEN: <your-base64-encoded-token-here>

Secret を適用します:

bash
kubectl apply -f credentialsSecret.yaml

ステップ 3: Deployment の作成

以下のデプロイメントマニフェストを使用して、thousandEyesDeploy.yaml という名前のファイルを作成します(hostname をご自身のユーザー名(例: tihard)にカスタマイズしてください):

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: thousandeyes
  labels:
    app: thousandeyes
spec:
  replicas: 1
  selector:
    matchLabels:
      app: thousandeyes
  template:
    metadata:
      labels:
        app: thousandeyes
    spec:
      hostname: te-agent-USERNAME
      containers:
      - name: thousandeyes
        image: 'thousandeyes/enterprise-agent:latest'
        imagePullPolicy: Always
        command:
          - /sbin/my_init
        securityContext:
          capabilities:
            add:
              - NET_ADMIN
              - SYS_ADMIN
        env:
          - name: TEAGENT_ACCOUNT_TOKEN
            valueFrom:
              secretKeyRef:
                name: te-creds
                key: TEAGENT_ACCOUNT_TOKEN
          - name: TEAGENT_INET
            value: "4"
        resources:
          limits:
            memory: 3584Mi
          requests:
            memory: 2000Mi

設定の説明

  • エージェントはネットワークテストを実行するために昇格された権限(NET_ADMINSYS_ADMIN)が必要です
  • 環境変数 TEAGENT_INET: "4" は IPv4 専用モードを強制します(一部のネットワーク構成で必要)
  • /sbin/my_init コマンドはエージェントの適切な初期化とサービス管理に必要です
  • imagePullPolicy: Always により、常に最新のイメージバージョンがプルされます
  • hostname フィールドを調整して、ThousandEyes ダッシュボードでエージェントを一意に識別できるようにしてください
  • ThousandEyes Enterprise Agent のハードウェア要件は比較的高いため、環境に応じて調整が必要な場合があります

Deployment を適用します:

bash
kubectl apply -f thousandEyesDeploy.yaml

ステップ 5: デプロイメントの確認

エージェントが実行されていることを確認します:

bash
kubectl get pods

ヒント

以下のコマンドを使用できます:

bash
watch -n 1 kubectl get pods

Pod が実行状態になるまで監視できます。何かの起動を待つ際にはいつでもこのヒントを活用してください。

ログを確認してエージェントが接続していることを確認します。以下のような出力が表示されるまで少し時間がかかる場合があります。

bash
kubectl logs -l app=thousandeyes

ステップ 6: ThousandEyes ダッシュボードでの確認

ThousandEyes ダッシュボードでエージェントが正常に登録されたことを確認します:

Network & App Synthetics > Agent Settings に移動して、新しく登録されたエージェントを確認します。

ThousandEyes Agent List

成功

ThousandEyes Enterprise Agent が Kubernetes で実行されています!次に、Splunk Observability Cloud との統合を行います。

トラブルシューティングガイダンス

エージェントが表示されない場合は、トークンを正しくエンコードしたか(最初のステップ)確認してください。

背景

ThousandEyes は公式の Kubernetes デプロイメントドキュメントを提供していません。標準的なデプロイ方法は docker run コマンドを使用するため、再利用可能な Kubernetes マニフェストへの変換が困難です。このガイドは、本番環境対応の Kubernetes 設定を提供することでそのギャップを埋めます。

Last Modified ·