IBM DataPower

Learn how to monitor DataPower devices using the DataPower ActiveGate extension.

Prerequisites

• A DataPower appliance with the XML Management Interface enabled
• An Environment ActiveGate (version 1.155+) that has the ActiveGate plugin module installed and isn't used for synthetic or mainframe monitoring
  • 1 environment ActiveGate can typically support 30-50 DataPower devices

Interested in monitoring DataPower with Dynatrace?

The quickest way to get started is to reach out to Dynatrace One.

Environment ActiveGate installation

• Installation instructions

ActiveGate plugin module installation

• Installation instructions

Extension installation

1. Obtain the install file (custom.remote.python.datapower.zip). Don't rename the file.

2. Unzip custom.remote.python.datapower.zip to the plugin_deployment directory of your ActiveGate host.

3. If the resulting directory structure isn't .\plugin_deployment\custom.remote.python.datapower\, please make the neccessary changes.

4. Restart the Dynatrace Remote Plugin Module service.

   • On Linux, restart the service using the following commands with admin rights:
     • systemctl restart remotepluginmodule.service
   • On Windows, run these two commands in a Command Prompt launched as Admin:
     • sc stop "Dynatrace Remote Plugin Module"
     • sc start "Dynatrace Remote Plugin Module"

5. Return to the Dynatrace web UI. Click Settings, the Add new technology monitoring button, and finally the Add ActiveGate plugin button.

6. Click the Upload plugin button and upload custom.remote.python.datapower.zip.

7. Enter the endpoint information requested for connecting to DataPower device:

   • Endpoint name: Meaningful and descriptive name
   • User: The username for account connecting to the XML Management Interface
   • Password: The password for said account
   • URL to the XML Management Interface: The domain name entered will be used for differentiating the devices if there are several
   • Require a valid SSL certificate: (Un)checked depending on whether or not a valid SSL certificate is required
   • Enable debug logging: Leave unchecked by default, can be checked if requested by Dynatrace support in order to investigate an issue
   • Comma-separated domains: Allows for filtering which domains should be monitored
   • Comma-separated services: Allows for filtering which services should be monitored
   • Name of the group: If the device is part of a cluster, enter the name here to group the devices within the GUI.

   

Troubleshoot ActiveGate plugins

• Troubleshooting instructions

Metrics

The IP address of all network interfaces and the ports used by the services is automatically captured, as are the following metrics:

Device

• Availability %
• CPU load %
• Crypto Engine % Fully operational

Disk

• Free encrypted
• Total encrypted
• Free temporary
• Total temporary
• Free internal
• Total internal

Log events (split by domain and logtarget)

• Processed
• Dropped
• Processed

Network (split by interface)

• Connections accepted
• Received throughput
• Transmitted throughput
• Received packets
• Transmitted packets
• Recieved dropped packets
• Transmitted dropped packets
• Received errors
• Transmitted errors

Services (split by service and domain)

• Service calls
• Response time
• Availability (enabled, but status is not up)

System usage

• Load %
• Pending messages in queue

Tasks (split by tasks)

• Load %
• Pending messages in queue
• CPU %
• Memory %
• File count

WSM Agent (split by domains)

• Active subscribers
• Records lost
• Pending records queue
• Complete records queue

XML Manager

• HTTP connection requests