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