Application Real-Time Monitoring Service:Python アプリケーションのログとトレース ID の関連付け

クイックスタート

3 つの環境変数を設定し、アプリケーションを再起動します。

export OTEL_PYTHON_LOG_CORRELATION=true
export OTEL_PYTHON_LOG_LEVEL=info
export OTEL_PYTHON_LOG_FORMAT='%(asctime)s %(levelname)s [%(name)s] [%(filename)s:%(lineno)d] [trace_id=%(otelTraceID)s span_id=%(otelSpanID)s resource.service.name=%(otelServiceName)s trace_sampled=%(otelTraceSampled)s] - %(message)s'

アプリケーションの再起動後、トレースされたリクエスト内で生成される各ログ行には、トレースコンテキストが含まれます。

2026-03-10 14:30:00,123 INFO [my_app] [app.py:42] [trace_id=ac1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6 span_id=1a2b3c4d5e6f7a8b resource.service.name=my-python-app trace_sampled=True] - Order created successfully

SLS との連携や検証を含む完全な設定については、以降のセクションに進んでください。

前提条件

• ARMS によってモニタリングされている Python アプリケーション。 詳細については、「Python アプリケーションのモニタリング」をご参照ください。

• SLS を通じて収集されるアプリケーションログ。 詳細については、「データ収集の概要」をご参照ください。

SLS と ARMS の連携

SLS プロジェクトと Logstore を ARMS に連携させることで、コンソールでトレースとログを関連付けることができます。

1. ARMS コンソールにログインします。

2. 左側のナビゲーションウィンドウで、[アプリケーションモニタリング] > [アプリケーションリスト] を選択します。

3. 上部のナビゲーションバーでリージョンを選択し、対象のアプリケーションをクリックします。

   説明

   [言語] 列のアイコンは、プログラミング言語を示します。 - : Java - : Go - : Python - - (ハイフン)： OpenTelemetry 向けマネージドサービスでモニタリングされているアプリケーション

4. 上部のナビゲーションバーで、[構成] > [カスタム構成] を選択します。

5. [アプリケーションログの関連付け設定] セクションで、[ログソース] を [ログサービス SLS] に設定します。 SLS がデプロイされているリージョンを選択し、プロジェクトと Logstore を連携させます。

   

トレースとログの相関付けの有効化

3 つの環境変数を設定して、トレースコンテキストのインジェクションを有効にし、ログフォーマットを定義します。

環境変数の設定

アプリケーションを起動する前に、次の環境変数を設定します。

export OTEL_PYTHON_LOG_CORRELATION=true
export OTEL_PYTHON_LOG_LEVEL=info
export OTEL_PYTHON_LOG_FORMAT='%(asctime)s %(levelname)s [%(name)s] [%(filename)s:%(lineno)d] [trace_id=%(otelTraceID)s span_id=%(otelSpanID)s resource.service.name=%(otelServiceName)s trace_sampled=%(otelTraceSampled)s] - %(message)s'

アプリケーションの起動後、ログ出力にトレースコンテキストが含まれるようになります。

import os
import logging

# 環境変数からフォーマット文字列を読み取ります
log_format = os.getenv('OTEL_PYTHON_LOG_FORMAT')

# トレースコンテキストフィールドを持つカスタムハンドラを作成します
my_handler = logging.StreamHandler()
formatter = logging.Formatter(log_format)
my_handler.setFormatter(formatter)

# ハンドラをロガーにアタッチします
logger = logging.getLogger('my_module')
logger.addHandler(my_handler)
logger.setLevel(logging.INFO)

from opentelemetry import trace
import structlog

def add_otel_context(logger, method, event_dict):
    span = trace.get_current_span()
    ctx = span.get_span_context()
    if ctx.is_valid:
        event_dict['trace_id'] = format(ctx.trace_id, '032x')
        event_dict['span_id'] = format(ctx.span_id, '016x')
    return event_dict

structlog.configure(
    processors=[
        add_otel_context,
        structlog.processors.JSONRenderer(),
    ]
)

ログ収集の設定 (任意)

ARMS の Python エージェントは、ログレコードへのトレースコンテキストフィールドのインジェクションのみを担当します。 アプリケーションログの収集や転送は行いません。 アプリケーションログは SLS によって直接収集されるため、OpenTelemetry コンソールへの追加のレポートは不要です。

ARMS コンソールで関連付けられたログを表示するには、アプリケーションからログを収集し、「SLS と ARMS の連携」で連携した SLS プロジェクトおよび Logstore に配信するように SLS を設定します。

SLS のログ収集の詳細については、「データ収集の概要」をご参照ください。

設定の確認

1. アプリケーションにテストリクエストを送信します。

2. アプリケーションのログ出力を確認します。 トレースされたリクエスト内で生成される各ログ行には、ゼロ以外の trace_id 値が含まれています。

      2026-03-10 14:30:00,123 INFO [my_app] [app.py:42] [trace_id=ac1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6 span_id=1a2b3c4d5e6f7a8b resource.service.name=my-python-app trace_sampled=True] - Order created successfully

3. ARMS コンソールで、リクエストのトレース詳細ページを開き、関連付けられたログに正しいトレース ID が表示されていることを確認します。