Java

エージェントレスのログ送信は、以下の言語およびフレームワークでサポートされています。

• dd-trace-java >= 1.35.2 および Log4j2。

エージェントレスのログ送信を有効にし、構成するためには、次の環境変数を使用します。

JavaScript/TypeScript

Agentless ログ送信は、以下のトレーサーバージョンおよびログライブラリでサポートされています。

• dd-trace-js v4.48.0 or later (v4 リリースライン)、または dd-trace-js v5.24.0 or later (v5 リリースライン)。winston を使用。
• dd-trace-js v5.124.0 or later(v5 リリースライン)、または dd-trace-js v6.13.0 or later (v6 リリースライン)。pino または bunyan を使用。

エージェントレスのログ送信を有効にし、構成するためには、次の環境変数を使用します。

.NET

エージェントレスのログ送信は、以下の言語およびフレームワークでサポートされています。

• dd-trace-dotnet >= 2.50.0 および XUnit TestOutputHelper。

エージェントレスのログ送信を有効にし、構成するためには、次の環境変数を使用します。

Swift

ログ送信を有効にし、構成するためには、次の環境変数を使用します。

Python

要件: ddtrace >= 4.8.0。

ログ送信は pytest テストフレームワークでサポートされており、標準ライブラリの logging モジュールでログが出力される場合にのみ機能します。

エージェントレスモードでログ送信を有効にするには、次の環境変数を使用します。

エージェントレスモードの代わりに Datadog Agent を使用する場合は、環境で DD_LOGS_INJECTION=true を設定してください。

プロセス外ログ

別のプロセスがテストによってトリガーされたコードを実行する場合、そのログを関連付けるために、そのテストトレースの trace_id および span_id が必要です。ddtrace.testing.logs.DDTestLogsHandler (ddtrace >= 4.11.0) を使用して、それらのログレコードを元のテストトレースと関連付けた状態で Datadog ログインテークに送信します。

DDTestLogsHandlerは pytest プラグインと同じ環境変数を読み取り、バックエンド (エージェントレスまたは EVP プロキシ) を検出します。これは、それらの変数が利用可能なすべてのサブプロセスで使用できます。

Agentless モード (DD_CIVISIBILITY_AGENTLESS_ENABLED=true を設定):

Agent/EVP プロキシモード (デフォルト):

ワーカーごとのスレッド

テストワーカーごとに 1 つのスレッドを使用する場合は、ThreadLocalCorrelationFilter を使用して各スレッドのログレコードを正しいテストトレースに関連付けます。

import logging
from ddtrace.testing.logs import DDTestLogsHandler, ThreadLocalCorrelationFilter

with DDTestLogsHandler(service="my-service") as handler:
    correlation = ThreadLocalCorrelationFilter()
    handler.addFilter(correlation)
    logging.getLogger().addHandler(handler)

    while True:
        job = queue.get()  # queue and run_test are provided by your worker framework
        correlation.set_context(trace_id=job.trace_id, span_id=job.span_id)
        run_test(job.item)

DDTestLogsHandler は、コンテキストマネージャーとして使用されると、バッファリングされたレコードを自動的にフラッシュします。コンテキストマネージャー形式を使用しない場合は、handler.close() を呼び出してください。

Asyncio ワーカー

Asyncio ベースのワーカーの場合、スレッドローカルストレージは asyncio.Task 境界を越えて伝播しないため、ThreadLocalCorrelationFilter は Asyncio ベースのワーカーと互換性がありません。CorrelationFilter をサブクラス化し、代わりに contextvars.ContextVar を使用してください。イベントループが await 境界を越えて自動的に伝播します。

import asyncio
import contextvars
import logging
from ddtrace.testing.logs import CorrelationFilter, DDTestLogsHandler

class ContextVarCorrelationFilter(CorrelationFilter):
    def __init__(self):
        super().__init__()
        self._trace_id = contextvars.ContextVar("dd_trace_id", default=None)
        self._span_id = contextvars.ContextVar("dd_span_id", default=None)

    def set_context(self, trace_id, span_id):
        self._trace_id.set(trace_id)
        self._span_id.set(span_id)

    def get_trace_id(self):
        return self._trace_id.get()

    def get_span_id(self):
        return self._span_id.get()

async def run_one(job, correlation):
    correlation.set_context(trace_id=job.trace_id, span_id=job.span_id)
    await run_test(job.item)

async def main(jobs):
    with DDTestLogsHandler(service="my-service") as handler:
        correlation = ContextVarCorrelationFilter()
        handler.addFilter(correlation)
        logging.getLogger().addHandler(handler)
        await asyncio.gather(*(run_one(job, correlation) for job in jobs))

Ruby

Test Optimization を使用した Agentless ログ送信は、Rails アプリケーションでサポートされています。有効にする前に、 アプリケーションが Datadog トレースでインスツルメントされている ことを確認してください。

エージェントレスログ送信を使用するには、datadog-ci バージョン 0.16 以降が必要です。以下のログライブラリがサポートされています。

• activesupport >= 5.0 (ActiveSupport::TaggedLogging を使用している場合のみ)
• lograge >= 0.14
• semantic_logger >= 4.0

ログ送信を有効にするには、次の環境変数を使用します。

1. Datadog Agent を使用して ログ収集をセットアップ します。
2. ログとトレースの相関付け の手順に従ってください。