Ubuntu / Trace Agent

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

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

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

Trace agent 설치하기

1. 패키지 설치

curl -fsSL -o installer.sh https://dsk-agent-s3.s3.ap-northeast-2.amazonaws.com/dsk-agent-s3/public/install.sh
chmod 700 installer.sh
sudo ./installer.sh dsk-trace-agent

2. Trace agent 설정

vi /etc/datasaker/dsk-trace-agent/agent-config.yml

필요에 따라 다음 내용을 수정합니다.

agent:
  agent_name: "dsk-trace-agent"

3. 패키지 실행

systemctl enable dsk-trace-agent --now

4. 패키지 실행 상태 확인

sudo systemctl status dsk-trace-agent

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

Application에 Trace agent 연동하기

Trace agent를 이용하기 위해서는 먼저 SDK로 어플리케이션을 인스트로먼트 해야 합니다.
자세한 내용은 링크를 참고해주세요.
관련 문서 링크

Trace agent 설정하기

필요하다면 아래 문서를 참고하여 trace agent의 설정을 바꿀 수 있습니다.

Trace agent 설정 값

Trace agent의 설정 값의 의미한 default값은 다음과 같습니다.
사용자마다 에이전트 설정에 대해 다른 요구사항이 있습니다.
따라서 에이전트 설정을 사용자 설정에 맞게 조정해야 합니다.
최적의 결과를 위해 에이전트 설정을 조정하세요.
에이전트 기본 설정 파일 경로는 /etc/datasaker/dsk-trace-agent/agent-config.yml입니다.
설정 파일에서 값을 추가하거나 수정하세요.

파일의 구조는 아래와 같습니다.

agent-config.yml

agent:
  metadata: <metadata>
  option:
    [ collector_config: <collector_config> ]
  [ reciever_config: <reciever_config> ]

metadata

[ agent_name: <string> | default = "dsk-trace-agent" ]

[ cluster_id: <cluster_id> | default = "unknown" ]

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

Settings	Description	Default	Required
agent_name	에이전트의 이름을 설정합니다.	dsk-trace-agent	No
cluster_id	관제 대상이 되는 환경이 어떤 클러스터로 묶여있는지에 대한 설정을 합니다.	unknown	No

collector_config

[ sampling_rate: <float> | default = 1 ]

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

Settings	Description	Default	Required
sampling_rate	collector에 적용되는 샘플링 비율을 설정합니다. 100 이상일 때 모든 데이터가 수집됩니다.	1	No

receiver_config

[ custom_tags: <map[string]string> | default = "" ]

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

Settings	Description	Default	Required
listen_port	collector로부터 데이터를 받을 포트 번호를 설정합니다.	14251	No
custom_tags	각 span에 적용되는 커스텀 태그를 설정합니다.	""	No

Example

agent:
  metadata:
    agent_name: dsk-trace-agent 
  option:
    collector_configs:
    sampling_rate: 1

Trace agent 제거하기

1. 패키지 중단

systemctl stop dsk-trace-agent

2. 패키지 제거

sudo apt remove dsk-trace-agent