20.4

These are new, changed, and deprecated features in
DX APM
20.4
Agent Features
This section lists the new and enhanced agent related features.
Undertow Monitoring
You can now use
DX APM
Undertow Monitoring to monitor the performance of your applications that implement Undertow HTTP handlers. You enable this Java Agent extension when you use Undertow and
DX APM
does not display any Undertow frontends.
When your applications use the servlet API, you do not need to use Undertow Monitoring, even when you have an Undertow underlying server. You do not need the extension in this situation because the Java Agent traces servlets by default.
To deploy Undertow Monitoring, include the
Undertow (Non-Servlets)
bundle when you create or edit a package in APM Command Center.
Istio Service Mesh Monitoring
DX APM
now performs full-stack monitoring of Istio service mesh deployments. Istio Service Mesh Monitoring provides this information and functionality:
  • Health and performance data about Istio control plane components such as Mixer, Pilot, and Gateway
  • Performance data about the data plane that includes Envoy proxy
  • Health and performance data about services
  • Autodiscovery of your service-mesh topology, including inter-communication between microservices and container infrastructure performance
etcd Monitoring
You can now monitor the performance of your of etcd deployment.
DX APM
uses the Universal Monitoring Agent configured to import Prometheus data to report etcd metrics about the health of your Kubernetes or OpenShift cluster.
Enhanced Kubernetes and OpenShift Monitoring
DX APM
now includes enhanced Kubernetes topology performance reporting. The map now includes nodes for Kubernetes components including clusters and namespaces. Kubernetes and OpenShift monitoring now include metrics for you to better assess your cluster capacity. Additional metrics help you determine whether the Kubernetes cluster and the different namespaces and projects are under-provisioned or over-provisioned.
MongoDB Monitoring
DX APM
MongoDB Monitoring enables you to monitor the performance and availability of your MongoDB environment. The MongoDB Infrastructure Agent extension provides real-time visibility of your database resources and helps you correlate the performance metrics of the application, infrastructure, and database in a unified interface.
Google Cloud Platform Monitoring
DX APM
Google Cloud Platform (GCP) Monitoring remotely monitors the health and performance of GCP infrastructure and services. GCP Monitoring is an Infrastructure Agent extension that uses Google Stackdriver APIs to connect and discover the GCP resources to be monitored. GCP Monitoring supports the following GCP services: Google Compute Engine, Google Cloud Storage, Google Cloud SQL, and Google Cloud Filestore. For more information, see Google Cloud Platform Monitoring.
AWS CloudTrail Service
The
DX APM
Amazon Web Services (AWS) CloudTrail service enables you to perform compliance, governance, operational auditing, and risk auditing of your AWS account. You can perform compliance of your AWS account based on either the internal regulatory authority of your organization or a third-party regulatory authority. For more information, see Amazon Web Services Monitoring.
AWS Monitoring
DX APM
AWS Monitoring now supports these new service types: Elastic Load Balancing, Elastic Cache, Auto Scaling, Kinesis Data Streams, Billing, API Gateway, CloudTrail, Functions, Logic App, Redshift, and Fargate. For more information, see Amazon Web Services Monitoring.
Azure Monitoring
DX APM
Azure Monitoring now supports these new service types: Azure Kubernetes Service, Cost Management, Load Balancer, Azure SQL, Azure Cosmo DB, Event Hub, and Service Bus. For more information, see Azure Monitoring.
SQL Server Database Monitoring
DX APM
SQL Server Database Monitoring enables you to monitor the performance and availability of your SQL Server database environment. You can configure and use this Infrastructure Agent extension to collect the performance metrics of your SQL server that are related to Connections, Buffer Manager, Index Statistics, and more. SQL Server Monitoring also provides cluster metrics. For more information, see SQL Server Database Monitoring.
Redis Monitoring
DX APM
Redis Monitoring can monitor both a single instance of a Redis server and multiple clusters.
The two main components in a Redis cluster are the master and slave nodes. Any data written on the master node also gets saved on the slave node. The Redis Monitoring Infrastructure Agent extension monitors both the master and slave nodes. When a slave node is promoted to master node, Redis Monitoring detects the changes and reflects the changes in the UI. For more information, see Redis Monitoring Extension.
ForgeRock Monitoring Extension
The
DX APM
ForgeRock Java Agent extension is available as part of all Java agents. The extension monitors the ForgeRock Identity Platform, which includes Identity Gateway and Access Management components. For more information, see ForgeRock Monitoring Extension.
GraphQL Monitoring
DX APM
now monitors the performance of GraphQL version 14.x and above on Node.js. You can view metrics based on Node.js GraphQL framework routes and the related information.
Improved Connection Mechanism Between IBM WebSphere MQ Monitoring and MQ Server
DX APM
now includes a Bindings Mode connection between the IBM WebSphere MQ Monitoring Infrastructure Agent extension and the MQ server residing on the same machine. In this mode,
DX APM
does not require any host, port, or channel details to establish a connection with the MQ server. For more information, see Bindings Mode Connection Configuration.
DX APM
also enhanced the user authentication process to connect the IBM WebSphere MQ Monitoring and the MQ server in the client-server mode. You can now run the
RunMQCommands
script and provide the authentication details, which enables any Infrastructure Agent user to access the MQ server. For more information, see Client-Server Connection Configuration.
Amazon Linux Support
The Infrastructure Agent is now supported on these Amazon Linux versions:
  • Amazon Linux 2 AMI
  • Amazon Linux AMI
WebLogic Infrastructure Monitoring
DX APM
WebLogic Infrastructure Monitoring provides JMX monitoring capabilities for the WebLogic server including all the cluster nodes. For more information, see WebLogic Infrastructure Monitoring.
Business Payload Analyzer
When you download the BT Listener, the following properties are configured automatically:
  • btListener.output.channel.tenantId:
    This property is configured with the tenant ID.
  • btListener.output.channel.url:
    This property is configured with the DXC URL.
Dynamic Randomized Sampling
DX APM
now provides a step toward full intelligent sampling. You can configure the Java agent to dynamically collect random transaction traces in a given period to catch different types of transactions. You can configure the Java Agent to collect the First N transaction traces in a given period, a specific number of random sample transaction traces in a given period, or both.
.NET Core 3.1 Support
The .NET Core Agent now gathers data about .NET Core 3.1 applications. For more information, see .NET/.NET Core Agent and Microsoft .NET Core.
UI Features
This section lists the new and enhanced UI related features.
DX APM
Oracle Database Dashboards
You can view various dashboards related to Oracle database performance. The Oracle dashboards display metrics related to the database performance and other user activities that help you troubleshoot the database issues. For more information, see
DX APM
Oracle Database Dashboards
.
Power User Role in Team Center
We have introduced a Power User role that can perform CRUD operations on alerts, management modules, calculators, and metric groupings. For more information, see Permissions, Domain Enforcement, and Element Editing.
View Metrics From Disconnected Agents
By moving the timeline to a past time interval and viewing an agent connected at that time, you can now view the corresponding metrics in the map contextual view.
Import Existing Agents into APM Command Center
You can now import an existing agent from CA APM 10.7 into APM Command Center using the Import Agent Tool utility. For more information, see Agent Import Tool.
User-defined Columns in the Metrics Search Results
You can now show or hide columns to customize your metrics search results. For more information, see Search for Metrics in the Metrics Tree.
Event Change in Live Mode
In the timeline
Live
mode you can now view change events related to the status, topology, and attributes of a node. For more information, see Use Timeline and View Change Events.
Proxy Support for Agent Controller
As an administrator, you can configure the proxy details when configuring the Agent Controller bundle in APM Command Center. To configure the proxy, enable and define the following properties on the Agent Controller configuration page:
  • com.ca.apm.acc.controller.configurationServer.proxy.host
  • com.ca.apm.acc.controller.configurationServer.proxy.port
  • com.ca.apm.acc.controller.configurationServer.proxy.user.name
  • com.ca.apm.acc.controller.configurationServer.proxy.password
If you do not define any value for the settings, it is taken from
agentManager.httpProxy.username
in the em-connection bundle.
For more information about configuring the bundle properties, see Configure Bundle Properties and Installation Instructions in APM Command Center.
Integrations
This section lists the new and enhanced product integrations.
DX App Synthetic Monitor and
DX APM
Integration
You can now configure the DX App Synthetic Monitor (ASM) integration with
DX APM
in the APM Command Center. The integration runs as a part of the Infrastructure Agent. For more information, see Configure DX App Synthetic Monitor for DX APM.
Configure the following prerequisites before using the enhancements:
  • asm.metrics.logs=true
    (for JMeter and Webdriver steps)
  • asm.metrics.download.full=true
    (for JMeter and Webdriver steps)
  • asm.metrics.har.requests=true
    (for Webdriver steps only)
You can also use these enhancements:
  • View Detailed JMeter Steps
    When the Script Monitor runs the JMeter script, you can now view the results of the JMeter steps in the Metric view. To view the JMeter step results, set the
    asm.reportJTLSubtree
    value to
    true
    .
  • View Detailed Webdriver Steps
    When the Script Monitor runs the Webdriver script, you can now view the results of the Webdriver steps in the Metric view. To view, the Webdriver steps results set
    asm.metrics.har.wdm
    value to
    true
    .
  • Last Result Check Metric
    The new
    Last Result Check
    metric displays the last status of the monitor check.
    Here are the states that the metric displays:
    • 0: No Error
    • 1: Error
    • 2: Maintenance Mode
Other Features
This section lists the other enhanced features.
Test Automation System (TAS) Enhancements
You can use these TAS enhancements:
  • TAS API v2
    : You can now execute commands to delete a part of the topology store either synchronously or asynchronously.
  • User Authentication Enabled for TAS / NASS:
    Logged-in user with tenant administrator or master administrator rights is authorized to call TAS / NASS (metrics store) endpoints.
Known Issues
This sections lists all the known issues with the current release.
Defect
DE459955
- Amazon Web Services RDS Database Name Issue
Valid for:
DX APM
SaaS 20.4
Symptom:
A
DX APM
problem occurs when you do not assign a name to a database while creating the AWS RDS instance. The issue results in the correlation of the Application Layer to the Infrastructure Layer not working for the instance of that database in the Infrastructure Agent.
Solution:
There is no workaround for this issue.
Defect DE457462 - PHP Agent Configuration Link Inactive in Agent Download Dialog
Valid for:
DX APM
SaaS 20.4
Symptom:
In the Agent Download Dialog page for the DX APM Infrastructure Agent, the link provided to access the PHP agent full configuration details is inactive and displays 404 error.
Solution:
There is no workaround for this issue.
Defect DE457423 - Incorrect Instructions in Agent Download Dialog for Infrastructure Agent WebLogic Monitoring
Valid for:
DX APM
SaaS 20.4
Symptom:
On the Agent Download Dialog page for downloading the Infrastructure Agent, the WebLogic Monitor installation instructions page contains a content error.  In the
DX APM
WebLogic Infra Monitor
section, the instructions to copy the jar files are incorrect.
Solution:
Use these instructions to correctly copy the jar files.
Follow these steps:
  1. Navigate to the
    <WL_HOME>/lib
    directory.
    WL_HOME
    is the directory where the WebLogic Server is installed.
  2. Copy the
    wlthint3client.jar
    file.
  3. Paste the
    wlthint3client.jar
    file into
    <APMIA_Home>/lib/
    directory.
Defect DE456625 - Config.json File Changes Lost after Installing Node.js Probe
Valid for:
DX APM
SaaS 20.4, NodeJS Probe Version 1.10.83
Symptom:
After you install the latest Probe of the Node.js application, all changes that you have made in the
config.json
file are lost.
Solution:
Before you install the latest Probe of the Node.js application, perform the following tasks.
Follow these steps:
  1. Find the
    config.json
    file by navigating to the following location of the system where you have installed the Node.js application:
    <Node.js_Installation_Folder>\node-modules\ca-apm-probe\
  2. Backup the
    config.json
    file.
  3. Install the latest Node.js Probe by running the following command in the system where you have installed the Node.js application:
    npm i ca-apm-probe
  4. Navigate to the following location of the system where you have installed the Node.js application:
    <Node.js_Installation_Folder>\node-modules\ca-apm-probe\
  5. Enter the new properties from the latest
    config.json
    file into the back-up
    config.json
    file (see
    Step 2)
    .
  6. Start the Node.js application.
Defect DE456154 - Problem Correlating Backends to Frontends for Node.js Application
Valid for:
DX APM
SaaS 20.4, NodeJS Probe Version 1.10.83
Symptom:
When Node.js application frontends asynchronously call more than one backend, the correlation does not work in the Metric View and the map. However, backend to frontend correlation works as expected in transaction traces.
Solution:
There is no workaround for this issue.
Defect DE456144 - Attribute Decoration Configuration Values Not Loaded on Node.js Startup
Valid for:
DX APM
SaaS 20.4, NodeJS Probe Version 1.10.83
Symptom:
When you start the Node.js application, the configuration values in the
config.json
file for Automatic Attribute Decoration from Node.js  do not load in the Node.js Probe.
Solution:
Perform the following tasks to load the Automatic Attribute Decoration configuration values.
Follow these steps:
  1. Confirm that the Infrastructure Agent is installed.
  2. Install
    NodeJS ca-apm-probe
    and start the Node.js application with NodeJS Probe.
  3. Ensure that you configure the Public API key in the Infrastructure Agent 
    introscopeAgent.profile
    file. To configure, in the
    introscopeAgent.profile
    file, update the following property by navigating to the folder location,
    \apmia\core\config\
    :
    attribute.decoration.apm.access.token
  4. Open the
    config.json
    file by navigating to the following location on the system where you have installed the Node.js application and the
    NodeJS ca-apm-probe
    :
    <Node.js_Installation_Folder>\node-modules\ca-apm-probe\
  5. Update the
    config.json
    file.
    Note: Ensure that you edit the
    config.json
    file with some changes (such as inserting a space).
  6. Save the
    config.json
    file.
Defect DE454550 - MongoDB Backend Node Displays as Generic Backend in Map
Valid for:
DX APM
SaaS 20.4, MongoDB 2.x, Node.js
Symptom:
The MongoDB backend node should display as an inferred database with Node.js on the map. However, the MongoDB backend node displays as a generic backend.
Solution:
There is no workaround for this issue.
Defect DE450621 - Python Django Run Command Issue
Valid for:
DX APM
20.4, Python 3.x
Symptom:
The following
run
command does not work in the system where you have installed the Python Django application:
ca-apm-runpy python manage.py runserver
Solution:
Use the following
run
command in the system where you have installed the Python Django application:
ca-apm-runpy gunicorn -w 2 -b :8000 <project-name>.wsgi
Defect DE450599 - Python Django Unknown Agent Displayed in Metric View
Valid for:
DX APM
20.4, Python 3.x
Symptom:
When you start the
DX APM
Infrastructure Agent, an unknown agent displays in the Metric View.
Solution:
There is no workaround for this issue.
Defect DE450618 - Python Django URLs Metrics Display Issue
Valid for:
DX APM
20.4, Python 3.x
Symptom:
When you connect the Python Django application to the Infrastructure Agent and browse the Python Django application. Each URL metric (endpoint) of the Python Django application displays twice in Metric View.
Solution:
There is no workaround for this issue.
Defect DE449130 - Unable to Log In Using SAML Account
Valid For
:
DX APM
20.1, 20.4
Symptom
: The user is not able to log in when using SAML account details.
Solution
: Generate a public token and log in using the token.
Defect DE438579 - Correlation of Host Monitor to IIB Integration Node Does Not Work
Valid for:
DX APM
SaaS 20.4
Symptom:
The correlation of the Host Monitor to the IBM Integration Bus (IIB)
Integration
node does not work when IIB Infrastructure Host Monitoring capability is enabled.
Solution:
There is no workaround for this issue.
Defect DE405769 - Correlation of Mule ESB 3.x to Proxy Does Not Work
Valid for:
DX APM
SaaS 20.4, Mule ESB 3.x
Symptom:
The correlation of the Mule ESB 3.x application to the proxy is used by a nested application. The correlation does not work on the map and in transaction traces.
Solution:
There is no workaround for this issue.