management.adoc

Java Management eXtensions

JMX

The JMX technology provides the tools for building distributed, Web-based, modular and dynamic solutions for managing and monitoring devices, applications, and service-driven networks.

— Oracle Documentation
https://www.oracle.com/technetwork/java/javase/tech/javamanagement-140525.html

Demo with jConsole

Architecture

Instrumentation

• Instrumente une ressource à l’aide du langage

• Crée un MBean et l’enregistre par l’agent

Agent JMX

Basé sur un MBean server

Gestion distante

• Détermine comment accéder au MBean server

• Dépendant de l’implémentation

MBean

Types de MBean

Type	Description
Standard	JavaBean implémentant une interface définie au moment du dévelopement
Dynamic	Implémente l’interface DynamicMBean

Types de MBean

Type	Description
Open	Dynamic MBean qui respecte certaines conventions
Model	MBean dynamiques générique entièrement configurable

Dévelopement d’un MBean standard

• Interface dont le nom finit par MBean

• Seules les propriétés et les attributs définis seront exposés

• Classe d’implémentation nommée comme l’interface sans le suffixe MBean

Conception

Exemple : interface MBean

public interface FooMBean {

    String getName();
    String getValue();
    void setValue(String value);
    void printNameAndValue();
}

Classe d’implémentation

public class Foo implements FooMBean {

  private final String name;
  private String value;

  @Inject
  public Foo(NamingService service) {
    this.name = service.generateUniqueNameFor(this);
  }

  @Override
  public String getName() { return name; }

  @Override
  public String getValue() { return value; }

  @Override
  public void setValue(String value) { this.value = value; }

  @Override
  public void printNameAndValue() {
    System.out.println(name + ":" + value);
  }
}

Enregistrement d’un MBean

ObjectName

• Identifie le MBean de manière unique

• Composé :

  • D’un nom de domaine

  • Un ensemble de paires nom-valeur

• p.e. ch.frankel.jmx:type=MyBean,foo=bar

Exemple d’enregistrement

var foo = new Foo(new NamingService());
var mBeanServer =
  ManagementFactory.getPlatformMBeanServer();
try {
  var name = ObjectName.getInstance(
                     "ch.frankel.hesge:type=MBean,name=foo");
  mBeanServer.registerMBean(foo, name);
} catch (MalformedObjectNameException |
         NotCompliantMBeanException |
         InstanceAlreadyExistsException |
         MBeanRegistrationException e) {
  e.printStackTrace();
}

Utilisation programmatique de MBean

Exemple de code

var mBeanServer = ManagementFactory.getPlatformMBeanServer();
try {
  var name = ObjectName.getInstance(
                     "ch.frankel.hesge:type=MBean,name=foo");
  mBeanServer.registerMBean(foo, name);
  var attribute = new Attribute("value", "newValue");
  mBeanServer.setAttribute(oName, attribute);
} catch (OperationsException |
         MBeanException |
         ReflectionException e) {
  e.printStackTrace();
}

Le cas d’usage de JMX

• Le monitoring

• Les MXBeans sont des MBeans dédiés au monitoring

!