Kubernetes での Instana エージェントの管理

ホストエージェントをインストールした後、 Instana のUIまたはホスト上で、ホストエージェントのステータスを確認してください。 詳細については、ホストエージェントのステータスの確認を参照してください。

Kubernetes では、エージェント設定ファイルまたは環境変数を使用して、エージェントを設定できます。

ホストエージェントをインストールすると、以下の設定ファイルが作成されます：

/opt/instana/agent/etc/mvn-settings.xml
/opt/instana/agent/etc/org.ops4j.pax.url.mvn.cfg
/opt/instana/agent/etc/instana/com.instana.agent.bootstrap.AgentBootstrap.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.Agent.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.config.UpdateManager.cfg
/opt/instana/agent/etc/instana/com.instana.agent.main.sender.Backend.cfg
/opt/instana/agent/etc/instana/configuration.yaml
 

エージェントの構成は、必要に応じてカスタマイズすることができます。 たとえば、ホストエージェントが接続する Instana バックエンドおよびサービスの TCP ポートやホスト名を変更したり、エージェントが複数のバックエンドに報告するように設定したり、ホストエージェントから Instana バックエンドへの間接通信にプロキシを使用するように設定したりすることができます。

エージェント設定のカスタマイズについては、以下のトピックを参照してください：

• エージェントのロギング
• Instana バックエンドの設定
• ホスト・エージェント・モードの構成
• エージェント設定ファイルを使用したホストエージェントの設定
• 静的エージェントを動的エージェントに変換する
• ホスト・エージェントの CPU とメモリーの制限
• ダイナミック・エージェントの現在のバージョンの取得
• エージェント・プロキシーのセットアップ
• エージェントエンドポイントの TLS 暗号化の設定
• ダイナミック・エージェントの更新間隔
• 動的エージェントのバージョン固定

インストール方法に応じて、 Kubernetes 用の Instana エージェントはいくつかの方法で更新できます。

helm pull --repo https://agents.instana.io/helm --untar instana-agent && kubectl apply -f instana-agent/crds; helm upgrade --namespace instana-agent instana-agent \
--repo https://agents.instana.io/helm instana-agent \
--reuse-values
 

kubectl rollout restart ds instana-agent -n instana-agent
 

kubectl rollout restart deployment instana-agent-k8sensor -n instana-agent
 

Instana のUIにある「エージェント管理」ダッシュボードを使用すると、以下の操作を行うことができます：

• エージェント・モードの変更
• ログ・レベルの変更
• エージェントの更新
• エージェントのリセット
• エージェントのリブート
• センサーを見る
• [構成管理]
  • 構成管理の初期化
  • 構成管理の更新
• 自己モニター

エージェント管理ダッシュボードを開くには、以下の手順に従ってください：

1. Instana のUIのサイドバーで、 「インフラストラクチャ」 を選択します。
2. 特定の監視ホストをクリックします。
3. ホストダッシュボードで、[エージェント管理を開く]をクリックします。

以下の種類のアプリケーションがエージェントと通信できるようにするには、ネットワークアクセスを設定する必要があります：

• Node.js
• Go
• Ruby
• Python
• .NET Core

これらのアプリケーションは、エージェントがリスニングしているIPアドレスを知る必要があります。 ホストエージェントは自動的にホストIPをリッスンする。 以下の Downward API スニペットを使用すると、環境変数に設定されたホスト IP をアプリケーションのポッドに渡すことができます：

spec:
  containers:
    env:
      - name: INSTANA_AGENT_HOST
        valueFrom:
          fieldRef:
            fieldPath: status.hostIP
 

デフォルトでは、ホストエージェントは Kubernetes のコントロールプレーンノード（旧称：マスターノード）にはスケジュールされません。これは、デプロイメントがほとんどのコントロールプレーンノードに設定されているデフォルトのテイント node-role.kubernetes.io/master:NoSchedule を尊重するためです。 コントロールプレーンノードを監視するには、まず次のコマンドを実行し、応答に が .spec.taints 含まれているか確認して、コントロールプレーンノードにどのテイントが設定されているかを確認します：

kubectl describe node <control-plane-node-name>
 

次に、コントロールプレーンノードに設定されているテイントに対して、エージェント DaemonSet に許容値を追加します。 コントロールプレーンノードにデフォルトのテイントが設定されている場合、エージェントのDaemonsetに対する適切な許容度は以下の通りです：

tolerations:
  - key: "node-role.kubernetes.io/master"
    effect: "NoSchedule"
    operator: "Exists"
 

必要な許容範囲を決定した後、コントロールプレーンノードを監視するには、エージェントのインストール時にその許容範囲を設定してください。

「 Helm 」チャートを使用してエージェントをインストールした場合、許容値は次の2つの方法で指定できます：

• このフラグを使用することで --set agent.pod.tolerations

• 以下の内容を含むファイル values.yaml を作成し、そのファイルを Helm のインストールコマンドにフラグを使用して -f values.yaml渡すことで：

agent:
  pod:
    # agent.pod.tolerations are tolerations to influence agent pod assignment.
    #   https://kubernetes.io/docs/concepts/configuration/taint-and-toleration/
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

オペレーターを使用してエージェントをインストールした場合は、ファイル instana-agent.customresource.yaml.spec.agent.pod.tolerations 内のカスタムリソースに許容値を追加してください。 以下の例を参照してください。

spec:
  agent:
   pod:
    tolerations:
      - key: "node-role.kubernetes.io/master"
        effect: "NoSchedule"
        operator: "Exists"
 

次に、次のコマンドを実行して、新しいカスタムリソースをクラスターに適用します：

kubectl apply -f instana-agent.customresource.yaml
 

より直接的な制御を行うには、コントロールプレーンノードにホストエージェントを個別にインストールしてください。

Kubernetes NGINX の Ingress および NGINX のメトリクスを収集するためのホストエージェントを設定するには、 NGINX の「モニタリング」を参照してください。

KubernetesNGINX Ingressで分散トレーシングを有効にするには、 「 NGINX Ingressの分散トレーシング」 を参照してください。

Kubernetesには、機密情報の保存と管理のためのサポートが組み込まれている。 ただし、この組み込み機能を使用しない場合でも、 Kubernetes のリソースから機密データをマスキングする必要がある場合は、エージェントのシークレットを設定することができます。

選択した Kubernetes リソース（具体的にはアノテーションおよびコンテナ環境変数）の機密データのマスキングを有効にするには、以下の手順を実行してください：

1. 以下の YAML エージェントのスニペットのように、環境 INSTANA_KUBERNETES_REDACT_SECRETS 変数を true に設定してください：

   spec:
     containers:
         env:
           - name: INSTANA_KUBERNETES_REDACT_SECRETS
             value: "true"
    

2. 「 エージェントのシークレット設定 」の説明に従い、必要なシークレットのリストを使用してホストエージェントを設定してください。

Operator または ` Helm ` チャートを使用してインストールされたホストエージェントについては、次のコマンドを実行することでバックエンドを追加できます：

• Helmチャートを使用してインストールされたホストエージェントの場合：

     helm install instana-agent \
     --repo https://agents.instana.io/helm \
     --namespace instana-agent \
     --create-namespace \
     --set agent.key=my-key \
     --set agent.endpointHost='<your_host_agent_endpoint>' \
     --set agent.endpointPort=443 \
     --set cluster.name='<your_cluster_name>' \
     --set zone.name='zone-name' \
     --set "agent.additionalBackends[0].endpointHost=<your_host_agent_endpoint>" \
     --set "agent.additionalBackends[0].key=<your_agent_key>" \
     --set "agent.additionalBackends[0].endpointPort=443" \
     --set "agent.additionalBackends[1].endpointHost=<your_other_host_agent_endpoint>" \
     --set "agent.additionalBackends[1].key=<your_other_agent_key>" \
     --set "agent.additionalBackends[1].endpointPort=443" \
     instana-agent
   

• Operatorを使用してインストールされるホストエージェントの場合：

  apiVersion: instana.io/v1
  kind: InstanaAgent
  metadata:
    name: instana-agent
    namespace: instana-agent
  spec:
    zone:
      name: edited-zone # (optional) name of the zone of the host
    cluster:
      name: my-cluster
    agent:
      endpointHost: <your_host_agent_endpoint>
      endpointPort: "443"
      env: {}
      key: <your_agent_key>
      additionalBackends:
      - endpointHost: <your_host_agent_endpoint>
        endpointPort: "443"
        key: <your_agent_key>
      configuration_yaml: |
        # You can leave this empty, or use this to configure your instana agent.
        # See https://github.com/instana/instana-agent-operator/blob/main/config/samples/instana_v1_extended_instanaagent.yaml for the extended version.
   

Kubernetes エージェントから複数のバックエンドへレポートを送信する方法の詳細については、 「 Instana バックエンドの設定」 を参照してください。