Вызов метода JMX MBean из сценария оболочки

98

Существуют ли какие-либо библиотеки, которые позволили бы мне вызвать метод JMX MBean из сценария оболочки. Мы предоставляем некоторые операции / команды администратора через JMX, и мы могли бы попросить наших администраторов использовать JConsole или VisualVM, но некоторые задачи лучше оставить автоматизации. В этой автоматизации мы хотели бы иметь возможность вызывать метод JMX MBean на нашем работающем сервере, желательно из сценария оболочки.

Дугнукем
источник

Ответы:

106

Доступны следующие утилиты командной строки JMX:

  1. jmxterm - кажется, наиболее полнофункциональная утилита.
  2. cmdline-jmxclient - используется в проекте WebArchive, кажется, очень голым (и, похоже, с 2006 года разработки не было)
  3. Groovy script и 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 bugs.launchpad.net/jmxterm/+bug/942693
artbristol
19

Я разработал jmxfuse, который предоставляет JMX Mbeans как файловую систему Linux FUSE с функциональностью, аналогичной / proc fs. Он полагается на 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
Аластер МакКормак
источник
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 секунды для возврата значения по сравнению с 3 секундами для jmxterm
sivann
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]
Teknopaul
источник
4

Немного рискованно, но вы можете запустить команду curl POST со значениями из формы из консоли JMX, ее URL-адресом и HTTP-аутентификацией (если требуется):

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

Осторожно: индекс метода может измениться при изменении программного обеспечения. И реализация веб-формы может измениться.

Вышеупомянутое основано на источнике страницы службы 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>
BBay
источник
Я реализовал это на Java с помощью a HttpURLConnectionи могу подтвердить, что это работает. (кстати, submit=Invokeне нужно)
Tom
можно ли описать как это работает? Я имею в виду, что по умолчанию jmx использует rmi, и вот я вижу http. Означает ли это, что сервер должен быть настроен для поддержки запросов jmx http?
Psychozoic
3

Взгляните на JManage . Он может выполнять методы MBean и получать / устанавливать атрибуты из командной строки .

ЧссПлы76
источник
Единственным недостатком является использование утилиты командной строки, которая требует, чтобы JManage был запущен для прокси-команд на ваши серверы JMX. Я бы предпочел более легкий подход непосредственно к самому серверу JMX.
Dougnukem
3

Вы можете также взглянуть на jmx4perl . Он обеспечивает доступ без Java к MBeans удаленного сервера Java EE. Однако на целевой платформе необходимо установить небольшой сервлет агента, который обеспечивает спокойный доступ к JMX через HTTP с полезной нагрузкой JSON. (Версия 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 (например, для большинства MXBean-компонентов). Для дополнительных функций (Nagios-Plugin, доступ к сложным типам атрибутов в стиле XPath и т. Д.), Пожалуйста, обратитесь к документации jmx4perl.

Роланд Хус
источник
1

Ответ @Dougnukem мне очень помог. Я использовал подход Groovy (используя Groovy 2.3.3).

Я внес некоторые изменения в код Dougnukem. Это будет работать с Java 7 и будет печатать два атрибута в стандартный вывод каждые 10 секунд.

        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)
                    }

                }
            }

Скомпилируйте этот код в jar с помощью maven-compiler-plugin, поэтому вам не потребуется установка 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>

Оберните его битой или оболочкой, и он выведет данные на стандартный вывод.

Хаим Раман
источник
0

Я не уверен в среде, подобной bash. Вы можете попробовать несколько простых программ-оболочек на Java (с программными аргументами), которые вызывают ваши MBeans на удаленном сервере. Затем вы можете вызвать эти оболочки из сценария оболочки

Если вы можете использовать что-то вроде Python или Perl, вас может заинтересовать JSR-262, который позволяет вам предоставлять операции JMX через веб-службы. Это планируется включить в Java 7, но вы можете использовать релиз-кандидат эталонной реализации.

Кевин
источник