Extend the platform,
empower your team.
Enable remote monitoring of your DataPower gateways with this extension.
ExtensionDataPower gateways provide mission-critical service/application integration, security, and control. For these devices, Dynatrace offers remote monitoring through the DataPower ActiveGate extension. By ingesting key device data, the extension provides Dynatrace with real-time insight into device health and performance.
Now available in Extensions Framework 2.0, click on Add to environment to get started.
Under Extensions
on the left menu, select IBM Datapower
.
This is an ActiveGate extension and runs on an ActiveGate of an ActiveGate group of your choice.
XML Management Interface URL: Endpoint where the IBM Datapower XML Management Interface is exposed. Should look something like https://<hostname>:<port>/service/mgmt/current
User: Used to authenticate against the XML Management Interface. Must have permissions to query it.
Password: Password to user above.
Require a valid SSL certificate: If enabled, the extension will use a secure SSL connection to connect to the XML Management Interface. A valid certicate has to be defined in the parameter below.
Path to a CA_BUNDLE file or directory: If SSL connection is enabled, the absolute path to the SSL certificate to be used.
Monitoring rules: In this section, you can define rules to monitor or stop monitoring the different Datapower entities.
Debug: Produces more verbose logs. Enable only when troubleshooting or support makes that recommendation.
Lastly, select which feature sets (metric groups) you would like this configuration to collect. Selecting too few will not give you the proper visibility and you may miss out on important performance data, as well as key indicators that can be correlated between different objects.
The extension comes wtih 10 built-in metric events for the most relevant Datapower metrics and their thresholds. These metric events are disabled by default, but you can navigate over to Settings, Anomaly Detection and Metric events to enable them. These 10 metrics events are:
Below is a complete list of the feature sets provided in this version. To ensure a good fit for your needs, individual feature sets can be activated and deactivated by your administrator during configuration.
Metric name | Metric key | Description | Unit |
---|---|---|---|
Task load | IBM.DataPower.Task.load | - | Percent |
Task pending messages | IBM.DataPower.Task.workList | - | Count |
Task CPU usage | IBM.DataPower.Task.CPU | - | Percent |
Task Memory usage | IBM.DataPower.Task.Memory | - | Percent |
Task file count | IBM.DataPower.Task.FileCount | - | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
CPU load | IBM.DataPower.cpuload | - | Percent |
Memory usage | IBM.DataPower.Memory.Usage | - | Percent |
Memory total | IBM.DataPower.Memory.Total | - | KiloByte |
Memory used | IBM.DataPower.Memory.Used | - | KiloByte |
Memory free | IBM.DataPower.Memory.Free | - | KiloByte |
Memory requested | IBM.DataPower.Memory.Req | - | KiloByte |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Calls per minute | IBM.DataPower.Service.httpTransactionThroughput | - | PerMinute |
Total transaction time | IBM.DataPower.Service.httpTransactionsTime | Total amount of time used on transactions per service | MilliSecond |
Service status | IBM.DataPower.Service.status | - | Percent |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Packets received | IBM.DataPower.Interface.receivePackets.count | Number of packets received per interface | Count |
Bytes received | IBM.DataPower.Interface.receiveBps.count | Number of bytes received per interface | Byte |
Errors received | IBM.DataPower.Interface.receiveErrors.count | Number of errors received per interface | Count |
Dropped packages received | IBM.DataPower.Interface.receiveDrops.count | Number of received packages that have been dropped per interface | Count |
Packets transmitted | IBM.DataPower.Interface.transmitPackets.count | Number of transmitted packages per interface | Count |
Bytes transmitted | IBM.DataPower.Interface.transmitBps.count | Number of bytes transmitted per interface | Byte |
Errors transmitted | IBM.DataPower.Interface.transmitErrors.count | Number of errors transmitted per interface | Count |
Dropped packages transmitted | IBM.DataPower.Interface.transmitDrops.count | Number of transmitted packages that have been dropped per interface | Count |
Interface status | IBM.DataPower.Interface.status | If the interface's status is active or not | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
HTTP Connection requests | IBM.DataPower.XMLManager.Requests | Connection requests to the XML Manager | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Load Balancer Group - Administrative state | IBM.DataPower.LoadBalancer.adminState | Administrative state of the load balancer group | Count |
Load Balancer - Administrative state | IBM.DataPower.LoadBalancer.memberState | Administrative state of the load balancer | Count |
Load Balancer - Operational state | IBM.DataPower.LoadBalancer.operationalState | Operational state of the load balancer | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Operational state | IBM.DataPower.operationalState | Operational state of a classes' object | Count |
Administrative state | IBM.DataPower.adminState | Administrative state of a classes' object | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Free - Encrypted | IBM.DataPower.Disk.freeEncrypted | Free and encrypted disk size | MegaByte |
Total - Encrypted | IBM.DataPower.Disk.totalEncrypted | Total encrypted disk size | MegaByte |
Free - Temporary | IBM.DataPower.Disk.freeTemporary | Free temporary disk size | MegaByte |
Total - Temporary | IBM.DataPower.Disk.totalTemporary | Total temporary disk size | MegaByte |
Free - Internal | IBM.DataPower.Disk.freeInternal | Free internal disk size | MegaByte |
Total - Internal | IBM.DataPower.Disk.totalInternal | Total internal disk size | MegaByte |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Log events processed | IBM.DataPower.LogTarget.process.count | Total amount of log events processed per log target | Count |
Log events dropped | IBM.DataPower.LogTarget.drop.count | Total amount of log events dropped per log target | Count |
Log events pending | IBM.DataPower.LogTarget.pending | Total amount of log events pending per log target | Count |
Metric name | Metric key | Description | Unit |
---|---|---|---|
Connectivity | IBM.DataPower.connectivity | Percentage of successful connections | Percent |
Crypto Engine Status | IBM.DataPower.cryptoEngineStatus | - | Percent |
Active Subscribers | IBM.DataPower.activeSubscribers | Number of active subscribers | Count |
Records lost | IBM.DataPower.recordsLost.count | - | Count |
Pending records | IBM.DataPower.pendingRecordsQueue | Number of records pending in queue | Count |
Complete records | IBM.DataPower.completeRecordsQueue | Number of records completed | Count |
Pending messages | IBM.DataPower.worklist | - | Count |
Load | IBM.DataPower.load | - | Percent |
Connections accepted | IBM.DataPower.connectionsAccepted | Per minute rate of connections accepted | PerMinute |
Active transactions | IBM.DataPower.activeTransactions | - | Count |
Uptime | IBM.DataPower.Uptime | Total uptime of the device | Second |
Modified the overview dashboard to show interface traffic instead of status, as the status is missing from many datapower installations.
Extension conversion to Extensions Framework 2.0:
All metrics ingested by the new extension are prefixed with IBM.DataPower and drop the builtin:tech prefix. Any older configuration such as metric events or dashboards that use the old metric key will need to be replaced with the new one.