分散型トレーシング（APM）ベストプラクティス¶

###########--------Linux環境---------##########
$ cd /usr/local/datakit/conf.d/

###########--------Windows環境-------##########
$ C:\Program Files\datakit\conf.d


## 使用する監視ツールに応じて、異なるconfファイルを有効にする必要があります。1つだけを使用する場合は、対応する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