IBM® App Connect Enterprise の管理用REST APIを使用すれば、統合サーバーを再起動することなく、そのサーバー上のトレースノードを有効化または無効化できます。
手順
以下の REST API メソッドを使用して、 AIX および Linux の統合サーバーにサービストレースを設定できます。
- 独立統合サーバーの場合:
curl -X POST -H "accept:application/json" -H "content-type:application/json" http://hostname:port/apiv2/trace/trace-nodes
-d "{ "properties": {"enabled": false } }"
例えば、 AIX または Linux システムの統合サーバーで Trace ノードを無効にするには、以下の curl コマンドを使用する：
curl -X POST -H 'accept:application/json' -H 'content-type:application/json' http://hostname:port/apiv2/trace/trace-nodes
-d '{ "properties": {"enabled": false } }'
- 統合ノードによって管理される統合サーバーの場合は、以下のようにします。
POST http://hostname:port/apiv2/servers/integrationServerName/trace/trace-nodes
例えば、 AIX または Linux システムの統合サーバー ACESERV1 で Trace ノードを無効にするには、以下の curl コマンドを使用します：
curl -X POST -H "accept:application/json" -H "content-type:application/json" http://hostname:port/apiv2/servers/ACESERV1/trace/trace-nodes
-d "{ "properties": {"enabled": false } }"
この POST 操作により、traceNode オブジェクトの Active セクションが更新されます。 コマンドが正常に実行されると、HTTP 状況コード 200 が返されます。
PATCH API を使用して、Trace ノードのオプションを永続的に保持できます。
- 独立統合サーバーの場合:
PATCH http://hostname:port /apiv2/trace/trace-nodes
例えば、以下の curl コマンドを使用して、Trace ノードを無効にし、 AIX または Linux システムの統合サーバーの
server.conf.yaml 設定ファイルにその設定を保持します：
curl -X PATCH -H "accept:application/json" -H "content-type:application/json" http://hostname:port/apiv2/trace/trace-nodes
-d "{ "properties": {"enabled": false } }"
- 統合ノードによって管理される統合サーバーの場合は、以下のようにします。
PATCH http://hostname:port /apiv2/servers/integrationServerName/trace/trace-nodes
例えば、以下のcurlコマンドを使用して、統合サーバー ACESERV1 のTraceノードを無効にし、 AIX または Linux システムの
server.conf.yaml ファイルに設定を永続化します：
curl -X PATCH -H "accept:application/json" -H "content-type:application/json" http://hostname:port/apiv2/servers/ACESERV1/trace/trace-nodes
-d "{ "properties": {"enabled": false } }"
この PATCH 操作により、traceNode オブジェクトの properties セクションが更新されます。 コマンドが正常に実行されると、HTTP 状況コード 204 が返されます。 更新された値は、統合サーバーの作業ディレクトリーの overrides サブディレクトリーで確認できます。