You can use the IBM® App Connect Enterprise administration REST API to
set user trace on an integration server dynamically, without having to restart the integration
server.
Before you begin
Read the following topics:
Procedure
You can use the following REST API methods to set user trace on an integration
server.
-
For an independent integration server:
POST http://hostname:port/apiv2/trace/user-trace
For example, use the following curl command to enable the user trace at debug level with a trace
size of
1GB:
curl -X POST http://hostname:port/apiv2/trace/user-trace -H 'accept:application/json' -H 'content-type:application/json'
-d "{"properties":{"traceLevel":"debug","traceMode":"safe","traceSizeKb":1048576}}"
-
For an integration server that is managed by an integration node:
POST http://hostname:port/apiv2/servers/integrationServerName/trace/user-trace
For example, use the following curl command to enable debug-level user trace for integration
server ACESERV1, with a trace size of 1GB:
curl -X POST -H 'accept:application/json' -H 'content-type:application/json' http://hostname:port/apiv2/servers/ACESERV1/trace/user-trace
-d '{"properties": {"traceLevel": "debug", "traceMode": "safe","traceSizeKb": 1048576 }}'
You can control the granularity of the information captured in the user trace, by setting the
traceLevel property to one of the following values:
- debug
- debugTree
- normal
- none