.NET トレーサーは、.NET Framework 4.5 以上の自動インスツルメンテーションをサポートします。サポート対象のライブラリについては、互換性要件ページをご覧ください。
次の手順に従って .NET アプリケーションのトレーシングを開始します。
IIS でホストされているアプリケーションのトレースを開始するには:
Windows Datadog Agent をインストールして構成します。
.NET トレーサー MSI インストーラーをダウンロードします。オペレーティングシステム (x64 または x86) に一致するアーキテクチャの MSI インストーラーを選択します。
管理者権限で .NET トレーサー MSI インストーラーを実行します。
管理者として次のコマンドに従って、IIS を停止してから起動します。
net stop /y was
net start w3svc
アプリケーションロードを作成します。
APM ライブトレースにアクセスします。
IIS に存在しない Windows アプリケーションの自動インスツルメンテーションを有効にするには、アプリケーションを起動する前に 2 つの環境変数を設定する必要があります。
| 名前 | 値 |
|---|---|
COR_ENABLE_PROFILING |
1 |
COR_PROFILER |
{846F5F1C-F9AE-4B07-969E-05C26BC060D8} |
Windows サービスを自動的にインスツルメントするには、COR_ENABLE_PROFILING および COR_PROFILER 環境変数を設定します。
Windows レジストリエディタで、HKLM\System\CurrentControlSet\Services\<SERVICE NAME> に Environment という複数の文字列値を作成します。
値データを次のように設定します。
COR_ENABLE_PROFILING=1
COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
または、次の PowerShell スニペットを使用して環境変数を設定することもできます。
add-env-var.ps1
[String[]] $v = @("COR_ENABLE_PROFILING=1", "COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}")
Set-ItemProperty HKLM:SYSTEM\CurrentControlSet\Services\<NAME> -Name Environment -Value $v
コンソールアプリケーションを自動的にインスツルメントするには、アプリケーションを起動する前に、バッチファイルから COR_ENABLE_PROFILING および COR_PROFILER 環境変数を設定します。
rem Set environment variables
SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={846F5F1C-F9AE-4B07-969E-05C26BC060D8}
rem Start application
example.exe
インスツルメントされたアプリケーションからトレースを受信するように Datadog Agent をインストールして構成します。デフォルトでは、Datadog Agent は datadog.yaml ファイルの apm_enabled: true で有効になっており、localhost:8126 でトレーストラフィックをリッスンします。コンテナ化環境の場合、アプリ内のクイックスタート手順に従って、Datadog Agent 内でトレース収集を有効にします。
確実に Datadog Agent の DD_SITE を に設定して、Agent が正しい Datadog の場所にデータを送信するようにします。
.NET アプリケーションでカスタムインスツルメンテーションを使用するには
Datadog.Trace NuGet パッケージをアプリケーションに追加します。Datadog.Trace.Tracer.Instance プロパティを介してグローバルトレーサーにアクセスし、新しいスパンを作成します。カスタムインスツルメンテーションとカスタムタグ付けの詳細については、.NET カスタムインスツルメンテーションを参照してください。
.NET トレーサーには、次のいずれかの方法で設定できるコンフィギュレーション設定があります。
環境変数を使ってトレーサーを構成するには、インスツルメンテーションされたアプリケーションを起動する前に変数を設定します。
例:
rem Set environment variables
SET DD_TRACE_AGENT_URL=http://localhost:8126
SET DD_ENV=prod
SET DD_SERVICE=MyService
SET DD_VERSION=abc123
rem Launch application
example.exe
HKLM\System\CurrentControlSet\Services\{service name}\Environment を使います。
アプリケーションコードでトレーサーを構成するには、デフォルトの構成ソースから TracerSettings インスタンスを作成します。Tracer コンストラクタに渡す前にこの TracerSettings インスタンスにプロパティを設定します。例:
トレーサーを作成する前に TracerSettings で設定する必要があります。トレーサーの作成後に TracerSettings プロパティに加えられた変更は無視されます。
using Datadog.Trace;
using Datadog.Trace.Configuration;
// デフォルトの構成ソースを読み取る (env vars、web.config、datadog.json)
var settings = TracerSettings.FromDefaultSources();
// 一部の設定を変更
settings.Environment = "prod";
settings.ServiceName = "MyService";
settings.ServiceVersion = "abc123";
settings.AgentUri = new Uri("http://localhost:8126/");
// この設定を使ってトレーサーを新規作成
var tracer = new Tracer(settings);
// グローバルトレーサーを設定
Tracer.Instance = tracer;
app.config または web.config ファイルを使ってトレーサーを構成するには、<appSettings> セクションを使います。例:
<configuration>
<appSettings>
<add key="DD_TRACE_AGENT_URL" value="http://localhost:8126"/>
<add key="DD_ENV" value="prod"/>
<add key="DD_SERVICE" value="MyService"/>
<add key="DD_VERSION" value="abc123"/>
</appSettings>
</configuration>
JSON ファイルを使ってトレーサーを構成するには、インスツルメンテーションされたアプリケーションのディレクトリに datadog.json を作成します。ルート JSON オブジェクトは各設定のキー/値を持つハッシュである必要があります。例:
{
"DD_TRACE_AGENT_URL": "http://localhost:8126",
"DD_ENV": "prod",
"DD_SERVICE": "MyService",
"DD_VERSION": "abc123",
}
上記の方法を使用して、次の変数を使用してトレースコンフィギュレーションをカスタマイズします。環境変数またはコンフィギュレーションファイルを設定するときは、環境変数の名前 (たとえば、DD_TRACE_AGENT_URL) を使用します。コードの設定を変更するときには、TracerSettings プロパティの名前 (たとえば、AgentUri) を使用します。
統合サービスタグ付けを使用するには、サービスに対して次の設定を構成します。
DD_ENVEnvironmentenv タグを追加します。バージョン 1.17.0 で追加されました。DD_SERVICEServiceNameDD_VERSIONServiceVersion自動インスツルメンテーションとカスタムインスツルメンテーションの両方で構成変数を利用できます。
DD_TRACE_AGENT_URLAgentUriDD_AGENT_HOST と DD_TRACE_AGENT_PORT をオーバーライドします。
デフォルト: http://<DD_AGENT_HOST>:<DD_TRACE_AGENT_PORT>DD_AGENT_HOSTDD_TRACE_AGENT_URL が設定されている場合は無視されます。localhostDD_TRACE_AGENT_PORTDD_TRACE_AGENT_URL が設定されている場合は無視されます。8126DD_LOGS_INJECTIONLogsInjectionEnabled DD_TRACE_DEBUGDebugEnabled true または false です。
デフォルト: falseDD_TRACE_HEADER_TAGSHeaderTags CASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-NameDD_TAGSGlobalTagslayer:api,team:intakeDD_TRACE_LOGGING_RATEx 秒ごとに一意のログ行が記述されます。たとえば、任意のメッセージを 60 秒ごとに一回ログに残したい場合は 60 を設定します。ログのレート制限を無効化したい場合は 0 を設定します。バージョン 1.24.0 で追加されました。デフォルトでは無効です。DD_TRACE_SERVICE_MAPPING[from-key]:[to-name] の形式で受け入れます。mysql:main-mysql-db, mongodb:offsite-mongodb-servicefrom-key はインテグレーションタイプに固有で、アプリケーション名のプレフィックスを除外する必要があります。たとえば、my-application-sql-server の名前を main-db に変更するには、sql-server:main-db を使用します。バージョン 1.23.0 で追加されました。構成変数は自動インスツルメンテーションの使用時にのみ利用できます。
DD_TRACE_ENABLEDTraceEnabledfalse に設定すると、CLR プロファイラーが完全に無効になります。他の構成メソッドの場合は、CLR プロファイラーはロードされ続けますが、トレースは生成されません。有効な値は true または false。
デフォルト: trueDD_TRACE_LOG_DIRECTORY%ProgramData%\Datadog .NET Tracer\logs\DD_TRACE_LOG_PATHDD_TRACE_LOG_DIRECTORY が設定されている場合、無視されます。DD_DISABLED_INTEGRATIONSDisabledIntegrationNames DD_HTTP_CLIENT_ERROR_STATUSES400-499DD_HTTP_SERVER_ERROR_STATUSES500-599DD_RUNTIME_METRICS_ENABLEDtrue または false です。バージョン 1.23.0 で追加されました。falseDD_TRACE_ADONET_EXCLUDED_TYPESAdoNetExcludedTypes AdoNet タイプ (たとえば、System.Data.SqlClient.SqlCommand) のリストを設定します。次の表に、自動インスツルメンテーションを使用しており、インテグレーションごとの設定が可能な場合にのみ使用できる構成変数を示します。
DD_TRACE_<INTEGRATION_NAME>_ENABLEDIntegrations[<INTEGRATION_NAME>].Enabled true (デフォルト) または false です。インテグレーション名は、インテグレーションセクションにリストされています。
デフォルト: true構成変数は現在利用可能な機能ですが、今後のリリースで変更される場合があります。
DD_TRACE_ROUTE_TEMPLATE_RESOURCE_NAMES_ENABLEDtrue に設定すると、Web スパンに対する改善されたリソース名を有効化します。利用可能なルートテンプレート情報を使用して ASP.NET のコアインテグレーションにスパンを追加し、追加のタグを有効化します。バージョン 1.26.0 で追加されました。falseDD_TRACE_PARTIAL_FLUSH_ENABLEDtrue または false。バージョン 1.26.0 で追加され、Datadog Agent 7.26.0 以降とのみ互換性を有しています。false
