DTrace 探针¶ ↑

DTrace 探针及其功能的列表。在用户定义的探针（称为 USDT）中无法定义“模块”和“函数”，因此不会指定它们。探针定义的格式为

provider:module:function:name(arguments)

由于无法指定模块和函数，因此它们将为空。然后，Ruby 的示例探针定义为

ruby:::method-entry(class name, method name, file name, line number)

其中“ruby”是提供程序名称，模块和函数名称为空，探针名称为“method-entry”，并且探针采用四个参数

类名
方法名
文件名
行号

探测列表¶ ↑

稳定性¶ ↑

在列出具体探测之前，我们先来谈谈稳定性。探测稳定性在 probes.d 文件的底部 pragma D 属性行中声明。以下是每个稳定性声明的说明。

提供者名称稳定性: 提供者名称“ruby”已声明为稳定。我们不太可能将提供者名称从“ruby”更改为其他名称。
Module 和函数稳定性: 由于我们不允许为模块和函数名称提供值，因此我们提供的值（无值）被声明为稳定。
探测名称稳定性: 探测名称将来可能会更改，因此它们被标记为“Evolving”。使用者不应依赖这些名称的稳定性。
探测参数稳定性: 传递给探测的参数将来可能会更改，因此它们被标记为“Evolving”。使用者不应依赖这些参数的稳定性。

已声明的探测¶ ↑

探测在 probes.d 文件中定义。以下是已声明的探测以及它们被触发的时间和它们采用的参数

ruby:::method-entry(classname, methodname, filename, lineno);

此探测在进入方法之前触发。

classname: 类的名称（字符串）
methodname: 即将执行的方法的名称（字符串）
filename: 调用方法的文件名（字符串）
lineno: 调用方法的行号（整数）

注意：仅在启用跟踪时才会触发，例如：TracePoint.new{}.enable。有关更多详细信息，请参见 Feature#14104。

ruby:::method-return(classname, methodname, filename, lineno);

此探测在方法返回后立即触发。参数与“ruby:::method-entry”相同。

注意：仅在启用跟踪时才会触发，例如：TracePoint.new{}.enable。有关更多详细信息，请参见 Feature#14104。

ruby:::cmethod-entry(classname, methodname, filename, lineno);

此探测器在 C 方法进入之前触发。参数与“ruby:::method-entry”相同。

ruby:::cmethod-return(classname, methodname, filename, lineno);

此探测器在 C 方法返回之前触发。参数与“ruby:::method-entry”相同。

ruby:::require-entry(requiredfile, filename, lineno);

此探测器在对 rb_require_safe 的调用（当需要文件时）触发。

requiredfile: 要必需的文件的名称（字符串）。
filename: 调用“require”的文件（字符串）。
lineno: 调用 require 的行号（int）。

ruby:::require-return(requiredfile, filename, lineno);

此探测器在 rb_require_safe（当需要文件时）返回之前触发。参数与“ruby:::require-entry”相同。如果在文件必需期间出现异常，此探测器将不会触发。

ruby:::find-require-entry(requiredfile, filename, lineno);

此探测器在调用 search_required 之前触发。search_required 通过搜索已加载的特性（$"）确定文件是否已被必需，如果没有，则确定必须加载哪个文件。

requiredfile: 要必需的文件（字符串）。
filename: 调用“require”的文件（字符串）。
lineno: 调用 require 的行号（int）。

ruby:::find-require-return(requiredfile, filename, lineno);

此探测器在 search_required 返回后立即触发。有关更多详细信息，请参见“ruby:::find-require-entry”的文档。此探测器的参数与“ruby:::find-require-entry”相同。

ruby:::load-entry(loadedfile, filename, lineno);

此探测器在调用“load”时触发。参数与“ruby:::require-entry”相同。

ruby:::load-return(loadedfile, filename, lineno);

此探测器在“load”返回时触发。参数与“ruby:::load-entry”相同。

ruby:::raise(classname, filename, lineno);

此探测器在引发异常时触发。

classname: 引发异常的类的名称（字符串）
filename: 引发异常的文件的名称（字符串）
lineno: 引发异常的文件中的行号（int）

ruby:::object-create(classname, filename, lineno);

此探测器在即将分配对象时触发。

classname: 已分配对象的类（字符串）
filename: 分配对象的的文件的名称（字符串）
lineno: 分配对象的的文件中的行号（int）

ruby:::array-create(length, filename, lineno);

此探测器在即将分配Array时触发。

length: 数组的大小（long）
filename: 分配数组的文件名（字符串）
lineno: 分配数组的文件中的行号（int）

ruby:::hash-create(length, filename, lineno);

当即将分配一个 Hash 时触发此探针。

length: 哈希的大小（long）
filename: 分配哈希的文件名（字符串）
lineno: 分配哈希的文件中的行号（int）

ruby:::string-create(length, filename, lineno);

当即将分配一个 String 时触发此探针。

length: 字符串的大小（long）
filename: 分配字符串的文件名（字符串）
lineno: 分配字符串的文件中的行号（int）

ruby:::symbol-create(str, filename, lineno);

当即将分配一个 Symbol 时触发此探针。

str: 符号的内容（字符串）
filename: 分配字符串的文件名（字符串）
lineno: 分配字符串的文件中的行号（int）

ruby:::parse-begin(sourcefile, lineno);

在解析和编译源文件之前触发。

sourcefile: 正在解析的文件（字符串）
lineno: 源代码开始的行号（int）

ruby:::parse-end(sourcefile, lineno);

在解析和编译源文件之后触发。

sourcefile: 正在解析的文件（字符串）
lineno: 源代码结束的行号（int）

ruby:::gc-mark-begin();

在标记阶段开始时触发。

ruby:::gc-mark-end();

在标记阶段结束时触发。

ruby:::gc-sweep-begin();

在扫描阶段开始时触发。

ruby:::gc-sweep-end();

在扫描阶段结束时触发。

ruby:::method-cache-clear(class, sourcefile, lineno);

在清除方法缓存时触发。

class: 正在清除的类名或“global”（字符串）
sourcefile: 正在解析的文件（字符串）
lineno: 源代码结束的行号（int）