합성 PoP 모니터링

Helm 차트를 사용하여 Synthetic PoP 센서를 설치하고 구성하려면 다음 단계를 완료하십시오.

1. Instana 에이전트 차트( Helm )를 다운로드하여 압축을 풀어주세요:

   helm repo add instana-agent-repo https://agents.instana.io/helm
   helm repo update
   helm pull instana-agent-repo/instana-agent
   tar xzvf instana-agent-*.tgz
   

2. 다음 예제에 표시된 대로 instana-agent/templates/agent-daemonset.yaml 파일의 volumeMounts 및 volumes 섹션 모두에서 모든 키 및 인증서 파일에 대한 특성을 추가하십시오.

   volumeMounts:
     - name: pop-cert
       mountPath: /opt/instana/agent/etc/pop
   
   volumes:
     - name: pop-cert
       secret:
         secretName: pop-cert-secret
   

3. , clientCertificate, 및 clientKeycaCertificate 필드를 TLS 암호화 구성으로 설정하십시오. 다음 예제에 표시된 대로 agent_with_pop_sensor.yaml 구성 파일을 작성하십시오.

   com.instana.plugin.syntheticpop:
     enabled: true
     poll_rate: 60 # seconds, minimum 60 seconds by default
     caCertificate: '/opt/instana/agent/etc/pop/ca.crt' # path to X.509 CA certificate file if HTTPS is enabled for PoP Controller
     clientCertificate: '/opt/instana/agent/etc/pop/tls.crt' # path to X.509 client certificate file if HTTPS is enabled for PoP Controller
     clientKey: '/opt/instana/agent/etc/pop/tls.key' # path to client private key file if HTTPS is enabled for PoP Controller
   

4. Synthetic PoP 센서와 함께 Instana 호스트 에이전트를 설치합니다:

   helm install instana-agent \
   ./path/to/instana-agent \
   --namespace instana-agent \
   --set agent.key='<your_agent_key>' \
   --set agent.endpointHost='<your_host_agent_endpoint>' \
   --set agent.endpointPort=443 \
   --set cluster.name='<your_cluster_name>' \
   --set zone.name='<your_zone_name>' \
   --set-file agent.configuration_yaml=agent_with_pop_sensor.yaml
   

TLS 구성을 확인하려면 Instana 호스트 에이전트 컨테이너로 이동하여 /opt/instana/agent/etc/pop/ 디렉터리에, tls.key, 및 tls.crtca.crt 파일이 있는지 확인하십시오.

Instana 호스트 에이전트가 설치되어 있지만 Synthetic PoP 이 TLS 암호화 방식으로 배포된 경우, Synthetic PoP 을 모니터링하려면 TLS 구성을 사용하여 Instana 호스트 에이전트를 업그레이드해야 합니다.

Kubernetes 클러스터 내의 파일을 yaml 사용하여 Synthetic PoP 센서를 설치하고 구성하려면, Kubernetes 에서 ‘호스트 에이전트 설치’를 참조하십시오. TLS 인증서를 추가하려면 deployment.yaml 설정을 사용자 지정하십시오.

1. Instana UI에서 ‘ Instana 에이전트 설치’로 이동한 후, 사용 중인 플랫폼을 선택합니다. 일반적으로는 ‘ Kubernetes - Yaml ’ 또는 ‘ OpenShift - Yaml’입니다.

2. 클러스터 이름을 입력하고 deployment.yaml 파일을 다운로드하십시오.

3. 다음 예제에 표시된 대로 deployment.yaml 파일의 volumeMounts 및 volumes 섹션 모두에서 모든 키 및 인증서 파일에 대한 특성을 추가하십시오.

   volumeMounts:
     - name: pop-cert
       mountPath: /opt/instana/agent/etc/pop
   
   volumes:
     - name: pop-cert
       secret:
         secretName: pop-cert-secret
   

4. 다음 컨텐츠에서와 같이 deployment.yaml 파일의 com.instana.plugin.syntheticpop 섹션에서 키 또는 인증서 파일 경로를 업데이트하십시오.

   com.instana.plugin.syntheticpop:
     enabled: true
     poll_rate: 60 # seconds, minimum 60 seconds by default
     caCertificate: '/opt/instana/agent/etc/pop/ca.crt' # path to X.509 CA certificate file if HTTPS is enabled for PoP Controller
     clientCertificate: '/opt/instana/agent/etc/pop/tls.crt' # path to X.509 client certificate file if HTTPS is enabled for PoP Controller
     clientKey: '/opt/instana/agent/etc/pop/tls.key' # path to client private key file if HTTPS is enabled for PoP Controller
   

5. 업데이트된 배포 파일을 적용하여 Instana 에이전트를 설치하십시오:

   kubectl apply -f deployment.yaml
   

Operator를 사용하여 Synthetic PoP 센서를 설치하고 구성하려면 Kubernetes 의 ‘호스트 에이전트 설치 ’ 섹션을 참조하십시오. TLS 인증서를 추가하려면 및 instana-agent.customresource.yaml 데몬셋을 사용자 정의하고 편집해야 합니다.

1. Instana UI에 로그인하십시오.

2. 탐색 메뉴에서 더 > 자치령 대표 .

3. ‘ Instana Agents’를 클릭한 다음, 사용 중인 플랫폼을 선택하세요. 예를 들어, Kubernetes 연산자나 OpenShift 연산자 등이 있습니다.

4. 에서 클러스터 이름 필드에 클러스터 이름을 입력하고instana-agent.customresource.yaml 파일.

5. 다음에서 키 또는 인증서 파일 경로를 업데이트하세요.configuration_yaml 섹션instana-agent.customresource.yaml 다음 예에 표시된 대로 파일을 삭제하세요.

   configuration_yaml: |
     com.instana.plugin.syntheticpop:
       enabled: true
       poll_rate: 60 # seconds, minimum 60 seconds by default
       caCertificate: '/opt/instana/agent/etc/pop/ca.crt' # path to X.509 CA certificate file if HTTPS is enabled for PoP Controller
       clientCertificate: '/opt/instana/agent/etc/pop/tls.crt' # path to X.509 client certificate file if HTTPS is enabled for PoP Controller
       clientKey: '/opt/instana/agent/etc/pop/tls.key' # path to client private key file if HTTPS is enabled for PoP Controller
   

6. 다음 예시와 같이 업데이트된 고객 리소스 파일을 적용하여 Instana 에이전트를 설치하십시오:

   kubectl apply -f instana-agent.customresource.yaml
   

7. 다음 명령을 실행하여 Instana 에이전트 DaemonSet 에 pop-cert-secret 추가하십시오:

   kubectl patch daemonset.apps/instana-agent -n instana-agent --type='json' \
   -p='[{"op":"add","path":"/spec/template/spec/containers/0/volumeMounts/0","value":{"mountPath": "/opt/instana/agent/etc/pop","name": "pop-cert"}},{"op":"add","path":"/spec/template/spec/volumes/0","value":{"name": "pop-cert","secret":{"defaultMode": 420,"secretName": "pop-cert-secret"}}}]'
   

   Operator를 사용하여 Instana 에이전트를 다시 설치하면 업데이트 내용이 daemonset.apps 사라집니다. Operator를 사용하여 Instana 호스트 에이전트를 설치할 때마다 이 명령을 다시 실행해야 합니다.

TLS 구성을 확인하려면 Instana 호스트 에이전트 컨테이너로 이동하여 /opt/instana/agent/etc/pop/ 디렉터리에, tls.key, 및 tls.crtca.crt 파일이 있는지 확인하십시오.

다음 표에는 Synthetic PoP: 에서 수집된 구성 데이터가 나열되어 있습니다

다음 표에는 Synthetic의 ‘ PoP ’ 태그에서 수집된 구성 데이터가 나열되어 있습니다:

합성 PoP 는 네임스페이스가 있는 Kubernetes 클러스터에 배치됩니다. 합성 PoP 스냅샷 또는 메트릭 대시보드에서 Kubernetes 네임스페이스 및 클러스터로 이동할 수 있습니다. 다음 표에는 Synthetic PoP Kubernetes 에서 수집된 구성 데이터가 나열되어 있습니다: