在 Red Hat OpenShift 上管理 Instana 代理

安装代理后，可以使用以下命令检查代理部署中 pod 的状态：

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

在良好的部署中，命名空间中所有 pod 的 "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 代理。

根据您的Red Hat OpenShift环境，您可能需要自定义Red Hat OpenShift Container Registry。

根据您的安装方式，您可以通过多种方式更新适用于 Red Hat OpenShift 的 Instana 代理。

您可以通过 Instana 用户界面的“代理管理”仪表板完成以下操作：

• 切换代理模式
• 更改日志级别
• 更新代理
• 重置代理
• 重启代理
• 查看传感器
• [配置管理]
  • 初始化配置管理
  • 更新配置管理
• 自监视

要打开代理管理控制面板，请按照以下步骤操作：

1. 在 Instana 用户界面的侧边栏中，选择 “基础设施”。
2. 单击特定受监控主机。
3. 在主机仪表板上，单击打开代理管理。

您必须配置以下类型应用程序的网络访问权限，以便它们与代理进行通信：

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

这些应用程序需要知道代理的监听 IP 地址。 代理会自动监听主机 IP。 您可以使用以下 Downward API 代码片段，将环境变量中的主机 IP 传递给应用程序 Pod：

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

默认情况下，主机代理不会在 Kubernetes 控制平面节点上被调度。 有关如何监控控制平面节点的信息，请参阅 “监控控制平面节点 ”一节。

若需更直接的控制， 请在控制平面节点上单独安装代理。

有关如何配置 Kubernetes NGINX Ingress 和用于捕获 NGINX 度量值的我们代理程序的准则，请参阅监控 NGINX页面。 Kubernetes 的追踪 NGINX 也可以通过 OpenTracing 项目实现 Ingress 追踪 ，有关如何配置的指南，请参阅《 NGINX Ingress 的分布式追踪》。

若要使用 helm 和操作员添加其他后端，请运行以下命令。 您可以使用其他后端来配置您的 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 代理配置。

您可以使用 "秘密 "来存储和管理凭证、令牌或密钥等敏感数据。 更多详情请参阅 Kubernetes secrets。