Setting trace on an integration node by using the administration REST API

You can use the IBM® App Connect Enterprise administration REST API to enable trace for an integration node dynamically, without having to restart the integration node.

Before you begin

Read the following topics:

About this task

You can use the following REST API method to enable trace on an integration node:

POST http://hostname:port/apiv2/trace/agent/service-trace

The changes take effect without restarting the integration node.

For example, use the following curl command to enable trace at debug level with trace size of 2048576KB (200MB):


curl -X POST -H 'accept:application/json' -H 'content-type:application/json' http://hostname:port/apiv2/trace/agent/service-trace 
-d '{"properties":{"traceLevel":"debug", "traceMode":"safe", "traceSizeKb":2048576}}'

The POST operation updates the Active section of the trace object. If the command is successful, an HTTP status code 200 is returned.

If you set trace by using the administration REST API or web user interface, the setting does not persist when the integration node or server is restarted.