Chamando o método JMX MBean a partir de um script de shell

98

Há alguma biblioteca que me permita chamar um método JMX MBean a partir de um script de shell. Exporemos algumas operações / comandos admin por meio do JMX e poderíamos fazer com que nossos administradores usassem o JConsole ou VisualVM, mas é melhor deixar algumas tarefas para a automação. Nessa automação, gostaríamos de poder chamar um método JMX MBean em nosso servidor em execução, de preferência a partir de um script de shell.

Dougnukem
fonte

Respostas:

106

Os seguintes utilitários JMX de linha de comando estão disponíveis:

  1. jmxterm - parece ser o utilitário com mais recursos.
  2. cmdline-jmxclient - usado no projeto WebArchive parece muito básico (e nenhum desenvolvimento desde 2006, parece)
  3. Script Groovy e JMX - fornece algumas funcionalidades JMX realmente poderosas, mas requer groovy e outras configurações de biblioteca.
  4. Funcionalidade de linha de comando JManage - (a desvantagem é que requer um servidor JManage em execução para comandos de proxy)

Exemplo JMX Groovy:

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();

exemplo cmdline-jmxclient:

Se você tem um

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

Com uma operação chamada:

  • jmxForceRefresh ()

Em seguida, você pode escrever um script bash simples (supondo que você baixe cmdline-jmxclient-0.10.3.jar e coloque no mesmo diretório do seu script):

#!/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
Dougnukem
fonte
jmxterm não parece funcionar em Java 7 bugs.launchpad.net/jmxterm/+bug/942693
artbristol
19

Desenvolvi o jmxfuse que expõe JMX Mbeans como um sistema de arquivos Linux FUSE com funcionalidade semelhante ao / proc fs. Ele conta com Jolokia como a ponte para JMX. Atributos e operações são expostos para leitura e gravação.

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

Por exemplo, para ler um atributo:

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

para escrever um atributo:

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

para invocar uma operação:

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

O plug - in Syabru Nagios JMX deve ser usado no Nagios, mas não requer o Nagios e é muito conveniente para uso em linha de comando:

~$ ./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;;;;
Austin Mills
fonte
Isso é ótimo e muito rápido. Cerca de 0,3 s para retornar um valor vs 3 segundos para jmxterm
sivann
9

É potencialmente mais fácil escrever isso em 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[]{})


    }

}

Isso compilaria em um único .class e não precisa de dependências no servidor ou qualquer pacote maven complicado.

ligue com

javac JmxInvoke.java
java -cp . JmxInvoke [url] [beanName] [method]
Teknopaul
fonte
4

Um pouco arriscado, mas você poderia executar um comando curl POST com os valores do formulário do console JMX, seu URL e autenticação http (se necessário):

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

Cuidado: o índice do método pode mudar com as mudanças no software. E a implementação do formulário da web pode mudar.

O acima é baseado na fonte da página de serviço JMX para a operação que você deseja realizar:

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

Fonte do formulário:

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
fonte
Implementei dessa forma em Java usando um HttpURLConnectione posso confirmar que funciona. (aliás, submit=Invokeé desnecessário)
tomo de
é possível descrever como funciona? Quer dizer, por padrão jmx usa rmi, e aí eu vejo http. Isso significa que o servidor deve ser configurado para suportar solicitações jmx http?
Psicozóico de
3

Dê uma olhada no JManage . É capaz de executar métodos MBean e obter / definir atributos da linha de comando .

ChssPly76
fonte
A única desvantagem é usar o utilitário de linha de comando, ele requer que o JManage esteja em execução para comandos proxy para seus servidores JMX. Prefiro uma abordagem mais leve diretamente para o próprio servidor JMX.
Dougnukem
3

Você pode querer também dar uma olhada em jmx4perl . Ele fornece acesso sem java a MBeans do Java EE Server remoto. No entanto, um servlet de pequeno agente precisa ser instalado na plataforma de destino, o que fornece um acesso JMX tranquilo via HTTP com uma carga JSON. (A versão 0.50 adicionará um modo sem agente ao implementar um proxy JSR-160).

As vantagens são os tempos de inicialização rápidos em comparação com o lançamento de uma JVM local java e a facilidade de uso. jmx4perl vem com um conjunto completo de módulos Perl que podem ser facilmente usados ​​em seus próprios scripts:

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

Você também pode usar o apelido para combinações comuns de MBean / Atributo / Operação (por exemplo, para a maioria dos MXBeans). Para recursos adicionais (Nagios-Plugin, acesso semelhante ao XPath a tipos de atributos complexos, ...), consulte a documentação do jmx4perl.

Roland Huß
fonte
1

A resposta @Dougnukem me ajudou muito. Eu escolhi a abordagem Groovy (usando o Groovy 2.3.3).

Eu fiz algumas mudanças no código Dougnukem. Isso funcionará com o Java 7 e imprimirá dois atributos no stdout a cada 10 segundos.

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

                }
            }

Compile este código em um jar usando maven-compiler-plugin para que você não precise da instalação do groovy apenas do groovy-all.jar. Abaixo está a definição e dependência do plugin relevante.

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

Envolva-o com um morcego ou uma concha e ele imprimirá os dados em stdout.

Haim Raman
fonte
0

Não tenho certeza sobre o ambiente do bash. Você pode tentar alguns programas wrapper simples em Java (com argumentos de programa) que chamam seus MBeans no servidor remoto. Você pode então chamar esses wrappers a partir do script de shell

Se você pode usar algo como Python ou Perl, pode estar interessado em JSR-262, que permite expor operações JMX em serviços da web. Isso está programado para ser incluído no Java 7, mas você pode usar um candidato a lançamento da implementação de referência

Kevin
fonte