https://github.com/cyrille-leclerc/cloudbees-jmx-invoker

https://github.com/cyrille-leclerc/cloudbees-jmx-invoker

Last synced: 6 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/cyrille-leclerc/cloudbees-jmx-invoker
• Owner: cyrille-leclerc
• License: apache-2.0
• Created: 2013-07-09T17:28:16.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-08-03T23:20:20.000Z (over 11 years ago)
• Last Synced: 2024-11-09T07:53:48.353Z (2 months ago)
• Language: Java
• Size: 89.8 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CloudBees JMX Invoker

Small script to perform the following JMX operations on a Java process running locally:

* list mbeans

* describe a mbean

* invoke a JMX operation

* read or write a JMX attribute

## JMX Invoker parameters

```

 --pid-file PID_FILE                    : PID FILE of the JVM to attach to.

                                          --pid or --pid-file required

 -attr (--attribute) ATTRIBUTE_NAME     : attribute to read or to update. If a

 [VAL]                                  : VAL is passed, then it is a write

                                          action, otherwise, it is a read action

 -d (--describe-mbeans)                 : describe mbeans

 -h (--help)                            : print help

 -l (--list-mbeans)                     : list mbeans

 -on (--object-name) OBJECT_NAME        : ObjectName of the MBean(s) to invoke,

                                          can contain wildcards (*). If more

                                          than one MBean match, all MBeans are

                                          invoked

 -op (--operation) OPERATION_NAME       : operation to invoke with arguments

 [ARG1 [ARG2  ...]]                     :

 -p (--pid) PID                         : PID of the JVM to attach to. --pid or

                                          --pid-file required

 -v (-x, --verbose)                     : print debug info

 -vvv (-xxx)                            : print super verbose debug info

```

## Samples

### List MBeans

```

java \

   -cp $JAVA_HOME/lib/tools.jar:target/cloudbees-jmx-invoker-1.0.1-jar-with-dependencies.jar \

   com.cloudbees.jmx.JmxInvoker \

   -vvv -p 11172 \

   -on Catalina:type=DataSource,class=javax.sql.DataSource,* \

   -l

```

### Describe MBean

```

java \

   -cp $JAVA_HOME/lib/tools.jar:target/cloudbees-jmx-invoker-1.0.1-jar-with-dependencies.jar \

   com.cloudbees.jmx.JmxInvoker \

   -vvv -p 11172 \

   -on java.util.logging:type=Logging \

   -d

```

### Read JMX attribute: DataSource numActive

```

java \

   -cp $JAVA_HOME/lib/tools.jar:target/cloudbees-jmx-invoker-1.0.1-jar-with-dependencies.jar \

   com.cloudbees.jmx.JmxInvoker \

   -vvv -p 11172 \

   -on Catalina:type=DataSource,class=javax.sql.DataSource,name="jdbc/petclinic" \

   -attr numActive

```

### Invoke JMX operation : get LogBack log level

```

java \

   -cp $JAVA_HOME/lib/tools.jar:target/cloudbees-jmx-invoker-1.0.1-jar-with-dependencies.jar \

   com.cloudbees.jmx.JmxInvoker \

   -v -p 11172 \

   -on "ch.qos.logback.classic:Name=cocktail-app,Type=ch.qos.logback.classic.jmx.JMXConfigurator" \

   -op getLoggerLevel org.jmxtrans

```

### Invoke JMX operation : set LogBack log level

```

java \

   -cp $JAVA_HOME/lib/tools.jar:target/cloudbees-jmx-invoker-1.0.1-jar-with-dependencies.jar \

   com.cloudbees.jmx.JmxInvoker \

   -v -p 11172 \

   -on "ch.qos.logback.classic:Name=cocktail-app,Type=ch.qos.logback.classic.jmx.JMXConfigurator" \

   -op setLoggerLevel org.jmxtrans DEBUG

```