创建探针

要创建探针,请首先创建 Probekit 源文件(probe 文件)。然后,在 Probekit 源文件中,创建该探针并添加用于定义探针工作方式的内容。

要创建 Probekit 源文件,必须使用“Probekit 源文件”向导。您可以继续使用该向导来创建探针并编写大部分探针定义,也可以直接转至 Probekit 编辑器。在这两种情况下,都必须使用 Probekit 编辑器来编写代码的 Java 代码段。

要了解有关不同探针部分的详细信息,请参阅探针定义

  1. 要创建 Probekit 源文件:
    1. 在“导航器”或“包资源管理器”视图中,右键单击要包含源文件的 Java 项目,然后单击新建 > 其他
    2. 选择向导页中,展开概要分析和日志记录,然后选择 Probekit 源文件
    3. 单击下一步
    4. 在“创建新的探针文件”向导中,在文件名字段中输入新探针源文件的名称。Probekit 源文件的文件扩展名必须是 .probe
    5. 源代码文件夹字段中,输入要包含新 Probekit 源文件的项目源代码文件夹。
      注意:Probekit 源文件必须出现在项目源代码文件夹的最顶层;它们不能在子文件夹中。
  2. 如果您想现在退出向导并使用 Probekit 编辑器来创建探针及其定义:
    1. 选择无内容
    2. 单击完成。在项目源代码文件夹中将添加新的 Probekit 源文件,缺省情况下,该源文件将在 Probekit 编辑器中自动打开。
    3. 转到步骤 4
  3. 如果您要继续使用向导来帮助您创建探针定义:
    1. 选择方法探针调用位置探针
    2. 选择段类型值以指定要让向导创建的段。
    3. 单击下一步
    4. 使用添加编辑按钮来定义任意数目的数据项。当添加或选择某项时,该向导就会显示该项的描述。
      注意:如果您后退并更改正在创建的探针类型或要插入的段类型,编辑器将提示您废弃任何不再应用的项。
    5. 单击完成。在项目源代码文件夹中将添加新的 Probekit 源文件,缺省情况下,该源文件将在 Probekit 编辑器中自动打开。
  4. 可选:在 Probekit 编辑器的“常规”页上,在标识字段中输入探针的唯一标识字符串,在版本字段中输入版本号并输入标签值。此数据仅用于在概要分析配置中标识该探针。
  5. 单击探针选项卡。
  6. 如果您未使用向导来创建探针,请在 Probekit 编辑器左边单击鼠标右键,然后选择添加探针这应该会在该页左边的树窗格中创建新探针。
  7. 在树窗格中右键单击该探针,然后单击新建 > 新段将作为该探针的子代显示在树窗格中,该段的属性字段将显示在该页右边的编辑窗格中。
  8. 在编辑窗格中,选择段类型值,然后输入探针段的 Java 代码。要了解特定信息,请参阅探针段类型
  9. 通过右键单击树中的项、使用弹出菜单来添加/除去子项并在编辑窗格中输入新项的值,继续定义探针。弹出菜单将仅列示对于树中的所选位置有效的项。如果该项有效但不再能够添加到选择的位置,则该项在菜单中将是禁用的。
    注意:Import 伪指令属性字段中输入值时,请仅输入要导入的包或类的名称。请不要输入 Import 关键字或最后的分号(;)。
  10. 完成定义探针后,请单击文件 > 保存
    注意:当您保存 Probekit 源文件时,Probekit 编辑器将检查文件中所有 Java 元素 的语法并报告任何 javac 问题。如果某个条目具有错误或警告,则树中相应的图标就会更改为错误或警告图标。Javac 问题将显示在“探针”页底部的表中。如果双击此表中的项,就会将焦点移至该项以进行编辑。
相关概念
收集探针数据:基本用法
相关参考
Probekit 编辑器
Probekit 示例