管理 REST API を使用したモニター・プロファイルの抽出

IBM® App Connect Enterprise の管理用REST APIを使用すると、REST APIまたは統合サービスを使用して開発されたアプリケーションや統合ソリューション内で実行されているメッセージフローの監視プロファイルを抽出できます。

始める前に

以下のトピックをお読みください。

このタスクの概要

このトピックの例は、以下のリソースに基づいています。
  • アプリケーション: MonitoringApp
  • アプリケーションと一緒にパッケージされたメッセージ・フロー: MonitoringAppFlow1 および MonitoringAppFlow2
  • アプリケーションと関連付けられたライブラリー: Monitoring Lib
  • ライブラリー内のメッセージ・フロー: MonitoringLibFlow
この例の「統合エクスプローラー」ペインの抜粋に示されているように:
この図は、アプリケーション、アプリケーションと一緒にパッケージされた 2 つのメッセージ・フロー、アプリケーションに関連付けられているライブラリー、およびライブラリー内にあるメッセージ・フローを含む、デプロイメント・トポロジーを示しています。

アプリケーション内のメッセージ・フローのモニター・プロファイルの抽出

手順

アプリケーション内のメッセージ・フローのモニター・プロファイルを抽出することができます。

  • 独立統合サーバーの場合:
    POST http://hostname:port/apiv2/applications/applicationName/messageflows/messageflowName/extract-monitoring-profile

    例えば、メッセージ・フロー MonitoringAppFlow1 のモニター・プロファイルを抽出するには、以下の curl コマンドを使用します。

    curl -X POST http://hostname:port/apiv2/applications/MonitoringApp/messageflows/MonitoringAppFlow1/extract-monitoring-profile
    以下のような応答が返されます。
    {
        "MonitoringProfile": {
            "HTTP Input.transaction.Start": {
                "bitstreamData": [
                    {
                        "Content": "none",
                        "Encoding": "none"
                    }
                ],
                "eventFilter": [
                    {
                        "Text": "true()",
                        "isXPath": true
                    }
                ],
                "eventName": [
                    {
                        "Text": "HTTP Input.TransactionStart",
                        "isXPath": false
                    }
                ],
                "eventType": "Transaction start"
            }
        }
    }
    

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/applications/applicationName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile

    例えば、メッセージ・フロー MonitoringLibFlow のモニター・プロファイルを抽出するには、以下の curl コマンドを使用します。

    curl -X POST http://hostname:port/apiv2/applications/MonitoringApp/libraries/MonitoringLib/messageflows/MonitoringLibFlow/extract-monitoring-profile
    以下のような応答が返されます。
    {
        "MonitoringProfile": {
            "HTTP Input.transaction.Start": {
                "bitstreamData": [
                    {
                        "Content": "none",
                        "Encoding": "none"
                    }
                ],
                "eventFilter": [
                    {
                        "Text": "true()",
                        "isXPath": true
                    }
                ],
                "eventName": [
                    {
                        "Text": "HTTP Input.TransactionStart",
                        "isXPath": false
                    }
                ],
                "eventType": "Transaction start"
            },
            "HTTP Input.transaction.End": {
                "bitstreamData": [
                    {
                        "Content": "none",
                        "Encoding": "none"
                    }
                ],
                "eventFilter": [
                    {
                        "Text": "true()",
                        "isXPath": true
                    }
                ],
                "eventName": [
                    {
                        "Text": "HTTP Input.TransactionEnd",
                        "isXPath": false
                    }
                ],
                "eventType": "Transaction end"
            },
            "HTTP Reply.terminal.in": {
                "bitstreamData": [
                    {
                        "Content": "none",
                        "Encoding": "none"
                    }
                ],
                "eventFilter": [
                    {
                        "Text": "true()",
                        "isXPath": true
                    }
                ],
                "eventName": [
                    {
                        "Text": "HTTP Reply.InTerminal",
                        "isXPath": false
                    }
                ],
                "eventType": "In terminal"
            }
        }
    }
    
  • 統合ノードによって管理される統合サーバーの場合は、以下のようにします。
    POST http://hostname:port/apiv2/servers/integrationServerName/applications/applicationName/messageflows/messageflowName/extract-monitoring-profile

    例えば、統合サーバー ACESERV1 にデプロイされたメッセージ・フロー MonitoringAppFlow1 のモニター・プロファイルを抽出するには、以下の curl コマンドを使用します。

    curl -X POST http://hostname:port/apiv2/servers/ACESERV1/applications/MonitoringApp/messageflows/MonitoringAppFlow1/extract-monitoring-profile

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/servers/integrationServerName/applications/applicationName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile

    例えば、統合サーバー ACESERV1 にデプロイされたメッセージ・フロー MonitoringLibFlow のモニター・プロファイルを抽出するには、以下の curl コマンドを使用します。

    curl -X POST http://hostname:port/apiv2/servers/ACESERV1/applications/MonitoringApp/libraries/MonitoringLib/messageflows/MonitoringLibFlow/extract-monitoring-profile

    コマンドが正常に実行されると、HTTP 状況コード 200 が返されます。

REST API 統合ソリューション内のメッセージ・フローのモニター・プロファイルの抽出

手順

REST API 統合ソリューション内のメッセージ・フローのモニター・プロファイルを抽出することができます。

  • 独立統合サーバーの場合:
    POST http://hostname:port/apiv2/rest-apis/rest-apiName/messageflows/messageflowName/extract-monitoring-profile

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/rest-apis/rest-apiName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile
  • 統合ノードによって管理される統合サーバーの場合は、以下のようにします。
    POST http://hostname:port/apiv2/servers/integrationServerName/rest-apis/rest-apiName/messageflows/messageflowName/extract-monitoring-profile

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/servers/integrationServerName/rest-apis/rest-apiName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile

    コマンドが正常に実行されると、HTTP 状況コード 200 が返されます。

統合サービス統合ソリューション内のメッセージ・フローのモニター・プロファイルの抽出

手順

統合サービス統合ソリューション内のメッセージ・フローのモニター・プロファイルを抽出することができます。

  • 独立統合サーバーの場合:
    POST http://hostname:port/apiv2/services/integrationServiceName/messageflows/messageflowName/extract-monitoring-profile

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/services/integrationServiceName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile
  • 統合ノードによって管理される統合サーバーの場合は、以下のようにします。
    POST http://hostname:port/apiv2/servers/integrationServerName/services/integrationServiceName/messageflows/messageflowName/extract-monitoring-profile

    メッセージ・フローがライブラリー内にある場合、以下のようにします。

    POST http://hostname:port/apiv2/servers/integrationServerName/services/integrationServiceName/libraries/libraryName/messageflows/messageflowName/extract-monitoring-profile

    コマンドが正常に実行されると、HTTP 状況コード 200 が返されます。