FeaturesPluginsDocs & SupportCommunityPartners

NetBeans DTrace GUI 插件


本文将介绍如何下载、安装和运行 NetBeans Dynamic Tracing (DTrace) GUI 插件。NetBeans DTrace GUI 插件是一个用于运行 DTrace 脚本的图形用户界面（Graphical User Interface，GUI），并且可以安装在 SunTM Studio 12 IDE、NetBeansTM IDE 5.5、NetBeans IDE 5.5.1 和 NetBeans IDE 6.0 中。

我们可以通过 GUI 运行 D 脚本，即使它们嵌入在 shell 脚本中没有关系。事实上，DTrace href="http://www.opensolaris.org/os/community/dtrace/dtracetoolkit/">DTraceToolkit 中的所有 D 脚本。DTraceToolkit 是由 OpenSolaris DTrace 社区开发的一组实用的文档脚本。

得益于其优秀的体系结构设计，我们可以方便地扩展和定制 NetBeans DTrace GUI 插件。

GUI 包由两个组件构成：NetBeans 插件和 DTraceScripts 目录。

  • 可以轻易地将 NetBeans DTrace GUI 插件安装到 Sun Studio 12 IDE、NetBeans IDE 5.5、NetBeans IDE 5.5.1 和 NetBeans IDE 6.0 中。

  • DTraceScripts 目录包含一些子目录。每个子目录都含有一些 D 脚本。D 脚本主要根据 DTrace 提供者进行分类。可以通 shell 命令行将新的 D 脚本复制到已有子目录中，可以将它复制到 DTraceScripts 目录下面新创建的子目录中。还可以在 IDE 中创建并保存新的 D 脚本。

系统和软件需求及下载

下面列出了系统和软件需求：
  • DTrace 工具只支持 SolarisTM 10 和 Solaris 11 操作系统。
  • NetBeans DTrace 插件可在 Sun Studio 12 IDE 和 NetBeans IDE 中运行。
  • NetBeans IDE 5.5、NetBeans IDE 5.5.1. 和 NetBeans IDE 6.0 均可从 http://www.netbeans.org/ 网站下载。
  • Sun Studio 12 IDE 可从 http://developers.sun.com/sunstudio/downloads/ 网站下载。
  • 需要在 /etc/user_attr 文件中设置您的权限。比如说，以下内容的作用是在运行 DTrace 的机器上设置 DTrace 权限。 
    nassern::::defaultpriv=basic,dtrace_user,dtrace_proc,dtrace_kernel

    这些权限将在用户登录机器时生效。

有关用户权限的详细信息，请阅读 Using DTrace with Sun Studio Tools to Understand, Analyze, Debug, and Enhance Complex Applications 这篇文章的 Security 一节。

如何安装 NetBeans DTrace GUI 插件

安装步骤——适用于 NetBeans IDE 5.5、NetBeans IDE 5.5.1 和 SunStudio 12 IDE

  1. 启动 NetBeans IDE 5.5、NetBeans IDE 5.5.1 或 Sun Studio 12 IDE.

  2. 选择 Tools > Update Center。

  3. 在 Update Center 向导的 Select Location of Modules 页面中，选中 NetBeans Update Center Beta（适用于 NetBeans IDE 5.5 或 NetBeans IDE 5.5.1）和 Sun Studio Update Center（适用于 Sun Studio 12 IDE）复选框（如果未选中）。然后单击 Next 按钮。

    4. Select Location of Modules page

  4. 在 Select Modules to Install 页面中，选择 Available Updates and New Modules 列表中的 DTrace，单击 Add 按钮。然后单击 Next 按钮。

    5. Select Modules to Install page

  5. 接受许可协议。

  6. 在 Download Modules 页面中，等待下载完成并单击 Next 按钮。

    7. Download Modules page

  7. 在 View Certificates and Install Modules 页面中，单击 Finish 按钮。


    8. View Certificates and Install Modules page

NetBeans DTrace GUI 插件已经安装在 NetBeans IDE 5.5 或 NetBeans IDE 5.5.1 中。请阅读 安装 DTraceScripts 文件 部分安装 DTraceScripts 文件。

安装步骤——适用于 NetBeans IDE 6.0

  1. 启动 NetBeans IDE 6.0。

  2. 选择 Tools > Plugins。

  3. 在 Plugins 窗口的 Available Plugins 选项卡中，单击 DTrace 复选框。（如果可用插件列表中没有出现 DTrace，则单击 Reload Catalog 按钮并重试。）然后单击 Install 按钮。

    4. Available Plugins tab

  4. 在 NetBeans IDE Installer 窗口中，单击 Next 按钮。

    NetBeans IDE Installer

  5. 接受许可协议并单击 Install 按钮。

  6. 单击 Finish 按钮。

  7. 关闭 Plugins 窗口。

NetBeans DTrace GUI 插件已经安装到 NetBeans IDE 6.0 中。下一节将演示如何安装 DTraceScripts 文件。

安装 DTraceScripts 文件

如果自己运行 IDE，则需要将 DTraceScripts.tar 文件安装在主目录中。如果使用根用户运行 IDE，则需要将 DTraceScripts.tar 文件安装在根目录中。

安装好 DTrace GUI 插件后，DTraceScripts.tar 文件将位于主目录下的 .netbeans/netbeans_release 目录或 .sunstudio/12.0-SunOS-platform 目录中。比如说，/home/nassern/.netbeans/6.0/dtrace-gui-102007。

要安装 DTraceScripts.tar 文件，请遵循以下步骤：

  1. 在主目录或根目录下，使用 tar 命令解压文件。比如说：tar -xvf /home/nassern/.netbeans/6.0/dtrace-gui-102007/DTraceScripts.tar
  2. 需要将所有脚本的文件权限（file permission）设置为 -rwxr-xr-x 或 755。如果必要，可以使用 chmod 命令设置适当的文件权限。比如说： 
    chmod -R 755 DTraceScripts

DTrace GUI 的安装已经完成。要打开 DTrace GUI，请选择 Window > DTrace。

DTrace GUI 也可以从 http://plugins.netbeans.org 页面下载。

如何在 DTrace GUI 环境中运行 D 脚本

要在 DTrace GUI 中运行 D 脚本，请遵循以下步骤：

  1. 启动 Sun Studio 12 IDE、NetBeans IDE 5.5、NetBeans IDE 5.5.1 或 NetBeans IDE 6.0。

  2. 选择 Windows > DTrace。DTrace 选项卡将在 IDE 的左侧打开。

  3. 在 DTrace 面板的 Category 列表框中选择一个 D 脚本，然后单击 Start 按钮。如下图所示。

  4. 所选 D 脚本的输出将显示在 Output 窗口中。一些脚本在单击 Stop 按钮之前不会生成任何输出。


An example to show how to run D scripts

  • 可以同时运行多个 D 脚本。
  • 单击 Stop 按钮停止上次启动的 D 脚本。
  • 要保存脚本的输出，在 Output 窗口中单击鼠标右键并选择 Save As。

高级选项

要使用高级选项，请单击 DTrace GUI 中的 Advanced。

可以使用 View/Edit 选项在 Editor 窗口中显示所选的 D 脚本。

要创建一个新的 D 脚本，请遵循以下步骤：

  1. 单击 Advanced 并选择 Create new script 选项。

  2. 在 New Script 对话框中，键入新 D 脚本的名称，名称不用包含 .d 扩展。一个空的 D 脚本将创建在所选类别（目录）中。比如说，下图显示了如何在 Proc 目录中创建一个空的 hello D 脚本。

    create a new D script

  3. 单击 Advanced 并选择 View/Edit 选项，在 Editor 窗口中显示最近创建的（空的）D 脚本。

  4. 在 Editor 窗口中输入新 D 脚本的代码并保存文件。下图显示了 hello.d 脚本的 DTrace 代码。

    Create and run the new hello.d script

可以通过 DTrace GUI 运行最近创建的 hello.d 脚本。

配置面板列出了可为各个所选 D 脚本指定的可选参数。

pid 正在运行的进程的进程 id
Script args D 脚本自变量
executable 可执行程序的绝对路径名称
executable args 可执行程序的自变量
output 忽略此字段
description 可插入此字段的帮助消息

为了创建持久性数据，用户指定的参数和属性将存储在一个 .xml 文件中。资源文件（property file）与 D 脚本文件的名称相同，不过其扩展名为 .xml。换句话说，用户数据将保存在文件中，以便于 D 脚本和 IDE 在以后调用。

下图显示了如何运行 memleak.d 脚本。memleak.d 脚本可用于检测应用程序中的内存泄漏。memleak.d 脚本需要两个参数：可执行程序的绝对路径名称和 D 脚本模块名称。在下面的示例中，/home/nassern/test/umem/hello 是可执行程序的绝对路径名称，而 libc 是模块名称。



how to specify properties for a D script.

局限性和已知 bug

  • 目前，单击 Stop 按钮将停止用户上次启动的 D 脚本。这将在下一版发行中得到修改。Stop 操作将停止符合以下条件的正在运行的脚本：用户选择了该脚本的输出选项卡。
  • 双击所选的 D 脚本并不会在 Editor 窗口中显示该 D 脚本。这将在下一版发行中得到修复。目前，必须使用 Advanced View/Edit 选项在 Editor 窗口中显示 D 脚本。

请将您的评论和反馈发送到 。

Companion
Projects: 		MySQL Database Server   Open JDK: an Open SourceJDK   GlassFish Community: an Open Source Application Server    Mobile & Embedded Community    Open Solaris   java.net - The Source for Java Technology Collaboration   Virtual Box - full virtualizer  Open ESB - The Open Enterprise Service Bus Powered by