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 에이전트를 두 가지 다른 방식으로 구성할 수 있습니다.

사용 중인 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
• HTTPd

이 애플리케이션들은 에이전트가 수신 대기 중인 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 에이전트 구성을 참조하십시오.

비밀을 사용하여 자격증명, 토큰 또는 키와 같은 민감한 데이터를 저장하고 관리할 수 있습니다. 자세한 내용은 Kubernetes secrets를 참조하세요.