注: CommandType.StoredProcedure は .NET ドライバーではサポートされていません。

注: CommandType.StoredProcedure は .NET ドライバーではサポートされていません。

注: Aurora MySQL の完全伝播モードにはバージョン 3 が必要です。

注: CommandType.StoredProcedure は .NET ドライバーではサポートされていません。

Java と .NET の full モードの場合:

• インスツルメンテーションは、クライアントがクエリを発行する際に SET context_info コマンドを実行し、これによりデータベースとの追加のラウンドトリップが発生します。
• 前提条件:
  • Agent バージョン 7.55.0 以降
  • Java トレーサーバージョン 1.39.0 以降
  • .NET トレーサーバージョン 3.3 以降

Java の full モードの場合:

• このインスツルメンテーションは V$SESSION.ACTION を上書きします。
• 前提条件: Java トレーサー 1.45 以降

アプリの依存関係を更新して、dd-trace-go v2 を含むようにします。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.

go get github.com/DataDog/dd-trace-go/v2 # 2.x

contrib/database/sql パッケージをインポートするようにコードを更新します。

import (
   "database/sql"
   "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
   sqltrace "github.com/DataDog/dd-trace-go/contrib/database/sql/v2"
)

以下のいずれかの方法で、Database Monitoring の伝播機能を有効にします。

• 環境変数: DD_DBM_PROPAGATION_MODE=full

• ドライバー登録時にコードを使用する:

  sqltrace.Register("postgres", &pq.Driver{}, sqltrace.WithDBMPropagation(tracer.DBMPropagationModeFull), sqltrace.WithService("my-db-service"))
  

• sqltrace.Open でコードを使用する:

  sqltrace.Register("postgres", &pq.Driver{}, sqltrace.WithService("my-db-service"))
  
  db, err := sqltrace.Open("postgres", "postgres://pqgotest:password@localhost/pqgotest?sslmode=disable", sqltrace.WithDBMPropagation(tracer.DBMPropagationModeFull))
  if err != nil {
      log.Fatal(err)
  }
  

完全な例:

import (
	"database/sql"
	"github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
   sqltrace "github.com/DataDog/dd-trace-go/contrib/database/sql/v2"
)

func main() {
	// The first step is to set the dbm propagation mode when registering the driver. Note that this can also
	// be done on sqltrace.Open for more granular control over the feature.
	sqltrace.Register("postgres", &pq.Driver{}, sqltrace.WithDBMPropagation(tracer.DBMPropagationModeFull))

	// Followed by a call to Open.
	db, err := sqltrace.Open("postgres", "postgres://pqgotest:password@localhost/pqgotest?sslmode=disable")
	if err != nil {
		log.Fatal(err)
	}

	// Then, we continue using the database/sql package as we normally would, with tracing.
	rows, err := db.Query("SELECT name FROM users WHERE age=?", 27)
	if err != nil {
		log.Fatal(err)
	}
	defer rows.Close()
}

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

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

以下のいずれかの方法で、Database Monitoring の伝播機能を有効にします。

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

完全な例:

# Start the Java Agent with the required system properties
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) {
            //  exception logic
        }
    }
}

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

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

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

トレーサーのバージョンが 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

# Depends on your usage
gem 'mysql2'
gem 'pg'

以下のいずれかの方法で、Database Monitoring の伝播機能を有効にします。

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"

Postgres の場合は、psycopg2 をインストールします。

pip install psycopg2

MongoDB の場合は、pymongo をインストールします。

pip install pymongo

注: MongoDB のサポートには dd-trace-py 3.5.0 以上が必要です。アップグレードが必要な場合: pip install "ddtrace>=3.5.0"。

以下の環境変数を設定して、Database Monitoring の伝播機能を有効にします。

• DD_DBM_PROPAGATION_MODE=full

Postgres の例:

import psycopg2

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

# connect to postgres db
conn = psycopg2.connect(**POSTGRES_CONFIG)
cursor = conn.cursor()
# execute sql queries
cursor.execute("select 'blah'")
cursor.executemany("select %s", (("foo",), ("bar",)))

MongoDB の例:

from pymongo import MongoClient

# Connect to MongoDB
client = MongoClient('mongodb://localhost:27017/')
db = client['test_database']
collection = db['test_collection']

# Insert a document
collection.insert_one({"name": "test", "value": 1})

# Query documents
results = collection.find({"name": "test"})
for doc in results:
    print(doc)

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

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

以下の環境変数を設定して、Database Monitoring の伝播機能を有効にします。

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

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

サポートされているクライアントライブラリを使用していることを確認します。たとえば、PDO です。

以下の環境変数を設定して、Database Monitoring の伝播機能を有効にします。

• DD_DBM_PROPAGATION_MODE=full

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

npm install dd-trace@^3.17.0

トレーサーをインポートして初期化するようにコードを更新します。

// This line must come before importing any instrumented module.
const tracer = require('dd-trace').init();

以下のいずれかの方法で、Database Monitoring の伝播機能を有効にします。

• 以下の環境変数を設定します:

  DD_DBM_PROPAGATION_MODE=full
  

• SDK を 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) => {
	// handle result
})