분산 추적(APM) 모범 사례¶

###########--------Linux 환경---------##########
$ cd /usr/local/datakit/conf.d/

###########--------Windows 환경-------##########
$ C:\Program Files\datakit\conf.d


## 서로 다른 모니터링 도구를 사용하려면 서로 다른 conf 파일을 활성화해야 합니다. 한 가지 도구만 사용하는 경우 해당 conf 파일만 복사하여 활성화하면 됩니다. 이 문서에서는 ddtrace를 사용합니다.

#############----------skywalking----------###########
$ cd /traceSkywalking
$ cp traceSkywalking.conf.sample traceSkywalking.conf
#############----------skywalking----------###########

#############------------jaeger------------###########
$ cd /traceJaeger
$ cp traceJaeger.conf.sample traceJaeger.conf
#############------------jaeger------------###########

#############------------zipkin------------###########
$ cd /traceZipkin
$ cp traceZipkin.conf.sample traceZipkin.conf
#############------------zipkin------------###########

#############------------ddtrace------------###########
$ cd /ddtrace
$ cp ddtrace.conf.sample ddtrace.conf
#############------------zipkin------------###########

## 파일 복사 후 vim으로 편집 모드에 진입하여 inputs의 주석을 해제합니다.
## 예시: ddtrace    tags 관련 주석은 필요에 따라 활성화하여 비즈니스 또는 기타 관련 태그를 추가할 수 있습니다.

$ vim ddtrace.conf

$ [inputs.ddtrace]
$         path = "/v0.4/traces"
$ #       [inputs.ddtrace.tags]
$ #               tag1 = "tomcat"
$ #               tag2 = "tag2"
$ #               tag3 = "tag3"

$ wq!

## datakit 재시작
###########--------Linux 환경---------##########
$ datakit --restart

###########--------Windows 환경-------##########
## 마우스 우클릭 → 작업 관리자 → 서비스 → datakit → 다시 시작

Ddd.env: 사용자 정의 환경 유형    (선택 사항)
Ddd.service.name: 사용자 정의 애플리케이션 이름   (필수 항목)     이 설정 후에도 데이터가 표시되지 않으면 name을 제거해 보세요.
Ddd.agent.port: 데이터 업로드 포트(기본 9529) (필수 항목)
Ddd.version: 애플리케이션 버전 (선택 사항)
Ddd.trace.sample.rate: 샘플링 비율 설정(기본값은 전체 샘플링) (선택 사항)
Ddd.service.mapping: 현재 애플리케이션이 호출하는 redis, mysql 등에 이 매개변수로 별칭을 추가하여 다른 애플리케이션이 호출하는 redis, mysql과 구분할 수 있습니다. (선택 사항)
Ddd.host: 데이터 전송 대상 IP, 기본값은 로컬호스트 localhost (선택 사항)

$ cd /xxx/tomcat/bin
$ vim catalina.sh

$ CATALINA_OPTS="$CATALINA_OPTS -javaagent:/xxx/ddtrace.jar -Ddd.env=test -Ddd.service.name=demo001 -Ddd.agent.port=9529"; export CATALINA_OPTS

$ wq!

## tomcat 재시작
$ ./bin/startup.sh

## 원래 시작 스크립트:
$ nohup java -jar mall-admin.jar &

## ddtrace 시작 매개변수를 추가한 후의 시작 스크립트입니다. 다음 명령어를 실행하여 애플리케이션을 재시작합니다.
$ nohup java -javaagent:/xxx/dd-java-agent-0.72.0.jar -Ddd.service.name=mall-admin -Ddd.agent.port=9529 -jar mall-admin.jar &

$ vim Dockerfile

## Dockerfile에 ddtrace-agent 경로를 추가합니다. xxx는 절대 경로를 의미합니다.
$ ADD dd-java-agent-0.75.0.jar /xxx/  
$ ENTRYPOINT ["java","-javaagent:/xxx/dd-java-agent-0.75.0.jar","-Ddd.service.name=mall-admin","-Ddd.version=v1","-Ddd.env=product","-Ddd.agent.port=9529","-Ddd.agent.host=172.16.0.198","-jar", “-Dspring.profiles.active=prod","/mall-admin-1.0-SNAPSHOT.jar"]
$ wq!

## build & run
$ docker build -t mall/mall-admin:v1 .  [ “.” 은 반드시 추가해야 합니다.]

## docker run
$ docker run -p 8080:8080 --name mall-admin --link mysql:db --link redis:redis -v /etc/localtime:/etc/localtime -v /mydata/app/admin/logs:/var/logs -d mall/mall-admin:v1

## 원래 시작 명령어
$ docker run -p 8080:8080 --name mall-admin --link mysql:db --link redis:redis -v /etc/localtime:/etc/localtime -v /mydata/app/admin/logs:/var/logs -d mall/mall-admin:v1

## ddtrace를 포함한 시작 명령어입니다. dockerfile에서 jar 패키지의 시작 명령어를 확인해야 합니다.
$ docker run -p 8080:8080 --name mall-admin --link mysql:db --link redis:redis -v /etc/localtime:/etc/localtime -v /mydata/app/admin/logs:/var/logs -d mall/mall-admin:v1 java -javaagent:/wx/dd-java-agent-0.75.0.jar -Ddd.service.name=mall-admin -Ddd.version=v1 -Ddd.env=product -Ddd.agent.port=9529 -Ddd.agent.host=172.16.0.198 -jar -Dspring.profiles.active=prod /mall-admin-1.0-SNAPSHOT.jar

## 참고: java –javaagent를 추가한 후 시작 스크립트 뒤에 -jar your app name.jar를 추가해야 합니다.

## 내 PC 마우스 우클릭 → 속성 → 고급 시스템 설정 → 환경 변수
## 새 시스템 변수 생성 → 다음 내용 입력

DD_TRACE_AGENT_URL=http://localhost:9529    (필수 항목)
DD_ENV=   예시 test      (선택 사항)
DD_SERVICE=   예시 myappname     (필수 항목)
DD_VERSION=   예시 1.0     (선택 사항)
DD_TRACE_SERVICE_MAPPING=  예시 mysql:main-mysql-db    (선택 사항)

## TRACE_AGENT_URL은 데이터 업로드 IP와 포트로, http://localhost:9529로 입력해야 하며 변경하지 않는 것을 권장합니다.
## ENV는 시스템 환경으로, 필요에 따라 pro 또는 test 등으로 설정할 수 있습니다.
## SERVICE는 DF 플랫폼에 표시될 애플리케이션 이름을 설정하며, 구체적인 서비스 이름으로 설정할 수 있습니다.
## VERSION은 버전 번호로, 필요에 따라 설정할 수 있습니다.
## TRACE_SERVICE_MAPPING은 서비스 이름 재정의를 구성하여 DF 플랫폼에서 다른 비즈니스 시스템이 호출하는 구성 요소와 구분하여 표시하는 데 사용됩니다. [from-key]:[to-name] 형식의 매핑을 받습니다.
   참고: [from-key] 내용은 표준 필드(예: mysql, redis, mongodb, oracle)여야 하며, 사용자 정의 변경을 하지 마십시오.
   예시: TRACE_SERVICE_MAPPING=mysql:main-mysql-db
         TRACE_SERVICE_MAPPING=mongodb:offsite-mongodb-service

## IIS 서비스 중지
net stop /y was

## IIS 서비스 시작
net start w3svc

Debian 또는 Ubuntu
sudo dpkg -i ./datadog-dotnet-apm_<TRACER_VERSION>_amd64.deb && /opt/datadog/createLogPath.sh

CentOS 또는 Fedora
sudo rpm -Uvh datadog-dotnet-apm<TRACER_VERSION>-1.x86_64.rpm && /opt/datadog/createLogPath.sh

Alpine 또는 기타 musl 기반 배포판
sudo tar -xzf -C /opt/datadog datadog-dotnet-apm<TRACER_VERSION>-musl.tar.gz && sh /opt/datadog/createLogPath.sh

기타 배포판
sudo tar -xzf -C /opt/datadog datadog-dotnet-apm<TRACER_VERSION>-tar.gz && /opt/datadog/createLogPath.sh

export CORECLR_ENABLE_PROFILING=1
export CORECLR_PROFILER_PATH=/opt/datadog/Datadog.Trace.ClrProfiler.Native.so
export DD_INTEGRATIONS=/opt/datadog/integrations.json
export DD_DOTNET_TRACER_HOME=/opt/datadog
export DD_TRACE_AGENT_URL=http://localhost:9529
export DD_SERVICE=service_test
export CORECLR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}

## 원래 시작 스크립트:
$ java -jar mall-admin.jar

## ddtrace 시작 매개변수를 추가한 후의 시작 스크립트입니다. 다음 명령어를 실행하여 애플리케이션을 재시작합니다.
$ java -javaagent:/xxx/dd-java-agent-0.72.0.jar -Ddd.service.name=mall-admin -Ddd.agent.port=9529 -jar mall-admin.jar

$ cd /xxx/tomcat/bin
$ vim catalina.sh

$ CATALINA_OPTS="$CATALINA_OPTS -javaagent:/xxx/ddtrace.jar -Ddd.env=test -Ddd.service.name=demo001 -Ddd.agent.port=9529"; export CATALINA_OPTS

$ wq!

## tomcat 재시작
$ ./bin/startup.sh