X-Amzn-Trace-Id を使用して Application Load Balancer リクエストをトレースする方法を教えてください。

最終更新日: 2021 年 2 月 3 日

Elastic Load Balancing (ELB) で Application Load Balancer によってリクエストが処理されると、トレース情報が X-Amzn-Trace-Id ヘッダーに追加されます。例:

X-Amzn-Trace-Id: Root=1-67891233-abcdef012345678912345678

記録したこの識別子を使用して、ロードバランサーの問題をトラブルシューティングすることができます。例えば、短い間に同じクライアントから同様のリクエストを多数受け取った場合に、X-Amzn-Trace-Id ヘッダーを使用して識別することができます。スタックに多数のレイヤーが存在する場合は、X-Amzn-Trace-Id ヘッダーを使用して、すべてのレイヤー間でリクエストを追跡することもできます。

X-Amzn-Trace-Id ヘッダーを記録するには、一般的なウェブサーバー設定 (Apache、Tomcat、NGINX、または IIS) 向けの次のステップを使用します。

Apache

1.    Apache 設定ファイル (Amazon Linux では /etc/httpd/conf/httpd.conf) を任意のテキストエディタで開きます。

2.    LogFormat セクションで、次のようにオプション %{X-Amzn-Trace-Id}i を追加します。

LogFormat "%{X-Forwarded-For}i %h %l %u %t \"%r\" %>s %b %D \"%{Referer}i\" \"%{User-Agent}i\" \"%{X-Amzn-Trace-Id}i\"" combined

3.    Apache サービスを再起動して、次のように変更を適用します。

sudo service apache restart

Tomcat

1.    Tomcat 設定ファイル (Amazon Linux では /etc/tomcat7/server.xml) を任意のテキストエディタで開きます。    

2.    org.apache.catalina.valves.AccessLogValve クラスで、次のようにオプション %{X-Amzn-Trace-Id}i を追加します。

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"

      prefix="localhost_access_log." suffix=".txt"

      pattern="%h %l %u %t &quot;%r&quot; %s %b %{X-Amzn-Trace-Id}i" />

3.    Tomcat サービスを再起動して、次のように変更を適用します。

sudo service tomcat7 restart

NGINX

1.    NGINX 設定ファイル (Amazon Linux では /etc/nginx/nginx.conf) を任意のテキストエディタで開きます。

2.    log_format セクションで、次のようにオプション $http_x_amzn_trace_id を追加します。

log_format  main  '"$http_x_forwarded_for" $remote_addr - $remote_user [$time_local] "$request" '

    '$status $body_bytes_sent "$http_referer" '

    '"$http_user_agent" "$http_x_amzn_trace_id"';

3.    Apache サービスを再起動して、次のように変更を適用します。

sudo service nginx restart

インターネットインフォメーションサービス (IIS)

1.    IIS Manager を開きます。

2.    サーバーの名前を選択します。

3.    [Logging] を選択します。

4.    [Select Fields (フィールドの選択)] を選択します。

5.    [Add Field] (フィールドの追加) を選択します。

6.    ダイアログボックスの [フィールド名] に、「X-Amzn-Trace-Id」と入力します。[ソースタイプ] に「リクエストヘッダー」と入力します。[送信元] に「X-Amzn-Trace-Id」と入力します。

7.    [Apply] (適用) を選択して変更を適用します。