Nav

Administration Service

This document describes how to perform operations over the Runtime Manager Agent administration service API. :keywords: agent, mule, esb, servers, monitor, notifications, external systems, third party, get status, metrics

logo cloud disabled logo hybrid active logo server active logo pcf disabled

Configuring Components

Operation: List Components

This operation lists components including services, external message handlers and internal message handlers.

Request:

GET <Runtime Manager Agent URL>/components HTTP/1.1

Example:

GET http://localhost:9999/mule/agent/components HTTP/1.1

Response:


          
       
1
2
3
4
5
[
  {
    componentId: "external.handlers.switch.rest.request.handler", enabled: true
  }
]

Component Configuration

Operation: Get a Component Configuration

Request:

GET <Runtime Manager Agent URL>/<component> HTTP/1.1 Content-Type: application/json

Example:

GET http://localhost:9999/mule/agent/myservice/ HTTP/1.1
Content-Type: application/json

Response:


           
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
{
   "serviceHandlerTypes": [
       "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
   ],
   "injectedHandlers": [
       {
           "name": "com.mulesoft.agent.monitoring.publisher.CloudwatchMonitorPublisher",
           "path": "/mule/agent/cloudwatch.agent.monitor.publisher/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.GraphiteMonitorPublisher",
           "path": "/mule/agent/mule.agent.graphite.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.NagiosMonitorPublisher",
           "path": "/mule/agent/mule.agent.nagios.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.ZabbixMonitorPublisher",
           "path": "/mule/agent/mule.agent.zabbix.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       }
   ],
   "frequencyTimeUnit": "MINUTES",
   "frequency": "150"
}

Operation: Modify a Component Configuration

This operation modifies the configuration of a component by overriding the configuration provided in the descriptor with the properties contained in the JSON request.

Request:

PATCH <Runtime Manager Agent URL>/<component> HTTP/1.1

Example:

PATCH <Runtime Manager Agent URL>/myservice HTTP/1.1

JSON sent with the request:


           
        
1
2
3
4
{
  "frequencyTimeUnit": "<unit>",
  "frequency": "<value>",
}

Example:


           
        
1
2
3
4
5
6
PATCH http://localhost:9999/mule/agent/myservice HTTP/1.1

{
  "frequencyTimeUnit": "SECONDS",
  "frequency": "150"
}

Response if configuration changed successfully:


           
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
   "serviceHandlerTypes": [
       "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
   ],
   "injectedHandlers": [
       {
           "name": "com.mulesoft.agent.monitoring.publisher.CloudwatchMonitorPublisher",
           "path": "/mule/agent/cloudwatch.agent.monitor.publisher/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.GraphiteMonitorPublisher",
           "path": "/mule/agent/mule.agent.graphite.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.NagiosMonitorPublisher",
           "path": "/mule/agent/mule.agent.nagios.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.ZabbixMonitorPublisher",
           "path": "/mule/agent/mule.agent.zabbix.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       }
   ],
   "frequencyTimeUnit": "SECONDS",
   "frequency": "150"
}

Operation: Replace a Component Configuration

This operation replaces the configuration of a component with the properties contained in the JSON request.

Request:

PUT <Runtime Manager Agent URL>/<component> HTTP/1.1
{
  "frequency": "30"
}

Response:


           
        
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
{
   "serviceHandlerTypes": [
       "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
   ],
   "injectedHandlers": [
       {
           "name": "com.mulesoft.agent.monitoring.publisher.CloudwatchMonitorPublisher",
           "path": "/mule/agent/cloudwatch.agent.monitor.publisher/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.GraphiteMonitorPublisher",
           "path": "/mule/agent/mule.agent.graphite.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.NagiosMonitorPublisher",
           "path": "/mule/agent/mule.agent.nagios.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       },
       {
           "name": "com.mulesoft.agent.monitoring.publisher.ZabbixMonitorPublisher",
           "path": "/mule/agent/mule.agent.zabbix.jmx.internal.handler/configuration",
           "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
       }
   ],
   "frequencyTimeUnit": null,
   "frequency": "30"
}

Operation: Enable a Component

Request:

PUT <Runtime Manager Agent URL>/<component>/enable HTTP/1.1

Example:

PUT http://localhost:9999/mule/agent/myservice/enable

Response (if the service was successfully enabled):


           
        
1
HTTP 200
Operation: Disable a Component

Request:

PUT <Runtime Manager Agent URL>/<service>/disable HTTP/1.1

Example:

PUT http://localhost:9999/mule/agent/myservice/disable

Response (if successfully disabled):


            
         
1
HTTP 200

In this topic:

We use cookies to make interactions with our websites and services easy and meaningful, to better understand how they are used and to tailor advertising. You can read more and make your cookie choices here. By continuing to use this site you are giving us your consent to do this.

+