各診断プロバイダー (DP) は、状態ダンプ属性、構成ダンプ属性、自己診断テスト、および自己診断テスト属性のリストを提供します。 これらのテストは、DP が実行できる操作です。属性は、構成ダンプ、状態ダンプ、または特定の自己診断テストから収集できる 情報の一部です。
各属性は、ラベルが付いた情報の一部と見なすことができます。 各属性はまた、登録済み または未登録 であると見なすことができます。登録済み属性は、ある WebSphere Application Server のリリ ースから次のリリースに続けて使用可能でなければならない属性です。未登録属性は、現在の形式では製品の今後のリリースで使用できない場合があります (使用が確約されていません)。
構成ダンプ、状態ダンプ、または自己診断テストを実行する場合、管理者または自動ツールは登録済みのみの 値を要求することができる場合と、すべての 値を要求できる場合があります。これは、管理者またはツ ールのニーズに応じて決まります。 結果をフィルタリングするというオプションは、 診断プロバイダーの Java Management Extension (JMX) MBean インターフェースを通じてのみ、 使用可能であることに注意してください。 このインターフェースには、プログラマチックに、 または wsadmin ツールを使用して、アクセスすることができます。
<attribute> <id><Regular Expression representing the attribute name></id> <descriptionKey><MsgKey into a ResourceBundle for localization of the label></descriptionKey> <registered>true</registered> </attribute>
<test> <id><Regular Expression for the name of the test></id> <descriptionKey><MsgKey into a ResourceBundle for localization of the label></descriptionKey> <attribute><One or more attributes which will be output from this test></attribute> </test>
public DiagnosticEvent [] configDump(String aAttributeId, boolean aRegisteredOnly); public DiagnosticEvent [] stateDump(String aAttributeId, boolean aRegisteredOnly);
こ れらのメソッドは、コンポーネントの構成ダンプまたは状態ダンプを呼び出し、すべての一致する属性または登録されている属性のみを含む出力をフィルタリングすると同時に、戻す属性の正規表現のフィルターを指定します。 これにより、メソッドを実行する管理者または自動化ソフトウェアは、全体のフィールドのサブセットを指定する ことができます (特に、多くの属性が公開されているか、状態収集仕様が使用可能なデータ量を増加させる場合に重要です)。 次の helper メソッドは、出力のフィルタリングを支援するために使用できます。
public static AttributeInfo [] queryMatchingDPInfoAttributes(String aAttributeId, AttributeInfo [] inAttrs, String [] namesToCheck, boolean aRegisteredOnly) {戻すことのできる 単一の属性を取得し、これをフィルタリングするには、次のようにします。
public static AttributeInfo queryMatchingDPInfoAttributes(String aAttributeId, AttributeInfo [] inAttrs, String nameToCheck, boolean aRegisteredOnly) {データを取り込んだ属 性情報のセットに対して実行し、不要なパーツを除去するには、次のようにします。
public static void filterEventPayload(String aAttributeId, HashMap payLoad) {
これらのメッセージの詳細については、DiagnosticProviderHelper クラスの API 資料を検討してください。基本的な概念は、戻すことの できる属性をコンポーネントが認識すると、helper メソッドは、それらの属性のどれを戻す必要があるかを正規表現ロ ジックおよび登録ブール値に基づいて判別する、ということです。
public DiagnosticEvent[] selfDiagnostic(String aTestId, boolean aRegisteredOnly)違いは、最初のパラメーターが、テストを行う対象の正規表現フィルターであるところです。