Red Hat OpenShift での Instana エージェントの管理

エージェントをインストールした後、以下のコマンドを使用して、エージェントデプロイメント内のポッドのステータスを確認できます：

kubectl get pods -n instana-agent
kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
 

良いデプロイメントでは、名前空間内のすべてのポッドの 'STATUSは 'Running でなければなりません。 次の例のように、'instana-agentカスタムリソースは'status: Runningも表示しなければならない：

$ kubectl get pods -n instana-agent
NAME                                      READY   STATUS    RESTARTS   AGE
controller-manager-6478cb4c6f-8s29b       1/1     Running   0          70m
instana-agent-8ftnj                       1/1     Running   0          70m
instana-agent-9w4vc                       1/1     Running   0          70m
instana-agent-k8sensor-5bbf568976-5pjk2   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-h96hr   1/1     Running   0          3h2m
instana-agent-k8sensor-5bbf568976-lnbsg   1/1     Running   0          3h2m
instana-agent-zpmrj                       1/1     Running   0          70m

$ kubectl get agent instana-agent -n instana-agent -o yaml | yq ".status"
conditions:
  - lastTransitionTime: "2024-08-06T08:12:03Z"
    message: most recent reconcile of agent CR completed without issue
    observedGeneration: 2

    ...

observedGeneration: 2
oldVersionsUpdated: true
operatorVersion: 0.0.1-dev
status: Running
 

エージェントのインストール方法に応じて、 Kubernetes および Red Hat OpenShift 用の Instana エージェントを2つの異なる方法で設定できます。

Red Hat OpenShift環境によっては、Red Hat OpenShift Container Registryをカスタマイズする必要があるかもしれません。

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

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 のコントロールプレーンノードではスケジュールされません。 コントロールプレーンノードの監視方法については、 「コントロールプレーンノードの監視」 のセクションを参照してください。

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

Kubernetes NGINX Ingress の設定方法や、 NGINX のメトリクスを収集するためのエージェントに関するガイドラインについては、「 NGINX の監視」 ページをご覧ください。 Kubernetes のトレーシング NGINX Ingressについては、 OpenTracing プロジェクトを介してトレーシングを行うことも可能です。設定方法については、「 NGINX Ingressの分散トレーシング」のガイドラインを参照してください。

helm とoperatorを使用してバックエンドを追加するには、次のコマンドを実行します。 Instana エージェントの設定には、追加のバックエンドを使用することも、空のままにすることもできます。

• 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
   

• 演算子を使用する：

  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 エージェントから複数のバックエンドへのレポート機能を有効にするには、「 Docker エージェントの設定 」を参照してください。

Secrets を使って、認証情報、トークン、キーなどの機密データを保存・管理することができます。 詳細については、 Kubernetes secrets をご覧ください。