Nginx トレース
設定¶
対応バージョン¶
| NGINX バージョン系統 | nginx-datadog 対応バージョン範囲 | 確認済みの NGINX バージョン / 説明 | 推奨 |
|---|---|---|---|
1.31.* |
>= v1.17.0 |
1.31.0 を確認済み |
v1.17.0 以降を使用 |
1.30.* |
>= v1.16.0 |
1.30.0 は v1.16.0 から対応。1.30.1 は v1.17.0 から対応 |
v1.17.0+ を優先 |
1.29.* |
>= v1.8.0 |
1.29.0 〜 1.29.8 を確認済み。一部の patch バージョンではより新しい nginx-datadog が必要 |
v1.17.0+ を優先 |
1.28.* |
>= v1.8.0 |
1.28.0 〜 1.28.3 を確認済み。一部の patch バージョンではより新しい nginx-datadog が必要 |
v1.17.0+ を優先 |
1.27.* |
>= v1.8.0 |
1.27.0 〜 1.27.5 を確認済み |
v1.17.0+ を優先 |
1.26.* |
>= v1.8.0 |
1.26.0 〜 1.26.3 を確認済み |
v1.17.0+ を優先 |
1.25.* |
>= v1.0.1 |
1.25.0/1.25.1 は v1.0.1 から対応。1.25.2 は v1.0.2 から対応。1.25.3/1.25.4 は v1.0.5 から対応。1.25.5 は後続バージョンで対応 |
v1.7.0+ を推奨、最新を優先 |
1.24.* |
v0.6.1 ~ v1.16.0 |
1.24.0 を確認済み。v1.16.1+ ではサポートを削除 |
最大 v1.16.0 |
1.23.* |
v0.3.4 / v0.5.3 / v0.6.1 ~ v1.6.2 |
1.23.2 は v0.3.4 から対応。1.23.3 は v0.5.3 から対応。1.23.4 は v0.6.1 から対応 |
v1.6.2 に固定するか、自前で build |
1.22.* |
v0.3.4 ~ v1.6.2 |
1.22.1 を確認済み |
v1.6.2 に固定するか、自前で build |
1.19.* |
v0.1.0 ~ v1.6.2 |
1.19.1 のみ確認済み |
その他の 1.19.x は assets を確認するか、自前で build |
1.18.* |
v0.1.0 ~ v1.6.2 |
1.18.0-alpine のみ確認済み |
alpine 以外または他の patch は assets を確認するか、自前で build |
1.14.* |
v0.5.2 ~ v1.6.2 |
1.14.1 のみ確認済み |
その他の 1.14.x は assets を確認するか、自前で build |
Nginx の設定¶
Tracing モジュールをダウンロード¶
https://github.com/DataDog/nginx-datadog/releases にアクセスし、Assets から現在の CPU アーキテクチャとバージョンに一致するモジュール ngx_http_datadog_module-<CPUアーキテクチャ>-<バージョン>.so.tgz を探してダウンロードする
Tracing をインストール¶
- モジュールのパスを作成する
- 展開する
Nginx の設定¶
/usr/local/nginx/conf/nginx.conf に以下を追加する:
# モジュールを読み込む
load_module modules/ngx_http_datadog_module.so;
worker_processes 1;
events {
worker_connections 1024;
}
http {
# Datakit の URL を設定
datadog_agent_url http://localhost:9529;
# サービス名を設定
datadog_service_name nginx-demo;
# 環境名を設定
datadog_environment test;
# バージョン名を設定
datadog_version 1.0.0;
# サンプリング率を設定 0-1.0
datadog_sample_rate 1.0;
# タグを設定
datadog_tag foo bar;
include mime.types;
default_type application/octet-stream;
# $datadog_trace_id と $datadog_span_id を使ってログに trace_id と span_id を追加する。どちらも 16 進数
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
'$status $body_bytes_sent "$http_referer" '
'"$http_user_agent" "$http_x_forwarded_for"'
'"$datadog_trace_id" "$datadog_span_id"';
access_log logs/access.log main;
sendfile on;
keepalive_timeout 65;
server {
listen 80;
server_name localhost;
location / {
root html;
index index.html index.htm;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
}
Nginx を再起動¶
省略
DataKit の収集を有効化¶
ddtraceを有効にする
- DataKit を再起動する