App Analytics は、Java トレースクライアントのバージョン 0.25.0 以降で使用できます。トレースクライアントでコンフィギュレーションパラメーターを 1 つ設定することで、すべての web サーバーインテグレーションに対してグローバルに有効にすることができます。

• システムプロパティ: -Ddd.trace.analytics.enabled=true

App Analytics は Python トレーシング クライアント バージョン 0.19.0 以降で利用できます。この構成は ddtrace バージョン 3.x 以前でのみ利用可能です。Tracing Client の 1 つの構成パラメーターで、すべての web 統合に対して App Analytics をグローバルに有効化できます:

• トレーサー構成: ddtrace.config.analytics_enabled = True

App Analyticsは、Ruby トレースクライアントのバージョン 0.19.0 以降で使用できます。グローバルフラグを使用することで、すべての web インテグレーションに対して有効にできます。

これを行うには、環境で DD_TRACE_ANALYTICS_ENABLED=true を設定するか、次のように構成します。

Datadog.configure { |c| c.tracing.analytics.enabled = true }

• true は、すべての Web フレームワークで分析を有効にします。
• false または nil は、明示的に有効にされているインテグレーションを除いて分析を無効にします。(デフォルト)

App Analyticsは、Go トレースクライアントのバージョン 1.11.0 以降で使用できます。以下を使用することで、すべての web インテグレーションにグローバルに有効化できます:

• WithAnalytics (v1 ドキュメント) トレーサー起動オプション。例:

  tracer.Start(tracer.WithAnalytics(true))
  

• バージョン 1.26.0 以降は、環境変数 DD_TRACE_ANALYTICS_ENABLED=true を使用

App Analytics は、Node.js トレースクライアントのバージョン 0.10.0 以降で使用できます。トレースクライアントでコンフィギュレーションパラメーターを 1 つ設定することで、すべての web インテグレーションに対してグローバルに有効できます。

tracer.init({
  analytics: true
})

次のコンフィギュレーションパラメーターを使用することもできます。

App Analytics は、.NET トレースクライアントのバージョン 1.1.0 以降で使用できます。トレースクライアントでコンフィギュレーションパラメーターを 1 つ設定することで、すべての web インテグレーションに対してグローバルに有効にできます。

• 環境変数または AppSetting: DD_TRACE_ANALYTICS_ENABLED=true

これは、コードでも設定できます。

Tracer.Instance.Settings.AnalyticsEnabled = true;

App Analytics は、PHP トレースクライアントのバージョン 0.17.0 以降で使用できます。トレースクライアントでコンフィギュレーションパラメーターを 1 つ設定することで、すべての web インテグレーションに対してグローバルに有効にできます。

App Analytics は、C++ トレースクライアントのバージョン 1.0.0 以降で使用できます。環境変数 DD_TRACE_ANALYTICS_ENABLED を true に設定することで、すべてのサービスエントリスパンに対してグローバルに有効にすることができます。注: この設定は、コードで直接設定することもできます。

datadog::opentracing::TracerOptions tracer_options;
  tracer_options.agent_host = "dd-agent";
  tracer_options.service = "<サービス名>";
  tracer_options.analytics_rate = 1.0;
  auto tracer = datadog::opentracing::makeTracer(tracer_options);

Nginx で App Analytics を有効にするには

1. 環境変数 DD_TRACE_ANALYTICS_ENABLED を true に設定します。

2. nginx.conf ファイルの先頭に env DD_TRACE_ANALYTICS_ENABLED; を追加します。

グローバルに設定するほか、次の設定を使用して個々のインテグレーションに対して App Analytics を有効または無効にすることも可能です。

• システムプロパティ: -Ddd.<integration>.analytics.enabled=true
• 環境変数: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

カスタムサービスを送信するインテグレーションに対し、グローバルコンフィギュレーションに加えて上記を使用します。例えば、カスタムサービスとして送信される JMS スパンの場合、次のように設定して App Analytics ですべての JMS トレースを有効にします。

• システムプロパティ: -Ddd.jms.analytics.enabled=true
• 環境変数: DD_JMS_ANALYTICS_ENABLED=true

インテグレーション名は、インテグレーションテーブルにあります。

グローバルに設定するほか、次の設定を使用して個々のインテグレーションに対して App Analytics を有効または無効にすることも可能です。

• トレーサー構成: ddtrace.config.<INTEGRATION>.analytics_enabled = True
• 環境変数: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

カスタムサービスを送信するインテグレーションに対し、グローバルコンフィギュレーションに加えて上記を使用します。例えば、カスタムサービスとして送信される Boto スパンの場合、次のように設定して App Analytics ですべての Boto トレースを有効にします。

• トレーサー構成: ddtrace.config.boto.analytics_enabled = True
• 環境変数: DD_BOTO_ANALYTICS_ENABLED=true

注: インテグレーションによっては、そのインテグレーション固有のトレーサーが実装されているため非標準の方法で設定する必要があります。詳細については、App Analytics のライブラリドキュメントを参照してください。

特定のインテグレーションに対して App Analytics を有効にすることできます。

それには、環境で DD_<INTEGRATION>_ANALYTICS_ENABLED=true を設定するか、以下の構成を使用します。

Datadog.configure { |c| c.tracing.instrument :integration, analytics_enabled: true }

integration は、インテグレーションの名前です。オプションについては、インテグレーションのリストを参照してください。

• true は、グローバル設定に関係なく、このインテグレーションで分析を有効にします。
• false は、グローバル設定に関係なく、このインテグレーションで分析を無効にします。
• nil は、グローバルな分析設定を優先させます。

Note: This documentation uses v2 of the Go tracer, which Datadog recommends for all users. If you are using v1, see the migration guide to upgrade to v2.

グローバル設定に加えて、各インテグレーションで App Analytics を個別に有効または無効にできます。たとえば、標準ライブラリの net/http パッケージを構成する場合は、以下のようにします。

package main

import (
    httptrace "github.com/DataDog/dd-trace-go/contrib/net/http/v2"
    "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
)

func main() {
    tracer.Start()
    defer tracer.Stop()

    mux := httptrace.NewServeMux(httptrace.WithAnalytics(true))
    // ...
}

グローバル設定に加えて、個別のインテグレーションで App Analytics を有効または無効にできます。

たとえば、express で App Analytics を有効にするには、以下のようにします。

tracer.use('express', {
  analytics: true
})

インテグレーション名は、インテグレーションテーブルにあります。

グローバル設定に加えて、個別のインテグレーションで App Analytics を有効または無効にできます。

• 環境変数または AppSetting: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

コードの場合は次のようになります。

Tracer.Instance.Settings.Integrations["<INTEGRATION>"].AnalyticsEnabled = true;

たとえば、ASP.NET MVC で App Analytics を有効にするには、以下のようにします。

• 環境変数または AppSetting: DD_ASPNETMVC_ANALYTICS_ENABLED=true

コードの場合は次のようになります。

Tracer.Instance.Settings.Integrations["AspNetMvc"].AnalyticsEnabled = true;

インテグレーション名は、インテグレーションテーブルにあります。注: Linux では、環境変数の名前は大文字と小文字が区別されます。

グローバルに設定するほか、次の設定を使用して個々のインテグレーションに対して App Analytics を有効または無効にすることも可能です。

• 環境変数: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

カスタムサービスを送信するインテグレーションに対し、グローバルコンフィギュレーションに加えて上記を使用します。例えば、カスタムサービスとして送信される Symfony スパンの場合、次のように設定して App Analytics ですべての Symfony トレースを有効にします。

• 環境変数: DD_SYMFONY_ANALYTICS_ENABLED=true

インテグレーション名は、インテグレーションテーブルにあります。

デフォルトでは、App Analytics はデータベーストレースをキャプチャしないため、各インテグレーションに対して手動で収集を有効にする必要があります。例:

• システムプロパティ: -Ddd.jdbc.analytics.enabled=true
• 環境変数: DD_JDBC_ANALYTICS_ENABLED=true

デフォルトでは、App Analytics はデータベーストレースをキャプチャしないため、各インテグレーションに対して手動で収集を有効にする必要があります。例:

• トレーサーコンフィギュレーション: ddtrace.config.psycopg.analytics_enabled = True
• 環境変数: DD_PSYCOPG_ANALYTICS_ENABLED=true

デフォルトでは、App Analytics はデータベーストレースをキャプチャしないため、各インテグレーションに対して手動で収集を有効にする必要があります。例:

Datadog.configure { |c| c.tracing.instrument :mongo, analytics_enabled: true }

デフォルトでは、データベーストレースは App Analytics によりキャプチャされません。各インテグレーションに対し手動で収集を有効にする必要があります。例:

// Analytics が有効になっているデータベースドライバーを登録します。sqltrace.Register("mysql", &mysql.MySQLDriver{}, sqltrace.WithAnalytics(true))

デフォルトでは、App Analytics はデータベーストレースをキャプチャしないため、各インテグレーションに対して手動で収集を有効にする必要があります。例:

tracer.use('mysql', {
  analytics: true
})

デフォルトでは、App Analytics はデータベーストレースをキャプチャしないため、各インテグレーションに対して手動で収集を有効にする必要があります。例えば、ADO.NET に対して App Analytics を有効にするには以下のようにします。

• 環境変数または AppSetting: DD_AdoNet_ANALYTICS_ENABLED=true

コードの場合は次のようになります。

Tracer.Instance.Settings.Integrations["AdoNet"].AnalyticsEnabled = true;

インテグレーション名は、インテグレーションテーブルにあります。注: Linux では、環境変数の名前は大文字と小文字が区別されます。

デフォルトでは、App Analytics はデータベーストレースをキャプチャしません。次の設定を使用して、個々のインテグレーションに対し App Analytics を有効または無効にすることができます。

• 環境変数: DD_<INTEGRATION>_ANALYTICS_ENABLED=true

カスタムサービスを送信するインテグレーションに対し、グローバルコンフィギュレーションに加えて上記を使用します。mysqli の場合、次のようになります。

• 環境変数: DD_MYSQLI_ANALYTICS_ENABLED=true

インテグレーション名は、インテグレーションテーブルにあります。

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで ANALYTICS_SAMPLE_RATE タグを設定することで App Analytics を有効にできます。

import datadog.trace.api.DDTags;
import datadog.trace.api.Trace;
import io.opentracing.Tracer;
import io.opentracing.util.GlobalTracer;

class MyClass {
  @Trace
  void myMethod() {
    final Span span = GlobalTracer.get().activeSpan();
    // @Trace アノテーションにより送信されるスパン。
    if (span != null) {
      span.setTag(DDTags.SERVICE, "<SERVICE_NAME>");
      span.setTag(DDTags.ANALYTICS_SAMPLE_RATE, 1.0);
    }
  }
}

注: dd.trace.methods または trace annotations スパン向けの App analytics は、-Ddd.trace-annotation.analytics.enabled=true の設定により有効化することができます。

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで ddtrace.constants.ANALYTICS_SAMPLE_RATE_KEY タグを設定することで App Analytics を有効にできます。

from ddtrace import tracer
from ddtrace.constants import ANALYTICS_SAMPLE_RATE_KEY

@tracer.wrap()
def my_method():
    span = tracer.current_span()
    span.set_tag(ANALYTICS_SAMPLE_RATE_KEY, True)

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで Analytics::TAG_ENABLED タグを設定することで App Analytics を有効にできます。

Datadog::Tracing.trace('my.task') do |span|
  # 分析サンプリングレートを 1.0 に設定します
  span.set_tag(Datadog::Tracing::Metadata::Ext::Analytics::TAG_ENABLED, true)
end

カスタムインスツルメンテーションの場合、以下に示すように、スパンで App Analytics を有効にするための特別なタグが追加されています。

span.SetTag(ext.AnalyticsEvent, true)

これにより、スパンが App Analytics イベントとしてマークされます。

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで ANALYTICS タグを設定することで App Analytics を有効にできます。

const { ANALYTICS } = require('dd-trace/ext/tags')

span.setTag(ANALYTICS, true)

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで Tags.Analytics タグを設定することで App Analytics を有効にできます。

using Datadog.Trace;

using(var scope = Tracer.Instance.StartActive("web.request"))
{
    // このスパンで Analytics を有効にします
    scope.span.SetTag(Tags.Analytics, "true");
}

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで ANALYTICS_KEY タグを設定することで App Analytics を有効にできます。

<?php
  // ... App Analytics を有効にする既存のスパン
  $span->setTag(Tag::ANALYTICS_KEY, true);
?>

カスタムインスツルメンテーションを使用するアプリケーションは、スパンで analytics_event タグを設定することで App Analytics を有効にできます。

...
#include <datadog/tags.h>
...
auto tracer = ...
auto span = tracer->StartSpan("operation_name");
// true のブール値はスパンに対して App Analytics を有効にします
//（サンプルレートは 1.0）。
span->SetTag(datadog::tags::analytics_event, true);
// 0.0～1.0 のダブル値は App Analytics を有効にし、
//サンプルレートを指定された値に設定します。
span->SetTag(datadog::tags::analytics_event, 0.5);