从shell脚本调用JMX MBean方法

时间:2009-11-17 19:20:26

标签: java sysadmin jmx

是否有任何库允许我从shell脚本调用JMX MBean方法。我们通过JMX公开了一些操作/管理命令,我们可以让我们的管理员使用JConsole或VisualVM,但有些任务最好留给自动化。在那个自动化中,我们希望能够在运行的服务器上调用JMX MBean方法,最好是从shell脚本调用。

9 个答案:

答案 0 :(得分:98)

以下命令行JMX实用程序可用:

  1. jmxterm - 似乎是功能最齐全的实用程序。
  2. cmdline-jmxclient - 在WebArchive项目中使用似乎非常简单(自2006年以来没有任何开发看起来像)
  3. Groovy script and JMX - 提供一些非常强大的JMX功能,但需要groovy和其他库设置。
  4. JManage command line functionality - (缺点是 它需要一个正在运行的JManage 服务器代理命令通过)
  5. 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
    

答案 1 :(得分:18)

我开发了jmxfuse,它将JMX Mbeans暴露为具有与/ proc fs类似功能的Linux FUSE文件系统。它依赖于Jolokia作为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

答案 2 :(得分:11)

Syabru Nagios JMX plugin旨在从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;;;;

答案 3 :(得分:7)

最容易用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 JmsInvoke.java
java -cp . JmxInvoke [url] [beanName] [method]

答案 4 :(得分: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>

答案 5 :(得分:3)

看看JManage。它能够执行MBean方法并从command line获取/设置属性。

答案 6 :(得分:3)

您可能还需要查看jmx4perl。它提供对远程Java EE Server的MBean的无Java访问。但是,需要在目标平台上安装一个小代理servlet,它通过带有JSON有效负载的HTTP提供一个宁静的JMX Access。 (版本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 / Attribute / Operation组合使用别名(例如,对于大多数MXBeans)。 有关其他功能(Nagios-Plugin,类似于XPath的复杂属性类型访问,...),请参阅jmx4perl的文档。

答案 7 :(得分:1)

@Dougnukem回答帮了我很多忙。我采用了Groovy方法(使用groovy 2.3.3)。

我对Dougnukem代码做了一些修改。 这将适用于Java 7,并将每10秒向stdout打印两个属性。

        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安装只有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>

用蝙蝠或贝壳包裹它,它会将数据打印到标准输出。

答案 8 :(得分:0)

我不确定类似bash的环境。您可以尝试使用Java(带有程序参数)的一些简单的包装程序来调用远程服务器上的MBean。然后,您可以从shell脚本

中调用这些包装器

如果您可以使用Python或Perl之类的东西,您可能会对JSR-262感兴趣,它允许您通过Web服务公开JMX操作。这计划包含在Java 7中,但您可以使用reference implementation的候选版本