System management interfaces

The integration nodes provide a service for independent system management agents.

This service enables a central management facility to access information about a network that includes one or more integration nodes. Therefore, you can extend your existing system management agents to include IBM® Integration Bus resources.

Integration nodes publish event messages, using fixed topics, in response to configuration changes, state changes, and user actions such as subscription registrations. Integration nodes also use architected messages to publish events that are related to their operational status, and changes in that status. These messages are published using the reserved topic root $SYS in code page 1208. For an MQTT pub/sub broker only, the topic root is IntegrationBus.

An example of a fixed topic with an MQ pub/sub broker:

$SYS/Broker/integrationNodeName/Status/ExecutionGroup/integrationServerName

An example of a fixed topic with an MQTT pub/sub broker:

IBM/IntegrationBus/integrationNodeName/Status/ExecutionGroup/integrationServerName

The topic structure is fixed in both cases. Replace integrationNodeName and integrationServerName with the appropriate values.

An example of the actual message data for this publication is:

<Broker uuid="12345678-1234-1234-1234-123456789012">
        <ExecutionGroup uuid="12345678-1234-1234-1234-123456789012">
                  <Stop>
                         <AllMessageFlows/>
                  </Stop>
        </ExecutionGroup>
</Broker>

A system management agent can subscribe to these topics, or to a subset of these topics, to receive the detailed information about activity and state changes in the IBM Integration Bus components.

The event messages have a fixed structure, which is defined in XML (Extensible Markup Language). The format of these messages, which are constructed in XML, is detailed in The XML message body. Some event messages are also published in JSON (JavaScript Object Notation) format, containing the same information as the corresponding XML message. The messages cover configuration changes, state changes, error notifications, and detailed subscription and topic information (for example, a subscription registration).

You can develop or purchase system management adapters or customized administrative applications. These applications subscribe to the system management topics generated by IBM Integration Bus to receive information about the activity of its resources.