SQL ステートメントのタグ付け

このガイドでは、Database Monitoring を構成していることを前提にしています。

Datadog Database Monitoring (DBM) では、データベースホスト上で実行されている実行計画やクエリサンプルを表示することができます。このガイドでは、データベースクエリに SQL コメントとしてタグを追加する方法を説明します。

はじめに

対応データベース
Postgres、MySQL、SQL Server
サポート対象の Agent バージョン
7.36.1+
対応タグ形式
sqlcommenter、marginalia

手動タグ挿入

SQL ステートメントの実行をサポートする任意のデータベース API を使用して、sqlcommenter または marginalia 形式でフォーマットされたタグでステートメントにコメントを追加します。

/*key='val'*/ SELECT * from FOO

Separate multiple tags with commas:

/*key1='val1',key2='val2'*/ SELECT * from FOO

完全な例:

import (
    "database/sql"      
)

func main() {   
    db, err := sql.Open("postgres", "postgres://pqgotest:password@localhost/pqgotest?sslmode=disable")
    if err != nil {
        log.Fatal(err)
    }

    // key:val で SQL ステートメントをタグ付けします
    rows, err := db.Query("/*key='val'*/ SELECT * from FOO")
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()
}

DBM でタグを探る

On the Samples page, filter the Explain Plans and Query Samples views by custom tag.

カスタムタグで実行計画をフィルターします。

また、タグでフィルターした実行計画コストの時系列を表示することもできます。

カスタムタグによる実行計画コスト。

クエリを選択すると、カスタムタグは Sample Details ページの Propagated Tags に表示されます。

実行計画のカスタムタグを表示します。