This extension works only with the standalone machine agent.
##Use Case The IBM® WebSphere® DataPower® SOA Appliance (hereafter called DataPower) is a purpose-built hardware platform designed to simplify, secure, and accelerate XML, Web services, and Enterprise Service Bus deployments.
The DataPower XML Management Interface must be enabled. The DataPower Monitor uses the "/service/mgmt/current" SOAP endpoint to collect the metrics. Please refer to the IBM Redbook WebSphere DataPower SOA Appliance: The XML Management Interface Section 1.3, 1.4 and 1.5 to enable it.
##Installation
- Build the project with maven.
mvn clean install
-
Unzip the file target/DataPowerMonitor.zip to /monitors.
-
Edit the file /monitors/DataPowerMonitor/monitor.xml and set the following properties.
| Metric Path | Required | Default | Description |
|---|---|---|---|
| uri | Required | - | The full uri to the DataPower SOAP API eg.https://172.16.153.100:5550/service/mgmt/current |
| username | Required | - | DataPower SOAP API User Name |
| password | Required | - | DataPower SOAP API Password |
| proxy-host | Optional | - | If a Proxy Server is used to connect to the DataPower XML API |
| proxy-port | Optional | - | If a Proxy Server is used to connect to the DataPower XML API |
| proxy-username | Optional | - | If the Proxy Server needs authentication |
| proxy-password | Optional | - | If the Proxy Server needs authentication |
| metric-prefix | Optional | Custom Metrics|DataPower |
###Default Metrics
The metrics will be registered under
Application Infrastructure Performance|Custom Metrics|DataPower|
The following metrics are collected OOTB. To customize the collected metrics, please refer to the section below.
System|CPU Usage %
System|Load
System|Work List
System|Memory|Used %
System|Memory|Total (MB)
System|Memory|Used (MB)
System|Memory|Free (MB)
System|Memory|Requested (MB)
System|File System|Free Encrypted (MB)
System|File System|Total Encrypted (MB)
System|File System|Free Temporary (MB)
System|File System|Total Temporary (MB)
System|File System|Free Internal (MB)
System|File System|Total Internal (MB)
Network|eth0|Incoming KB/sec
Network|eth1|Incoming KB/sec
Network|eth2|Incoming KB/sec
Network|eth3|Incoming KB/sec
Network|Total Incoming KB/sec
Transactions|helloworld_xmlfw|Average Response Time (ms)
Transactions|http_proxy_8085|Average Response Time (ms)
Transactions|userws_proxy|Average Response Time (ms)
Transactions|wsproxy|Average Response Time (ms)
Transactions|Average Transaction Time (ms)
The list of collected metrics can be customized by configuring the /monitors/DataPowerMonitor/metrics.xml. The following screenshots depicts the metric rules.
This section explains how to extract the metric information from the soap response. The metrics.xml rules and the soap response from DataPower API is shown side-by-side
##Custom Dashboard
##Contributing
Always feel free to fork and contribute any changes directly via GitHub.
##Community
Find out more in the AppSphere community.
##Support
For any questions or feature request, please contact AppDynamics Center of Excellence.