コンテンツにスキップ

Nginx トレース

設定

対応バージョン

NGINX バージョン系統 nginx-datadog 対応バージョン範囲 確認済みの NGINX バージョン / 説明 推奨
1.31.* >= v1.17.0 1.31.0 を確認済み v1.17.0 以降を使用
1.30.* >= v1.16.0 1.30.0v1.16.0 から対応。1.30.1v1.17.0 から対応 v1.17.0+ を優先
1.29.* >= v1.8.0 1.29.01.29.8 を確認済み。一部の patch バージョンではより新しい nginx-datadog が必要 v1.17.0+ を優先
1.28.* >= v1.8.0 1.28.01.28.3 を確認済み。一部の patch バージョンではより新しい nginx-datadog が必要 v1.17.0+ を優先
1.27.* >= v1.8.0 1.27.01.27.5 を確認済み v1.17.0+ を優先
1.26.* >= v1.8.0 1.26.01.26.3 を確認済み v1.17.0+ を優先
1.25.* >= v1.0.1 1.25.0/1.25.1v1.0.1 から対応。1.25.2v1.0.2 から対応。1.25.3/1.25.4v1.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.2v0.3.4 から対応。1.23.3v0.5.3 から対応。1.23.4v0.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 をインストール

  • モジュールのパスを作成する
cd /usr/local/nginx
mkdir modules && cd $_
  • 展開する
root@root:/usr/local/nginx/modules$  tar xzvf ngx_http_datadog_module-<CPUアーキテクチャ>-<バージョン>.so.tgz

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 を有効にする
cd /usr/local/datakit/conf.d/ddtrace/
cp ddtrace.conf.sample ddtrace.conf
  • DataKit を再起動する
datakit service -R

フィードバック

このページは役に立ちましたか?