シェルスクリプトからのJMX MBeanメソッドの呼び出し


98

シェルスクリプトからJMX MBeanメソッドを呼び出すことができるライブラリはありますか?JMXを介していくつかの操作/管理コマンドを公開し、管理者にJConsoleまたはVisualVMを使用させることもできますが、一部のタスクは自動化に任せたほうがよいでしょう。この自動化では、実行中のサーバーでJMX MBeanメソッドを、できればシェルスクリプトから呼び出せるようにしたいと考えています。

回答:


106

次のコマンドラインJMXユーティリティを使用できます。

  1. jmxterm-最も完全に機能するユーティリティのようです。
  2. cmdline-jmxclient -WebArchiveプロジェクトで使用されているのは、骨のない骨組みのようです(そして、2006年以降は開発されていないようです)
  3. GroovyスクリプトとJMX-いくつかの本当に強力なJMX機能を提供しますが、groovyおよびその他のライブラリーのセットアップが必要です。
  4. JManageコマンドライン機能 -(欠点は、コマンドをプロキシするために実行中のJManageサーバーが必要になることです)

Groovy JMXの例:

import java.lang.management.*
import javax.management.ObjectName
import javax.management.remote.JMXConnectorFactory as JmxFactory
import javax.management.remote.JMXServiceURL as JmxUrl

def serverUrl = 'service:jmx:rmi:///jndi/rmi://localhost:9003/jmxrmi'
String beanName = "com.webwars.gameplatform.data:type=udmdataloadsystem,id=0"
def server = JmxFactory.connect(new JmxUrl(serverUrl)).MBeanServerConnection
def dataSystem = new GroovyMBean(server, beanName)

println "Connected to:\n$dataSystem\n"

println "Executing jmxForceRefresh()"
dataSystem.jmxForceRefresh();

cmdline-jmxclientの例:

あなたが持っている場合

  • MBean:com.company.data:type=datasystem,id=0

オペレーションが呼び出された場合:

  • jmxForceRefresh()

次に、単純なbashスクリプトを記述できます(cmdline-jmxclient-0.10.3.jarをダウンロードして、スクリプトと同じディレクトリに配置するとします):

#!/bin/bash

cmdLineJMXJar=./cmdline-jmxclient-0.10.3.jar
user=yourUser
password=yourPassword
jmxHost=localhost
port=9003

#No User and password so pass '-'
echo "Available Operations for com.company.data:type=datasystem,id=0"
java -jar ${cmdLineJMXJar} ${user}:${password} ${jmxHost}:${port} com.company.data:type=datasystem,id=0

echo "Executing XML update..."
java -jar ${cmdLineJMXJar} - ${jmxHost}:${port} com.company.data:type=datasystem,id=0 jmxForceRefresh

jmxtermはJava 7のバグでは動作しないようです。launchpad.net
jmxterm / + bug /

19

JMX Mbeanを/ proc fsと同様の機能を持つLinux FUSEファイルシステムとして公開するjmxfuseを開発しました。JMXへの架け橋としてホロキアに依存しています。属性と操作は、読み取りと書き込みのために公開されます。

http://code.google.com/p/jmxfuse/

たとえば、属性を読み取るには:

me@oddjob:jmx$ cd log4j/root/attributes
me@oddjob:jmx$ cat priority

属性を書き込むには:

me@oddjob:jmx$ echo "WARN" > priority

操作を呼び出すには:

me@oddjob:jmx$ cd Catalina/none/none/WebModule/localhost/helloworld/operations/addParameter
me@oddjob:jmx$ echo "myParam myValue" > invoke

12

Syabru NagiosのJMXプラグインは Nagiosのから使用されることを意味しているが、Nagiosのを必要とせず、コマンドラインでの使用のために非常に便利です。

~$ ./check_jmx -U service:jmx:rmi:///jndi/rmi://localhost:1099/JMXConnector --username myuser --password mypass -O java.lang:type=Memory -A HeapMemoryUsage -K used 
JMX OK - HeapMemoryUsage.used = 445012360 | 'HeapMemoryUsage used'=445012360;;;;

これは素晴らしく、非常に高速です。値を返すのに約0.3秒vs jmxtermの3秒
sivann 2017

9

潜在的にこれをJavaで書くのが最も簡単

import javax.management.*;
import javax.management.remote.*;

public class JmxInvoke {

    public static void main(String... args) throws Exception {

        JMXConnectorFactory.connect(new JMXServiceURL(args[0]))
            .getMBeanServerConnection().invoke(new ObjectName(args[1]), args[2], new Object[]{}, new String[]{})


    }

}

これは単一の.classにコンパイルされ、サーバーや複雑なMavenパッケージに依存関係を必要としません。

と呼ぶ

javac JmxInvoke.java
java -cp . JmxInvoke [url] [beanName] [method]

4

少し危険ですが、JMXコンソールのフォームの値、そのURL、およびhttp認証(必要な場合)を使用してcurl POSTコマンドを実行できます。

curl -s -X POST --user 'myuser:mypass'
  --data "action=invokeOp&name=App:service=ThisServiceOp&methodIndex=3&arg0=value1&arg1=value1&submit=Invoke"
  http://yourhost.domain.com/jmx-console/HtmlAdaptor

注意:メソッドのインデックスは、ソフトウェアの変更に応じて変わる可能性があります。そして、Webフォームの実装は変更される可能性があります。

上記は、実行する操作のJMXサービスページのソースに基づいています。

http://yourhost.domain.com/jmx-console/HtmlAdaptor?action=inspectMBean&name=YourJMXServiceName

フォームのソース:

form method="post" action="HtmlAdaptor">
   <input type="hidden" name="action" value="invokeOp">
   <input type="hidden" name="name" value="App:service=ThisServiceOp">
   <input type="hidden" name="methodIndex" value="3">
   <hr align='left' width='80'>
   <h4>void ThisOperation()</h4>
   <p>Operation exposed for management</p>
    <table cellspacing="2" cellpadding="2" border="1">
        <tr class="OperationHeader">
            <th>Param</th>
            <th>ParamType</th>
            <th>ParamValue</th>
            <th>ParamDescription</th>
        </tr>
        <tr>
            <td>p1</td>
           <td>java.lang.String</td>
         <td> 
            <input type="text" name="arg0">
         </td>
         <td>(no description)</td>
        </tr>
        <tr>
            <td>p2</td>
           <td>arg1Type</td>
         <td> 
            <input type="text" name="arg1">
         </td>
         <td>(no description)</td>
        </tr>
    </table>
    <input type="submit" value="Invoke">
</form>

これをJavaからこの方法で実装HttpURLConnectionし、動作することを確認できます。(2つsubmit=Invokeは不要です)
tom

それがどのように機能するかを説明することは可能ですか?つまり、デフォルトではjmxがを使用しrmi、そこに表示されhttpます。サーバーがjmxリクエストをサポートするように構成されている必要があるということhttpですか?
精神分裂病

3

見てくださいJManageを。MBeanメソッドを実行し、コマンドラインから属性を取得/設定できます。


唯一の欠点は、JMXサーバーにコマンドをプロキシするためにJManageが実行されている必要があるコマンドラインユーティリティを使用することです。私は、JMXサーバー自体に直接アクセスするより軽量なアプローチを望んでいます。
Dougnukem 2009年

3

あなたも見ていたいかもしれませんjmx4perlを。これは、リモートJava EEサーバーのMBeanへのJavaなしのアクセスを提供します。ただし、小さなエージェントサーブレットをターゲットプラットフォームにインストールする必要があります。これにより、JSONペイロードを使用してHTTP経由でJMXにアクセスできます。(バージョン0.50は、JSR-160プロキシを実装することにより、エージェントレスモードを追加します)。

利点は、ローカルJava JVMの起動と比較して起動時間が短いことと使いやすさです。jmx4perlには、独自のスクリプトで簡単に使用できるPerlモジュールのフルセットが付属しています。

use JMX::Jmx4Perl;
use JMX::Jmx4Perl::Alias;   # Import certains aliases for MBeans

print "Memory Used: ",
      JMX::Jmx4Perl
          ->new(url => "http://localhost:8080/j4p")
          ->get_attribute(MEMORY_HEAP_USED);

一般的なMBean /属性/操作のコンボ(たとえば、ほとんどのMXBean)のエイリアスを使用することもできます。その他の機能(Nagios-Plugin、複雑な属性タイプへのXPathのようなアクセスなど)については、jmx4perlのドキュメントを参照してください。


1

@Dougnukemの回答は非常に役に立ちました。私はGroovyアプローチを採用しました(groovy 2.3.3を使用)。

Dougnukemコードにいくつかの変更を加えました。これはJava 7で動作し、10秒ごとに2つの属性を標準出力に出力します。

        package com.my.company.jmx
        import groovy.util.GroovyMBean;
        import javax.management.remote.JMXServiceURL
        import javax.management.remote.JMXConnectorFactory
        import java.lang.management.*

            class Monitor {
                static main(args) {
                    def serverUrl = 'service:jmx:rmi:///jndi/rmi://localhost:5019/jmxrmi'
                    String beanName = "Catalina:type=DataSource,class=javax.sql.DataSource,name=\"jdbc/CommonDB\""
                    println  "numIdle,numActive"

                    while(1){
                        def server = JMXConnectorFactory.connect(new JMXServiceURL(serverUrl))
                       //make sure to reconnect in case the jvm was restrated 
                        server.connect()
                        GroovyMBean mbean = new GroovyMBean(server.MBeanServerConnection, beanName)
                        println  "${mbean.numIdle},${mbean.numActive}"
                        server.close()
                        sleep(10000)
                    }

                }
            }

maven-compiler-pluginを使用してこのコードをjarにコンパイルするので、groovy-all.jarのみをインストールする必要はありません。以下は、関連するプラグインの定義と依存関係です。

   <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <compilerId>groovy-eclipse-compiler</compilerId>
                    <source>1.7</source>
                    <target>1.7</target>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.codehaus.groovy</groupId>
                        <artifactId>groovy-eclipse-compiler</artifactId>
                        <version>2.8.0-01</version>
                    </dependency>
                    <dependency>
                        <groupId>org.codehaus.groovy</groupId>
                        <artifactId>groovy-eclipse-batch</artifactId>
                        <version>2.3.4-01</version>
                    </dependency>
                </dependencies>
            </plugin>
        </plugins>
    </build>
    <dependencies>
        <dependency>
            <groupId>org.codehaus.groovy</groupId>
            <artifactId>groovy-all</artifactId>
            <version>2.4.3</version>
        </dependency>
    </dependencies>

バットまたはシェルでラップすると、標準出力にデータが出力されます。


0

bashのような環境についてはよくわかりません。リモートサーバーでMBeanを呼び出すJavaの簡単なラッパープログラム(プログラム引数付き)を試してみてください。その後、シェルスクリプトからこれらのラッパーを呼び出すことができます

PythonやPerlなどを使用できる場合は、WebサービスでJMX操作を公開できるJSR-262に興味があるかもしれません。これはJava 7に含まれる予定ですが、リファレンス実装のリリース候補を使用できる可能性があります

弊社のサイトを使用することにより、あなたは弊社のクッキーポリシーおよびプライバシーポリシーを読み、理解したものとみなされます。
Licensed under cc by-sa 3.0 with attribution required.