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”更改为其他名称。
模块和函数稳定性-
由于我们不允许为模块和函数名称提供值，因此我们提供的（无值）被声明为稳定。
- 探针名称稳定性
-
探针名称将来可能会更改，因此它们被标记为“正在发展”。消费者不应依赖这些名称保持稳定。
- 探针参数稳定性
-
传递给探针的参数将来可能会更改，因此它们被标记为“正在发展”。消费者不应依赖这些参数保持稳定。
已声明的探针¶ ↑
探针在 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 的行号（整数）。
- ruby:::require-return(requiredfile, filename, lineno);
-
当 rb_require_safe（当文件被 require 时）返回之前，此探针被触发。参数与“ruby:::require-entry”相同。如果在文件 require 期间出现异常，此探针将不会触发。
- ruby:::find-require-entry(requiredfile, filename, lineno);
-
此探针在调用 search_required 之前被触发。search_required 通过搜索已加载的特性（
$"）来确定文件是否已被 require，如果未被 require，则确定必须加载哪个文件。- requiredfile
-
要 require 的文件（字符串）。
- filename
-
调用“require”的文件（字符串）。
- lineno
-
调用 require 的行号（整数）。
- 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
-
抛出异常的文件中的行号（整数）
- ruby:::object-create(classname, filename, lineno);
-
当要分配对象时，此探针被触发。
- classname
-
分配对象的类（字符串）
- filename
-
分配对象的所在文件名（字符串）
- lineno
-
分配对象的所在文件中的行号（整数）
- ruby:::array-create(length, filename, lineno);
-
当要分配
Array时，此探针被触发。- 长度
-
数组的大小（长整型）
- filename
-
分配数组的所在文件名（字符串）
- lineno
-
分配数组的所在文件中的行号（整数）
- ruby:::hash-create(length, filename, lineno);
-
当要分配
Hash时，此探针被触发。- 长度
-
哈希的大小（长整型）
- filename
-
分配哈希的所在文件名（字符串）
- lineno
-
分配哈希的所在文件中的行号（整数）
- ruby:::string-create(length, filename, lineno);
-
当要分配
String时，此探针被触发。- 长度
-
字符串的大小（长整型）
- filename
-
分配字符串的文件名（字符串）
- lineno
-
分配字符串的文件中的行号（整型）
- ruby:::symbol-create(str, filename, lineno);
-
当即将分配一个
Symbol时触发此探针。- str
-
符号的内容（字符串）
- filename
-
分配字符串的文件名（字符串）
- lineno
-
分配字符串的文件中的行号（整型）
- ruby:::parse-begin(sourcefile, lineno);
-
在解析和编译源文件之前触发。
- sourcefile
-
正在解析的文件（字符串）
- lineno
-
源代码开始的行号（整型）
- ruby:::parse-end(sourcefile, lineno);
-
在解析和编译源文件之后触发。
- sourcefile
-
正在解析的文件（字符串）
- lineno
-
源代码结束的行号（整型）
- 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
-
源代码结束的行号（整型）