プローブを作成するには、最初に Probekit ソース・ファイル (プローブ・ファイル) を作成します。次に、Probekit ソース・ファイル内でプローブを作成して、プローブの処理方法を定義する内容を追加します。
Probekit ソース・ファイルを作成するには、「Probekit ソース・ファイル」ウィザードを使用する必要があります。引き続きウィザードを使用して、プローブを作成したりほとんどのプローブ定義を作成したりすることも、直接 Probekit エディターに移動することもできます。どちらの場合も、Probekit エディターを使用して、そのコードに関する Java コード・フラグメントを作成する必要があります。
プローブのさまざまなパーツについて詳しくは、『プローブの定義』を参照してください。
- Probekit ソース・ファイルの作成方法:
- 「ナビゲーター」ビューまたは「パッケージ・エクスプローラー」ビューで、ソース・ファイルを組み込む Java プロジェクトを右クリックして、次にをクリックします。
- 「ウィザードを選択」ページで、「プロファイルおよびロギング」を展開し、「Probekit ソース・ファイル」を選択します。
- 「次へ」をクリックします。
- 「新規プローブ・ファイルの作成」ウィザードで、「ファイル名」フィールドに、
新規プローブ・ソース・ファイルの名前を入力します。Probekit ソース・ファイルのファイル名拡張子は .probe でなければなりません。
- 「ソース・フォルダー」フィールドに、新規 Probekit
ソース・ファイルを入れるプロジェクト・ソース・フォルダーを入力します。
注: Probekit ソース・ファイルは、プロジェクト・ソース・フォルダーのトップレベルに存在している必要があります。サブフォルダーに入れることはできません。
- ここでウィザードを終了し、Probekit エディターを使用してプローブおよびその定義を作成する場合は、次のようにします。
- 「コンテンツなし」を選択します。
- 「終了」をクリックします。新規 Probekit ソース・ファイルがプロジェクト・ソース・フォルダーに追加され、
デフォルトにより自動的に Probekit エディターで開かれます。
- ステップ 4 を続行します。
- プローブ定義の作成を支援するウィザードの使用を継続する場合は、次のようにします。
- 「メソッドの選択」または「Callsite プローブ」を選択します。
- ウィザードで作成したいフラグメントのフラグメント型値を選択します。
- 「次へ」をクリックします。
- 「追加」ボタンと「編集」ボタンを使用して必要な数のデータ項目を定義します。項目を追加または選択するときに、ウィザードはその項目の記述を表示します。
注: 前に戻って、挿入する作成中のプローブの型またはフラグメント型を変更する場合は、
エディターから、適用しなくなったすべての項目を破棄するようにプロンプトが出ます。
- 「終了」をクリックします。新規 Probekit ソース・ファイルがプロジェクト・ソース・フォルダーに追加され、
デフォルトにより自動的に Probekit エディターで開かれます。
- オプション: Probekit エディターの「一般」ページで、「ID」フィールドにプローブ固有の ID ストリングを入力し、「バージョン」 フィールドにバージョン番号を入力し、さらにラベルの値を入力します。
このデータは、プロファイル構成内でプローブを識別するためにのみ使用します。
- 「プローブ」タブをクリックします。
- プローブを作成するためにウィザードを使用していなかった場合は、Probekit エディターの左側を右クリックし、「プローブの追加 (Add Probe)」を選択します。
新しいプローブはページ左側のツリー・ペインに作られます。
- ツリー・ペインのプローブを右クリックして、とクリックします。
新規フラグメントがプローブの子としてツリー・ペインに表示され、そのフラグメントのプロパティー・フィールドがページ右側の編集ペインに表示されます。
- 編集ペインで、フラグメント型値を選択し、
次のプローブ・フラグメントの Java コードを入力します。
特定の情報については、『プローブ・フラグメント型』を参照してください。
- ツリーの項目を右クリックし、ポップアップ・メニューを使用して子項目を追加/除去し、編集ペインに新規項目の値を入力することで、プローブの定義を続けます。
ポップアップ・メニューには、ツリーで選択されている場所で有効な項目のみがリストされています。項目が有効であっても、選択されている場所に追加できない場合には、
その項目はメニューでは使用不可になっています。
注: 「インポート・ディレクティブ」プロパティー・フィールドに値を入力するときは、
インポートするパッケージの名前またはクラスのみを入力してください。
キーワード import または最終セミコロン (;) は入力しないでください。
- プローブの定義を終了した後で、とクリックします。
注: Probekit ソース・ファイルの保管時に、Probekit エディターは、ファイル内のすべての Java 要素の構文を検査し、すべての javac 問題を報告します。エントリーにエラーまたは警告があった場合、ツリー内の対応するアイコンが、エラー・アイコンまたは警告アイコンに変ります。javac 問題は、「プローブ」ページ下端にあるテーブルに表示されます。このテーブルの項目をダブルクリックして、編集する項目をフォーカスします。