Java トレーシングのインスツルメンテーションの説明に従い、Agent の 1.11.0 またはそれ以上のバージョンをインストールします。

また、jdbc-datasource インスツルメンテーションを有効にする必要があります。

以下のいずれかの方法で、データベースモニタリングの伝播機能を有効にします。

• システムプロパティ dd.dbm.propagation.mode=full を設定する
• 環境変数 DD_DBM_PROPAGATION_MODE=full を設定する

完全な例:

# 必要なシステムプロパティでJava Agentを起動します
java -javaagent:/path/to/dd-java-agent.jar -Ddd.dbm.propagation.mode=full -Ddd.integration.jdbc-datasource.enabled=true -Ddd.service=my-app -Ddd.env=staging -Ddd.version=1.0 -jar path/to/your/app.jar

アプリケーションで機能をテストします。

public class Application {
    public static void main(String[] args) {
        try {
            Connection connection = DriverManager
                    .getConnection("jdbc:postgresql://127.0.0.1/foobar?preferQueryMode=simple", "user", "password");
            Statement stmt = connection.createStatement();
            String sql = "SELECT * FROM foo";
            stmt.execute(sql);
            stmt.close();
            connection.close();
        } catch (SQLException exception) {
            //  例外ロジック
        }
    }
}

トレーサーバージョン 1.44 以上: Postgres でのプリペアドステートメントのトレースを有効にするには、以下のいずれかの方法を使用してください:

• システムプロパティ dd.dbm.trace_prepared_statements=true を設定する
• 環境変数 export DD_DBM_TRACE_PREPARED_STATEMENTS=true を設定する 

注: プリペアドステートメントのインスツルメンテーションは Application プロパティを上書きし、データベースへの追加の往復 (ラウンドトリップ) が発生します。この追加の往復はレイテンシーに与える影響がごくわずかです。

トレーサーバージョン 1.44 未満: Postgres と MySQL では、full モードでプリペアドステートメントはサポートされていません。そのため、プリペアドステートメントを使用するすべての JDBC API 呼び出しは自動的に service モードにダウングレードされます。ほとんどの Java SQL ライブラリはデフォルトでプリペアドステートメントを使用するため、ほとんどの Java アプリケーションは service モードのみを使用できることを意味します。

Gemfile 内で、dd-trace-rb をバージョン 1.8.0 以上にインストールまたは更新してください:

source 'https://rubygems.org'
gem 'datadog' # Use `'ddtrace', '>= 1.8.0'` if you're using v1.x

# 使用状況に応じて
gem 'mysql2'
gem 'pg'

以下のいずれかの方法を使用して、データベースモニタリングのプロパゲーション機能を有効にしてください:

1. 環境変数: DD_DBM_PROPAGATION_MODE=full

2. オプション comment_propagation (デフォルト: ENV['DD_DBM_PROPAGATION_MODE'])、mysql2 または pg 用:

    Datadog.configure do |c|
        c.tracing.instrument :mysql2, comment_propagation: 'full'
        c.tracing.instrument :pg, comment_propagation: 'full'
    end
   

完全な例:

require 'mysql2'
require 'ddtrace'

Datadog.configure do |c|
    c.service = 'billing-api'
    c.env = 'production'
    c.version = '1.3-alpha'

    c.tracing.instrument :mysql2, comment_propagation: ENV['DD_DBM_PROPAGATION_MODE']
end

client = Mysql2::Client.new(:host => "localhost", :username => "root")
client.query("SELECT 1;")

アプリ依存関係を更新して、dd-trace-py>=1.9.0 を含めてください:

pip install "ddtrace>=1.9.0"

psycopg2 をインストールします:

pip install psycopg2

次の環境変数を設定して、データベースモニタリングのプロパゲーション機能を有効にします:

• DD_DBM_PROPAGATION_MODE=full

完全な例:

import psycopg2

POSTGRES_CONFIG = {
"host": "127.0.0.1",
"port": 5432,
"user": "postgres_user",
"password": "postgres_password",
"dbname": "postgres_db_name",
}

# postgres DB に接続
conn = psycopg2.connect(**POSTGRES_CONFIG)
cursor = conn.cursor()
# SQL クエリを実行
cursor.execute("select 'blah'")
cursor.executemany("select %s", (("foo",), ("bar",)))

.NET Framework のトレース手順または .NET Core のトレース手順に従って、自動インスツルメンテーションパッケージをインストールし、サービスに対するトレースを有効にしてください。

サポートされるクライアントライブラリを使用していることを確認してください。例えば、Npgsql などです。

以下の環境変数を設定して、データベースモニタリングのプロパゲーション機能を有効にします:

• Postgres および MySQL: DD_DBM_PROPAGATION_MODE=full
• SQL Server: DD_DBM_PROPAGATION_MODE=service または Java と .NET のトレーサーで DD_DBM_PROPAGATION_MODE=full
• Oracle: DD_DBM_PROPAGATION_MODE=service

PHP トレーシングの説明に従って自動インスツルメンテーションパッケージをインストールし、サービスでトレーシングを有効にしてください。

サポートされているクライアントライブラリ (例: PDO など) を使用していることを確認してください。

次の環境変数を設定して、データベースモニタリングのプロパゲーション機能を有効にします:

• DD_DBM_PROPAGATION_MODE=full

dd-trace-js を 3.17.0 より新しいバージョン (あるいはサポート終了となった Node.js バージョン 12 を使用している場合は 2.30.0 以上) にインストールまたは更新してください:

npm install dd-trace@^3.17.0

コードを更新し、トレーサーをインポートして初期化してください:

// インスツルメンテーション対象のモジュールをインポートする前に、この行を必ず配置してください。
const tracer = require('dd-trace').init();

以下のいずれかの方法で、データベースモニタリングのプロパゲーション機能を有効にします:

• 環境変数を設定する

  DD_DBM_PROPAGATION_MODE=full
  

• トレーサーで dbmPropagationMode オプションを使用する (デフォルト値は ENV['DD_DBM_PROPAGATION_MODE'])

  const tracer = require('dd-trace').init({ dbmPropagationMode: 'full' })
  

• インテグレーションレベルのみで有効にする

  const tracer = require('dd-trace').init();
  tracer.use('pg', {
     dbmPropagationMode: 'full'
  })
  

完全な例:

const pg = require('pg')
const tracer = require('dd-trace').init({ dbmPropagationMode: 'full' })

const client = new pg.Client({
user: 'postgres',
password: 'postgres',
database: 'postgres'
})

client.connect(err => {
console.error(err);
process.exit(1);
});

client.query('SELECT $1::text as message', ['Hello world!'], (err, result) => {
// 結果を処理する
})