Kubernetes / Trace Agent

Last updated on Sep 27, 2023

쿠버네티스 환경에서 DataSaker Trace agent 설치하기

Trace agent는 Opentelemetry와 Jaeger와 같은 오픈소스 분산 추적 시스템과 연동하여, 애플리케이션의 분산 추적 데이터를 수집합니다. 이를 통해 애플리케이션 내부의 다양한 서비스 간의 통신을 추적하고, 성능 병목 현상을 식별하여 최적화할 수 있습니다. 수집된 데이터는 빠르게 처리되어 실시간으로 모니터링 및 분석이 가능합니다. 고객의 요구사항에 맞게 Trace agent 설정을 조정하여 최적의 결과를 제공해 드립니다.

DataSaker 선행 작업을 진행하였나요?

현재 Kubernetes 환경에 DataSaker의 선행 작업이 진행되지 않으셨다면 DataSaker 선행 작업을 먼저 진행하여 주시기 바랍니다. DataSaker 선행 작업

Trace agent 설치하기

1. Trace agent 설정 값 등록

cat << EOF >> ~/datasaker/config.yaml

traceAgent:
  enabled: true
  logLevel: 'INFO'
EOF

2. Trace agent 설치

helm upgrade datasaker datasaker/agent-helm -n datasaker \
  -f ~/datasaker/config.yaml

Trace agent 포트 정보

Port	Protocol	Describe
6831	UDP	thrift-compact
6832	UDP	thrift-binary
14250	TCP	jaeger-grpc
14268	TCP	jaeger-http
4317	TCP	otlp-grpc
4318	TCP	otlp-http

Trace agent 설정하기

Trace agent 설정 값

Trace agent의 설정 값의 의미와 default값은 다음과 같습니다. 사용자마다 에이전트 설정에 대해 다른 요구사항이 있습니다. 따라서 에이전트 설정을 사용자 설정에 맞게 조정해야 합니다. 최적의 결과를 위해 에이전트 설정을 조정하세요 "~/datasaker/config.yaml"에서 해당 값을 추가하거나 수정하세요. 각 항목에 설정된 값은 기본 설정 값입니다.

traceAgent:
  enabled: false
  tolerations: []
  imgPolicy: 'Always' # [Always, IfNotPresent, Never]
  imgVersion: 'latest'
  tags: []
  resource:
    requests:
      cpu: 100m
      memory: 512Mi
    limits:
      cpu: 1000m
      memory: 1000Mi
  logLevel: 'INFO'
  nodeSelector: {}
  affinity: {}
  collector:
    samplingRate: 1

각 설정 값에 대한 자세한 설명은 다음과 같습니다.

설정 값	설명
enabled	Trace agent를 활성화를 설정합니다.
tolerations	워커 노드에 taint가 설정되어 있을 경우 toleration 설정을 추가합니다.
imgPolicy	agent의 Image Policy를 설정합니다. (Always, IfNotPresent, Never)
imgVersion	agent의 Image Version를 설정합니다.
logLevel	agent의 log level을 설정합니다. (debug > info > warn > error > panic > fatal)
tags	사용자 설정으로 데이터에 추가할 Tag 리스트를 입력하세요. key1=value1,key2=value2
resource	agent의 resource를 설정합니다. 너무 작게할 경우 정상동작을 못할 수 있습니다.