通过管理 REST API 更新集成服务器上的用户跟踪属性

您可以使用 IBM® App Connect Enterprise 管理 REST API 动态更新并持久化集成服务器的用户跟踪属性,而无需重启集成服务器。

准备工作

请参阅下列主题:

关于此任务

您可以在管理 REST API 中使用动词 PATCH 动态更新用户跟踪属性。 使用动词 PATCH 进行的更新将持久存储在集成服务器工作目录的 overrides 子目录中,这意味着在集成服务器停止时更新不会丢失。

您可以使用以下 REST API 方法来更新和持久存储集成服务器的用户跟踪属性:

过程

  • 对于独立集成服务器:
    PATCH http://hostname:port/apiv2/trace/user-trace
    例如,使用以下 curl 命令启用跟踪大小为 1GB 的 debug 级别的用户跟踪:
    curl -X PATCH -H 'accept:application/json' -H 'content-type:application/json' http://hostname:port/apiv2/trace/user-trace 
    -d '{"properties": {"traceLevel": "debug", "traceMode": "safe","traceSizeKb": 1048576 }}'
  • 对于由集成节点管理的集成服务器:
    PATCH http://hostname:port/apiv2/servers/integrationServerName/trace/user-trace

    例如,使用以下 curl 命令,针对集成服务器 ACESERV1 启用跟踪大小为 1GB 的 debug 级别的用户跟踪:

    curl -X PATCH -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 }}'

    PATCH 操作将更新跟踪对象的 properties 部分。 如果命令成功,那么将返回 HTTP 状态码 204。 您可以在集成服务器工作目录的 overrides 子目录中查看更新后的值。