Antタスク

JProfilerが提供するAntタスクは、Gradleタスクと非常によく似ています。この章では、Gradleタスクとの違いに焦点を当て、各Antタスクの例を示します。

すべてのAntタスクはアーカイブbin/ant.jarに含まれています。タスクをAntで利用できるようにするには、まずAntにタスク定義の場所を伝えるtaskdef要素を挿入する必要があります。以下のすべての例にはそのtaskdefが含まれています。これはビルドファイルごとに1回だけ指定する必要があり、project要素の直下の任意の場所に配置できます。

ant.jarアーカイブをAntディストリビューションのlibフォルダーにコピーすることはできません。タスク定義でJProfilerの完全なインストールを参照する必要があります。GradleやMavenの統合とは異なり、AntタスクはJProfilerディストリビューションを自動プロビジョニングしません。

Antからのプロファイリング

com.jprofiler.ant.ProfileTaskは組み込みのJavaタスクから派生しており、そのすべての属性とネストされた要素をサポートしています。追加の属性は、JavaProfile Gradleタスクと同じです。Antの属性は大文字と小文字を区別せず、通常は小文字で記述されます。複数の値を受け入れる属性の場合は、区切り文字として:または,を使用します。

<taskdef name="profile"
         classname="com.jprofiler.ant.ProfileTask"
         classpath="<path to JProfiler installation>/bin/ant.jar"/>

<target name="profile">
  <profile classname="MyMainClass" offline="true"
           calltreemode="sampling" profile="com.mycorp.:org.example."
           snapshotfile="snapshots/run.jps" recording="cpu:allocation:jdbc"
           duration="10m">
    <classpath>
      <fileset dir="lib" includes="*.jar" />
    </classpath>
  </profile>
</target>

スナップショットからのデータのエクスポート

com.jprofiler.ant.ExportTaskを使用すると、Export Gradleタスクと同様に、スナップショットからビューをエクスポートできます。ビューの指定方法はGradleタスクとは異なり、タスク要素の直下にネストされ、オプションはネストされたoption要素で指定されます。

<taskdef name="export"
         classname="com.jprofiler.ant.ExportTask"
         classpath="<path to JProfiler installation>/bin/ant.jar"/>

<target name="export">
  <export snapshotfile="snapshots/test.jps">
    <view name="CallTree" file="calltree.html"/>
    <view name="HotSpots" file="hotspots.html">
      <option name="expandbacktraces" value="true"/>
      <option name="aggregation" value="class"/>
    </view>
  </export>
</target>

スナップショットの比較

com.jprofiler.ant.CompareTaskはCompare Gradleタスクに対応し、2つ以上のスナップショット間の比較を実行します。com.jprofiler.ant.ExportTaskと同様に、比較は要素の直下にネストされ、オプションは各comparison要素にネストされます。スナップショットファイルは、ネストされたファイルセットで指定されます。

<taskdef name="compare"
         classname="com.jprofiler.ant.CompareTask"
         classpath="<path to JProfiler installation>/bin/ant.jar"/>

<target name="compare">
  <compare sortbytime="true">
    <fileset dir="snapshots">
      <include name="*.jps" />
    </fileset>
    <comparison name="TelemetryHeap" file="heap.html"/>
    <comparison name="TelemetryThreads" file="threads.html">
      <option name="measurements" value="inactive,active"/>
      <option name="valuetype" value="bookmark"/>
      <option name="bookmarkname" value="test"/>
    </comparison>
  </compare>
</target>

ヒープスナップショットの解析

Analyze Gradleタスクと同様に、Ant用の同等のcom.jprofiler.ant.AnalyzeTaskは、GUIでのアクセスを高速化するために、オフラインプロファイリングで保存されたスナップショット内のヒープスナップショット解析を準備します。処理対象のスナップショットは、ネストされたファイルセットで指定されます。

<taskdef name="analyze"
         classname="com.jprofiler.ant.AnalyzeTask"
         classpath="<path to JProfiler installation>/bin/ant.jar"/>

<target name="analyze">
  <analyze>
    <fileset dir="snapshots" includes="*.jps" />
  </analyze>
</target>