By default, probes are not available, so you will need to explicitly tell the configure script to make the probes available in <productname>PostgreSQL</productname>. To include DTrace support specify <option>&#45;-enable-dtrace</option> to configure. See <xref linkend="configure-options-devel"/> for further information. デフォルトではプローブは利用ないので、configureスクリプトに明示的にプローブをPostgreSQLで利用可能にするように指示する必要があります。 DTraceサポートを含めるには、configureに--enable-dtraceを指定します。 詳細は17.3.3.6を参照してください。

A number of standard probes are provided in the source code, as shown in <xref linkend="dtrace-probe-point-table"/>; <xref linkend="typedefs-table"/> shows the types used in the probes. More probes can certainly be added to enhance <productname>PostgreSQL</productname>'s observability. 表 27.49で示されるように、多くの標準的なプローブがソースコード内で提供されています。表 27.50はプローブで使用している型を示しています。 また、PostgreSQL内の可観測性を強化するためのプローブ追加が可能です。

The example below shows a DTrace script for analyzing transaction counts in the system, as an alternative to snapshotting <structname>pg_stat_database</structname> before and after a performance test: 以下の例では、性能試験前後でpg_stat_databaseのスナップショットを取る代わりに、システムにおけるトランザクション数を解析するDTraceスクリプトを示します。

#!/usr/sbin/dtrace -qs

postgresql$1:::transaction-start
{
      @start["Start"] = count();
      self->ts  = timestamp;
}

postgresql$1:::transaction-abort
{
      @abort["Abort"] = count();
}

postgresql$1:::transaction-commit
/self->ts/
{
      @commit["Commit"] = count();
      @time["Total time (ns)"] = sum(timestamp - self->ts);
      self->ts=0;
}

When executed, the example D script gives output such as: 実行すると、例のDスクリプトは以下のような出力をします。

# ./txn_count.d `pgrep -n postgres` or ./txn_count.d <PID>
^C

Start                                          71
Commit                                         70
Total time (ns)                        2312105013

You should remember that DTrace scripts need to be carefully written and debugged, otherwise the trace information collected might be meaningless. In most cases where problems are found it is the instrumentation that is at fault, not the underlying system. When discussing information found using dynamic tracing, be sure to enclose the script used to allow that too to be checked and discussed. DTraceスクリプトの作成には注意が必要であり、デバッグが必要であることは忘れないでください。さもないと、収集される追跡情報の意味がなくなるかもしれません。 ほとんどの場合、見つかる問題はシステムではなく使用方法の間違いです。 動的追跡を使用して見つかった情報に関して議論を行う際には、スクリプトの検査や議論もできるようにスクリプトも含めるようにしてください。

New probes can be defined within the code wherever the developer desires, though this will require a recompilation. Below are the steps for inserting new probes: 開発者が望めばコード内に新しくプローブを定義することができます。しかし、これには再コンパイルが必要です。 下記は、新規プローブの定義の手順です。

<title>Example:</title> 例:  Here is an example of how you would add a probe to trace all new transactions by transaction ID. これはトランザクションIDを用いて新規トランザクションを追跡するプローブ追加の仕方の例です。

There are a few things to be careful about when adding trace macros to the C code: Cのソースコードに追跡用のマクロを追加する際、いくつかの注意点があります: