- 重要な情報
- はじめに
- 用語集
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
コードを使用してトレーシングライブラリをセットアップし、APM データを収集するように Agent を構成した後、オプションで統合サービスタグ付けのセットアップなど、必要に応じてトレーシングライブラリを構成してください。
以下のすべてのコンフィギュレーションオプションには、同等のシステムプロパティと環境変数があります。 両方に同じキータイプが設定されている場合は、システムプロパティコンフィギュレーションが優先されます。 システムプロパティは、JVM フラグとして設定できます。
注: Java トレーサーのシステムプロパティを使用する場合は、JVM オプションとして読み込まれるように、-jar の前にリストされていることを確認してください。
dd.serviceDD_SERVICEunnamed-java-appdd.tagsDD_TAGSnulllayer:api,team:intake,key:valuedd.envDD_ENVnonedd.versionDD_VERSIONnulldd.logs.injectionDD_LOGS_INJECTIONtruedd.trace.configDD_TRACE_CONFIGnull-Ddd.trace.config=<ファイルパス>.properties 経由として、ファイルのサービス名に dd.service=<SERVICE_NAME> を設定して提供することができます。dd.service.mappingDD_SERVICE_MAPPINGnullmysql:my-mysql-service-name-db, postgresql:my-postgres-service-name-dbdd.writer.typeDD_WRITER_TYPEDDAgentWriterLoggingWriter で構成すると、トレースがコンソールに書き出されます。dd.agent.hostDD_AGENT_HOSTlocalhostdd.trace.agent.portDD_TRACE_AGENT_PORT8126receiver_port または DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、dd.trace.agent.port または dd.trace.agent.url はそれに合わせる必要があります。dd.trace.agent.unix.domain.socketDD_TRACE_AGENT_UNIX_DOMAIN_SOCKETnulldd.trace.agent.urlDD_TRACE_AGENT_URLnullreceiver_port または DD_APM_RECEIVER_PORT をデフォルトの 8126 以外に設定した場合、dd.trace.agent.port または dd.trace.agent.url をそれに合わせる必要があります。URL の値は、HTTP で接続する場合は http:// で始まり、Unixドメインソケットを使用する場合は unix:// で始まることができます。この設定は DD_AGENT_HOST と DD_TRACE_AGENT_PORT よりも優先されます。バージョン 0.65+ で利用可能です。dd.trace.agent.timeoutDD_TRACE_AGENT_TIMEOUT10dd.trace.header.tagsDD_TRACE_HEADER_TAGSnullCASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-Namehttp.request.headers.<header-name> と http.response.headers.<header-name> という形式のタグに自動的にマップされます。Ddd.trace.header.tags.legacy.parsing.enabled=true を追加するか、環境変数 DD_TRACE_HEADER_TAGS_LEGACY_PARSING_ENABLED=true を設定することで可能です。dd.trace.request_header.tagsDD_TRACE_REQUEST_HEADER_TAGSnullCASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-Namehttp.request.headers.<header-name> という形式のタグに自動的にマップされます。dd.trace.response_header.tagsDD_TRACE_RESPONSE_HEADER_TAGSnullCASE-insensitive-Header:my-tag-name,User-ID:userId,My-Header-And-Tag-Namehttp.response.headers.<header-name> という形式のタグに自動的にマップされます。dd.trace.header.baggageDD_TRACE_HEADER_BAGGAGEnullCASE-insensitive-Header:my-baggage-name,User-ID:userId,My-Header-And-Baggage-Namedd.trace.annotationsDD_TRACE_ANNOTATIONScom.some.Trace;io.other.Trace@Trace として処理するメソッドアノテーションのリスト。dd.trace.methodsDD_TRACE_METHODSnullpackage.ClassName[method1,method2,...];AnonymousClass$1[call];package.ClassName[*]@Trace の追加と似ていますが、コードの変更はありません。注: ワイルドカード型メソッドのサポート ([*]) は、コンストラクター、get アクセス操作子、set アクセス操作子、synthetic、toString、等号、ハッシュコード、またはファイナライザーメソッドのコールに対応しません。dd.trace.classes.excludeDD_TRACE_CLASSES_EXCLUDEnullpackage.ClassName,package.ClassName$Nested,package.Foo*,package.other.*dd.trace.partial.flush.min.spansDD_TRACE_PARTIAL_FLUSH_MIN_SPANS1000dd.trace.split-by-tagsDD_TRACE_SPLIT_BY_TAGSnullaws.servicedd.trace.db.client.split-by-instanceDD_TRACE_DB_CLIENT_SPLIT_BY_INSTANCEfalsetrue に設定すると、db スパンにインスタンス名がサービス名として割り当てられますdd.trace.health.metrics.enabledDD_TRACE_HEALTH_METRICS_ENABLEDtruetrue に設定すると、トレーサーヘルスメトリクスが送信されますdd.trace.health.metrics.statsd.hostDD_TRACE_HEALTH_METRICS_STATSD_HOSTdd.jmxfetch.statsd.host と同じdd.trace.health.metrics.statsd.portDD_TRACE_HEALTH_METRICS_STATSD_PORTdd.jmxfetch.statsd.port と同じdd.http.client.tag.query-stringDD_HTTP_CLIENT_TAG_QUERY_STRINGfalsetrue に設定すると、クエリ文字列パラメーターとフラグメントがウェブクライアントスパンに追加されますdd.http.client.error.statusesDD_HTTP_CLIENT_ERROR_STATUSES400-499dd.http.client.error.statuses=400-403,405,410-499dd.http.server.error.statusesDD_HTTP_SERVER_ERROR_STATUSES500-599dd.http.server.error.statuses=500,502-599dd.http.server.tag.query-stringDD_HTTP_SERVER_TAG_QUERY_STRINGtruetrue に設定すると、クエリ文字列パラメーターとフラグメントがウェブサーバースパンに追加されますdd.trace.enabledDD_TRACE_ENABLEDtruefalse トレースエージェントが無効の時dd.jmxfetch.enabledDD_JMXFETCH_ENABLEDtruedd.jmxfetch.config.dirDD_JMXFETCH_CONFIG_DIRnull/path/to/directory/etc/conf.dyaml ファイルの instance セクションの jvm_direct:true を探してコンフィギュレーションを変更します。dd.jmxfetch.configDD_JMXFETCH_CONFIGnullpath/to/file/conf.yaml,other/path/to/file/conf.yamlyaml ファイルの instance セクションの jvm_direct:true を探してコンフィギュレーションを変更します。dd.jmxfetch.check-periodDD_JMXFETCH_CHECK_PERIOD1500dd.jmxfetch.refresh-beans-periodDD_JMXFETCH_REFRESH_BEANS_PERIOD600dd.jmxfetch.statsd.hostDD_JMXFETCH_STATSD_HOSTagent.host と同じunix:///var/datadog-agent/dsd.socketdd.jmxfetch.statsd.portDD_JMXFETCH_STATSD_PORT8125dd.trace.obfuscation.query.string.regexpDD_TRACE_OBFUSCATION_QUERY_STRING_REGEXPnullhttp.url タグで報告されるリクエストのクエリ文字列から機密データを削除するための正規表現 (マッチした場合は dd.integration.opentracing.enabledDD_INTEGRATION_OPENTRACING_ENABLEDtruedd.hystrix.tags.enabledDD_HYSTRIX_TAGS_ENABLEDfalsedd.trace.servlet.async-timeout.errorDD_TRACE_SERVLET_ASYNC_TIMEOUT_ERRORtruedd.trace.startup.logsDD_TRACE_STARTUP_LOGStruefalse の場合は起動ログの収集が無効化されます。バージョン 0.64 以上で使用可能です。dd.trace.servlet.principal.enabledDD_TRACE_SERVLET_PRINCIPAL_ENABLEDfalsetrue の場合は、ユーザープリンシパルが収集されます。バージョン 0.61 以降で使用可能です。dd.instrumentation.telemetry.enabledDD_INSTRUMENTATION_TELEMETRY_ENABLEDtruetrue の場合、トレーサーはテレメトリーデータを収集します。バージョン 0.104+ で利用可能です。バージョン 0.115+ では true がデフォルトとなります。dd.trace.128.bit.traceid.generation.enabledDD_TRACE_128_BIT_TRACEID_GENERATION_ENABLEDfalsedd.trace.128.bit.traceid.logging.enabledDD_TRACE_128_BIT_TRACEID_LOGGING_ENABLEDfalse注:
両方に同じキータイプが設定された場合、システムプロパティコンフィギュレーションが優先されます。
システムプロパティは JVM パラメーターとして使用できます。
デフォルトで、アプリケーションからの JMX メトリクスは、DogStatsD によりポート 8125 で Datadog Agent に送信されます。DogStatsD が Agent に対して有効になっていることを確認してください。
DD_DOGSTATSD_NON_LOCAL_TRAFFIC が true に設定されていることと、Agent コンテナでポート 8125 が開いていることを確認してください。インテグレーションを無効にする方法については、インテグレーションの互換性セクションを参照してください。
dd.service.mappingシステムプロパティの例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.service.mapping=postgresql:web-app-pg -jar path/to/application.jar
dd.tagsスパンと JMX メトリクスにグローバルな env を設定:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -jar path/to/application.jar
dd.trace.span.tagsすべてのスパンに project:test を追加する例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -jar path/to/application.jar
dd.trace.jmx.tagsJMX メトリクスに custom.type:2 を設定:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -Ddd.trace.jmx.tags=custom.type:2 -jar path/to/application.jar
dd.trace.methodsシステムプロパティの例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.methods="hello.GreetingController[doSomeStuff,doSomeOtherStuff];hello.Randomizer[randomize]" -jar path/to/application.jar
dd.trace.db.client.split-by-instanceシステムプロパティの例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.env=dev -Ddd.service=web-app -Ddd.trace.db.client.split-by-instance=TRUE -jar path/to/application.jar
これで、DB インスタンス 1 である webappdb に、db.instance スパンのメタデータと同じサービス名が付けられます:
これで、DB インスタンス 2 である secondwebappdb に、db.instance スパンのメタデータと同じサービス名が付けられます:
同様に、サービスマップで、1 つの Web アプリが 2 つの異なる Postgres データベースに呼び出しを行っていることがわかります。
dd.http.server.tag.query-stringシステムプロパティの例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.http.server.tag.query-string=TRUE -jar path/to/application.jar
dd.trace.enabledシステムプロパティとデバッグアプリのモードの例:
java -javaagent:/path/to/dd-java-agent.jar -Ddd.trace.enabled=false -Ddatadog.slf4j.simpleLogger.defaultLogLevel=debug -jar path/to/application.jar
デバッグアプリのログに、Tracing is disabled, not installing instrumentations. と表示されます。
dd.jmxfetch.config.dir and dd.jmxfetch.config構成サンプル
DD_JMXFETCH_CONFIG_DIR=<ディレクトリパス> + DD_JMXFETCH_CONFIG=conf.yamlDD_JMXFETCH_CONFIG=<ディレクトリパス>/conf.yamlconf.yaml で以下の内容を使用します。
init_config:
instances:
- jvm_direct: true
port: '<PORT>'
conf:
- include:
bean:
- java.lang:type=MemoryPool,name=Metaspace
attribute:
Usage.used:
metric_type: gauge
alias: sb.usage.used
次の結果が生成されます。
JMX フェッチを使った Java メトリクス収集についての詳細は Java インテグレーションドキュメントを参照してください。
有効な値と以下のコンフィギュレーションオプションの使用に関する情報については、Java トレースコンテキストの伝播を参照してください。
dd.trace.propagation.style.injectDD_TRACE_PROPAGATION_STYLE_INJECTdatadogdd.trace.propagation.style.extractDD_TRACE_PROPAGATION_STYLE_EXTRACTdatadogdd.trace.propagation.styleDD_TRACE_PROPAGATION_STYLEdatadogdd.trace.propagation.style.inject と dd.trace.propagation.style.extract の構成が存在する場合は、そちらが優先されます。これらの b3 (B3 マルチヘッダーおよび B3 シングルヘッダーの両方) 用の抽出および挿入の設定は、バージョン 1.9.0. 以降、非推奨となっています。
dd.propagation.style.injectDD_PROPAGATION_STYLE_INJECTdatadogdd.propagation.style.extractDD_PROPAGATION_STYLE_EXTRACTdatadog
