コンテンツにスキップ
GitHub

MBeanブラウザー

はじめに

Section titled “はじめに”

Apache Camelなどの多くのアプリケーションサーバーやフレームワークは、設定と監視のために多数のMBeanをJMXで公開しています。JVM自体も多数のプラットフォームMXBeanを公開しており、JVMの低レベルの動作に関する有益な情報を提供しています。

jvmguardには、選択したVMに登録されているすべてのMBeanを表示するMBeanブラウザーが含まれています。MBeanサーバーにアクセスするためのJMXのリモート管理レベルは必要ありません。jvmguardエージェントがすでにプロセス内で実行されており、登録されているすべてのMBeanサーバーにアクセスできるからです。

jvmguardはOpen MBeanの型システムをサポートしています。Open MBeanは、多数の単純型を定義できるほか、カスタムクラスを伴わない複合データ型も定義できます。また、データ構造として配列とテーブルも利用できます。MXBeanを使うと、JMXはJavaクラスからOpen MBeanを自動的に作成する簡単な方法を提供します。例えば、JVMが提供するMBeanはMXBeanです。

「MBean」ビューには、選択した1つのJVMに登録されているすべてのMBeanが表示されます。VMグループを選択している場合は、まず単一のVMに切り替える必要があります。VMプールを選択している場合は、コンテキスト領域に🔍の画像ボタンが表示され、プール内のVMの一覧が表示されます。

MBeanには階層がありませんが、jvmguardはオブジェクトドメイン名の最初のコロンまでを最初のツリーレベルとし、すべてのプロパティを再帰的にネストされたレベルとして使用することで、MBeanをツリーに整理します。プロパティ値が先に表示され、プロパティキーが末尾に括弧付きで表示されます。typeプロパティは、トップレベルノードのすぐ下に表示されるように優先されます。

属性

Section titled “属性”

MBeanの内容を表示するツリーテーブルのトップレベルには、MBean属性が表示されます。

次のデータ構造は、ネストされた行として表示されます。

  • 配列: プリミティブ配列とオブジェクト配列の要素は、インデックスをキー名としてネストされた行に表示されます。
  • コンポジットデータ: コンポジットデータ型のすべてのアイテムがネストされた行として表示されます。各アイテムは任意の型になれるため、ネストは任意の深さまで続きます。
  • 表形式データ: 最も多く遭遇するのは、java.util.Mapのインスタンスが1つのキー列と1つの値列を持つ表形式データ型にマッピングされるMXBean内の表形式データです。キーの型が単純型の場合、マップは「インライン」で表示され、各キーと値のペアがネストされた行として表示されます。キーが複合型の場合は、ネストされたキーと値のエントリを持つ「マップエントリ」要素のレベルが挿入されます。これは、複合キーと複数の値を持つ一般的な表形式型でも同様です。

オプションで、MBean属性を編集可能にできます。その場合、値の横に「値を編集」アイコンが表示されます。MBean属性は、少なくとも「プロファイラー」のアクセスレベルを持つユーザーのみが編集できます。コンポジット型と表形式型はMBeanブラウザーでは編集できませんが、配列や単純型は編集可能です。

配列など、値がnullになり得る場合、エディターにはnull状態を選択するチェックボックスがあります。

配列要素はセミコロンで区切ります。末尾のセミコロン1つは無視できるため、1と1;は同等です。セミコロンの前の値がない場合、オブジェクト配列ではnull値として扱われます。文字列配列では、二重引用符(“”)で空の要素を作成でき、要素全体を引用符で囲むことでセミコロンを含む要素を作成できます。文字列要素内の二重引用符は2つ重ねる必要があります。例えば、次の文字列配列値を入力すると、

"Test";"";;"embedded "" quote";"A;B";;

次の文字列配列が作成されます。

new String[] {"Test", "", null, "embedded \" quote", "A;B", null}

jvmguardは、数値のMBean属性値からテレメトリを作成できます。記録設定でMBeanテレメトリラインを定義すると、「選択」ボタンで、上部にVMセレクターを備えたMBean属性ブラウザーが表示されます。VMを選択した後、MBean属性を選択できます。MBeanブラウザーとは異なり、この場合は属性行を選択できます。

テレメトリは、コンポジットデータ内のネストされた値や、単純なキーと単一の値を持つ表形式データを追跡することもできます。ネストされた行を選択すると、パスコンポーネントがスラッシュで区切られた値パスが構築されます。

オペレーション

Section titled “オペレーション”

MBean属性の検査と変更に加えて、MBeanオペレーションを呼び出して戻り値を確認できます。MBeanオペレーションは、setterやgetterではないMBeanインターフェース上のメソッドです。MBeanオペレーションを呼び出すには、ユーザーは少なくとも「プロファイラー」のアクセスレベルを持っている必要があります。

MBeanオペレーションは1つ以上の引数を持つことがあります。引数を入力する際には、MBean属性を編集する場合と同じルールと制限が適用されます。

オペレーションの戻り値は、コンポジット型、表形式型、配列型の場合があるため、MBean属性ツリーテーブルと同様の内容を持つ新しいウィンドウが表示されます。単純な戻り値型の場合は、「戻り値」という名前の行が1つだけあります。それ以外の型では、「戻り値」がルート要素となり、そこに結果が追加されます。