20.1

These are the new, changed, and deprecated features in
DX APM
20.1.
Agent Features
Nginx Web Server Plugin
Business Payload Analyzer now includes a plugin for the Nginx web server. For more information about Installation and Configuration, see the Install and Configure Nginx Web Server Plugin section.
You can now deploy all the Universal Monitoring Agent for Kubernetes functionality using a Kubernetes service operator.
Use Kubernetes Service Operator to Deploy Universal Monitoring Agent for Kubernetes
You can now deploy all the Universal Monitoring Agent for Kubernetes functionality using a Kubernetes service operator.
OpenTracing Support
DX APM
now offers monitoring support for OpenTracing applications. OpenTracing support reports application performance metrics and transaction traces collected from applications that you instrument with Jaeger.
DX APM
provides OpenTracing support as an Infrastructure Agent extension. For more information, see OpenTracing Support.
Install Infrastructure Agent on AIX
You can now download and install the Infrastructure Agent on the AIX platform. For more information, see Install Infrastructure Agent on DX APM.
Python 3.x Support
The Python Agent now supports Python 3.x and supports both incoming and outgoing correlation. The correlation support enables you to view the correlation of streams incoming into the Python application with outgoing streams from the Python application.
Correlation Supported
  • Incoming Correlation:
    If there is any call from the incoming stream (Java or Python) to the Python application, the respective agents instrument both the streams.
  • Outgoing Correlation:
    If there is any call from the Python application to the downstream (Java or Python), the respective agents instrument both the streams.
Outgoing Correlation Using Request Module
The
Requests
module is the standard for making HTTP requests in Python. If any Python application invokes the request module in the Python probe, the probe is notified and the corresponding traces are displayed.
Outgoing Correlation Using Urllib Module
Urllib.request is the module for fetching URLs (Uniform Resource Locators) in Python. The urllib.request module defines functions and classes which help in opening URLs (mostly HTTP) in Python. If any Python application invokes this module in the Python probe, the probe is notified and the corresponding traces are displayed.
Python Application Support in Docker Containers
You can now use the Python Agent to monitor Django Framework and Flask Framework Python applications.
AWS CloudTrail Service
The 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.
IIB Infra Monitoring
You can use IBM Integration Bus Monitoring (IIB) Monitoring to monitor the health and availability of IIB and the corresponding message flows. As a prerequisite, you need to use one of the following components: MQTT, which is built into IIB or IBM MQ. The IIB Monitoring extension connects with one of the components to collect the IIB statistics metrics. For more information, see IIB Monitoring.
SQL Server Database Monitoring
SQL Server Database Monitoring enables you to monitor the performance and the availability of your SQL server database environment. You can configure and use this extension to collect the performance metrics of your SQL Server that are related to the Connections, Buffer Manager, Index Statistics, and more. For more information, see SQL Server Database Monitoring.
MySQL Database Monitoring
The MySQL Database Monitoring extension enables you to monitor the performance and the availability of your MySQL database environment. This extension provides real-time visibility into critical database resources such as bytes that are sent and received, connections that are attempted, aborted, or failed, Innodb insights, database operations, resource utilization, and more. For more information, see MySQL Database Monitoring.
Transaction Tracing Support for Oracle Database, Oracle RAC, and Oracle EBS
DX APM
supports the event-driven collection of database traces for the following database extensions: Oracle Database, Oracle Real Application Clusters (RAC), and Oracle E-Business Suite (EBS).
The database extensions provides database traces based on the specific database service. Database traces provide the details of the performance indicators. The traces also show details and statistics of the fetch, wait, SQL parse, and resource utilization while the respective database executes the database transactions for a particular business transaction.
Koa.js Framework Support for Node.js
The Node.js Agent supports Koa.js, which is the next-generation Node.js web framework.
NGINX Monitoring Support
The NGINX Monitoring agent extension enables you to monitor the NGINX Hosted Services Version. You can use this extension along with the other existing extensions, to monitor both the NGINX Infrastructure monitoring and the performance of services that are hosted on the NGINX Hosted Services Version. For more information, see NGINX Monitoring.
Enhanced Support for .NET Core Applications
DX APM
now supports monitoring of asynchronous .NET Core transactions.
Kafka Monitoring Lag and Consumer Offset Metrics
Kafka Monitoring now reports the performance of Kafka Consumer Groups Offsets. Kafka Monitoring uses the
Lag
and
Current Offset
metrics for each consumer group when the Kafka application experiences slow performance. These metrics can help you determine whether slow Kafka performance is due to consumers not reading messages fast enough, resulting in messages waiting to be read.
Enhanced Java 11 Support
The Java Agent now monitors Java 11 applications without needing to pass any additional command line arguments to the -javaagent command.
Log Correlation Monitoring Enhancements
Log Correlation Monitoring now supports support log4j2. You can now define the param com.ca.apm.log.correlation.mdc.insert.before pattern with %m%n and %msg at the same time. You can also define multiple patterns for param com.ca.apm.log.correlation.mdc.insert.before.
Support for Akka and Play Applications
DX APM
includes a Java Agent extension that reports the performance Akka and the Play framework. This extension reports frontend, backend, correlation, play controller, and Akka performance metrics.
Prometheus Monitoring
The Infrastructure Agent now includes Prometheus Monitoring, which allows
DX APM
to remotely ingest Prometheus metrics. You can configure configuration file properties to ingest metrics directly from a Prometheus backend. For example, you can configure metric type, metric query, and so on. You can also configure Prometheus Monitoring to ingest metrics from a Prometheus exporter.
Remote JMX Monitoring
The Infrastructure Agent includes a new Remote JMX Monitoring extension. This extension allows you to remotely monitor the performance of Java applications over JMX without requiring any direct application instrumentation. The JMX performance metrics are correlated with other performance metrics such as Infrastructure and Application performance. For more information, see Remote JMX Monitoring.
Couchbase Monitoring
The Infrastructure Agent includes a new Couchbase Monitoring extension. This extension allows you to monitor Couchbase performance, including monitoring a cluster. For more information, see Couchbase Monitoring.
Java Agent Monitoring Modes
The Java Agent has a new monitoring mode that you can set to
None
. None mode is the minimal mode for the agent, shutting off most of the functionality and the metrics. You can change the mode at run time without requiring an application server restart.
Enhanced Visibility into .NET Application performance
The NET Agent now automatically collects stack traces. The stack traces contain the entire .NET application method call stack. The stack traces display as snapshots in transaction traces.
PHP Application Support in Docker Container
The PHP Agent now supports PHP CLI monitoring. You can use the PHP Agent to monitor PHP scripts that are executed from another PHP script.
Node.js Application Support in Docker Containers
The Node.js Agent enables you to monitor your Node.js application, along with the databases that connect to your Node.js application. For example, the PostgreSQL, MongoDB, and MySQL databases.
UI Features
API for Agent Download Available from APM Command Center
You can now use
the APM Command Center API to download the latest packages from APM Command Center and customize the behavior of the download by defining the required properties. For example, during the download you can customize the payload and define certain properties as hidden. For more information, see APM Command Center API.
Java Agent for Microservices in APM Command Center
You can now create and download the Java Agent for Microservices from APM Command Center. For more information, see Deploy Agent Packages Using APM Command Center.
Filter Metric View Using Attributes
In Metric View you can now define filters for agents based on their attributes.
Calculators Enhancement
You can now create calculators that take the values from a metric grouping as input, and average or sum the values. The calculators output the resulting value as a custom metric in the metrics browser. Calculator-generated metrics appear under a virtual process, named the
Custom Metric Process
. The custom metric process runs on a virtual host that is named
Custom Metric Host
. For more information, see Create and Edit Calculators.
Execute Queries Using REST API
You can now use the the following REST APIs to query for metrics and related data:
  • Metric Query REST API
Metric Query API queries the metrics for different time ranges, frequencies, and metrics. Like other APM REST APIs, the Metric Query REST API interface uses token-based authentication. For more information, see Metric Query REST API.
  • Team Center REST API
The Team Center REST API provides various dashboard-level and metric data-query functionalities. Like other
DX APM
REST APIs, the Team Center REST API interface uses token-based authentication. For more information, see Team Center REST API.
Import and Export Agent Package Definitions from APM Command Center
You can now import and export agent package definitions from one tenant to another. For more information, see Deploy Agent Packages Using APM Command Center.
Deprecated Support and Features
DX APM
no longer supports the following features and functionality:
  • Command Line Workstation
  • Python 2.7
  • ChangeDetector
  • Dynamic Instrumentation
  • The Java Agent
    -DagentProfile
    system property is no longer supported.
Known Issues
Defect DE449471 - Infrastructure Agent Isolation View URL Does Not Open
Valid For:
DX APM
20.1
Symptom:
The
Isolation
view does not generate for the Infrastructure Agent. This situation occurs when you navigate from
Dashboards
,
Agent
,
Add Filter
, select the Infrastructure Agent host name from the drop down, and then select
Application Layer
.
Solution:
Based on the alert definition, manually define the correct filter in map.
Defect DE449130 - Unable to Log In Using SAML Account
Valid For
:
DX APM
20.1
Symptom
: The user is not able to log in when using SAML account details.
Solution
: Generate a public token and logi n using the token.
Defect DE440008 - Selecting a Trace Resets Transaction Trace Pane to Top
Valid For
:
DX APM
20.1
Symptom
: This issue happens when there are many traces in the Transaction Trace Viewer Transaction Traces pane. After scrolling down the pane and selecting a trace, the Transaction Traces pane resets to the top.
Solution
: Scroll down the Transaction Traces pane and and look for the trace with a border.
Defect DE450933 - OpenShift Monitoring Error
Symptom:
I want to download OpenShift Monitoring from the APM SaaS APM Download Dialog. I click on
Openshift
under the
Cloud Native category.
When I follow the instructions and run the
oc create -f caagent-openshiftmonitor.yml
command, I get an error.
How can I solve the problem?
Solution:
In the
caagent-openshiftmonitor.yml
file, remove
- name: dev & readOnly: true
property. Run this command:
oc create -f caagent-openshiftmonitor.yml
Defect DE432585 -
IBM Integration Bus Monitoring Resource Statistics Metric Values Display as Cumulative
Symptom:
IBM Integration Bus Monitoring (IIB Monitoring) metric values for Resource Statistics display as
Cumulative
instead of
per Interva
l.
Solution:
There is no workaround for this issue.
Defect DE448777 - IBM Integration Bus Monitoring Message Flow and Resource Statistics Not Reported
Symptom:
When you restart the subscribed QM, the IBM Integration Bus (IIB) Message Flow & Resource Statistics are not reported in
DX APM
.
Solution:
Restart the
DX APM
Infrastructure Agent.
Defect DE448618 - Jenkins Plugin Fails in
DX SaaS
Environment
Symptom:
The Jenkins plugin,
em.url
does not work in
DX SaaS
after you upgrade
DX APM
.
Solution: When you upgrade the
DX SaaS
environment, update the EM URL value in the
performance-comparator.properties
file.
Follow these steps:
  1. Log in to
    DX SaaS
    .
  2. Click
    Open
    on the
    DX APM
    box. The
    DX APM
    home page appears. The home page displays the URL used to access
    DX APM
    in the web browser.
  3. Navigate to
    <Jenkins Workspace>\<jenkins-job name>\properties\.
  4. Open the
    performance-comparator.properties
    file.
  5. Update the value of the
    em.url
    property with the latest EM URL.