Build 259
Build 259 is released on 16 October 2023.
Minimum version to update from directly: Build 255.
- Cumulative release notes #258, #259
- Breaking changes
- Features
- AWS Fargate ECMAScript modules support for Node.js tracer
- AWS SDK v3 SNS instrumentation for Node.js tracer
- Containerd Sensor 1.0.32: Normalized CPU and Memory Working Set utilization metrics
- Envoy Proxy sensor
- Host sensor
- IBM ACE tracing
- IBM MQ sensor
- Instana Microservices Application Monitoring for VMware Tanzu
- Search in the Table widget for Infrastructure and Platforms
- Azure MySQL Database
- Go Tracer SDK support for AWS SDK v2
- IBM MQ Tracing
- Infrastructure payload APIs
- Support for Workers metrics in JBoss sensor
- Improvements
- IBM Db2 LUW sensor
- Keyboard navigation for the custom dashboard
- New permissions to create heap dumps and thread dumps
- Table widget for Infrastructure and Platforms: Enhanced sorting fields
- Allow users to unmask the Change Password field
- IBM i sensor
- IBM MQ sensor
- Linking calls to services that are running behind Kubernetes NodePort
- Session cookie
- Unbounded Analytics
- Fixes
- AutoTrace WebHook 1.257.3: Fixes for NGINX autotracing
- Deployment configs links in the top deployments card point to an incorrect URL
- IBM ACE sensor
- IBM Db2 LUW sensor: Tiles in the Infrastructure dashboard
- Infrastructure and Kubernetes information on IBM ACE service dashboards
- NGINX tracing
- Sorting for groups in the Table widget for Infrastructure and Platforms
- Chart bucket clipped or not visible
- DockerLog sensor
- IBM MQ sensor
- Limited badges and technology icons
- Two-factor authentication tokens
Cumulative release notes #258, #259
Notes: From release 257, a part of data that is written to Cassandra is written to ClickHouse. This change leads to a higher storage size requirement for the disk traces
. The storage requirement depends on the workloads
of your Instana deployment.
After you upgrade your Instana backend to 257, monitor the disk traces
, and adjust its size if necessary.
Breaking changes
Deprecated Legacy Python AutoTrace is disabled by default
After the release of Instana - Python - Discovery version 1.9.12, the deprecated Python autotracing feature is not enabled by default. If you still use this deprecated feature, prepare for its removal. For more information about the options, see Deprecated: Legacy Python AutoTrace.
IBM Db2 LUW sensor: Infrastructure dashboard
The number of rows that are displayed in the following tiles is limited:
- Table Space Utilities: Up to 200 rows based on the table size
- Table Sizes (per schema): Up to 50 rows based on the table size
- Tables Catalog View (per schema): Up to 50 rows based on Stats Time
- Index Catalog View (per schema): Up to 50 rows based on Stats Time
Features
AWS Fargate ECMAScript modules support for Node.js tracer
The ECMAScript modules support is added for AWS Fargate for Node.js tracer. For more information, see ECMAScript modules.
AWS SDK v3 SNS instrumentation for Node.js tracer
Node.js tracer now supports instrumentation for SNS in AWS SDK v3.
Containerd Sensor 1.0.32: Normalized CPU and Memory Working Set utilization metrics
The Containerd sensor now supports Normalized CPU utilization and Memory Working Set utilization metrics.
Envoy Proxy sensor
Envoy Proxy sensor 1.1.0 now supports YAML configuration parsing and containerized environments.
The YAML configuration parsing drops the requirement to set the --admin-address-path
command-line argument. Also, log messages are improved, and several bugs are fixed, such as displaying absolute configuration paths properly
in the Instana UI.
Host sensor
The host sensor now supports the collection of disk I/O utilization on Red Hat Linux 7.9 or later.
IBM ACE tracing
For ACE 12.0.7 or later, you can enable the ACE tracing automatically through Instana AutoTrace WebHook in the IBM Cloud Pak for Integration environment. For more information, see Enabling tracing in the IBM Cloud Pak for Integration environment.
IBM MQ sensor
Instana now supports monitoring of multi-instance Queue Managers on distributed platforms. For more information, see Multi-instance Queue Managers support.
Instana Microservices Application Monitoring for VMware Tanzu
Instana Microservices Application Monitoring for VMware Tanzu 1.258.0 is released. For more information, see Instana Microservices application monitoring for VMware Tanzu.
Search in the Table widget for Infrastructure and Platforms
The Table widget for Infrastructure and Platforms now supports searching in the table.
Azure MySQL Database
Instana now automatically discovers and monitors Azure MySQL Database. For more information, see Monitoring Azure MySQL Database.
Go Tracer SDK support for AWS SDK v2
Go Tracer SDK now supports the instrumentation of the aws-sdk-go-v2 package. For more information, see instaawsv2.
IBM MQ Tracing
You can now specify a local source address for outgoing traffic from the IBM MQ Tracing user exit. For more information about the configuration parameter LOCAL_SOURCE_ADDRESS
, see Configuring IBM MQ Tracing for on-premises IBM MQ.
Infrastructure payload APIs
New infrastructure endpoints are available that enable the retrieval of the following resource payloads:
GET /api/infrastructure-monitoring/catalog/payloads/{pluginId}
retrieves payload keys for a specific plug-in. Currently, this API retrieves only keys for the IBM Db2 Database plug-in (db2Database
). For more information, see the infrastructure catalog APIs in the OpenAPI documentation.GET /api/infrastructure-monitoring/payloads/{snapshotId}/{payloadKey}
retrieves the payload for a specific snapshot and payload key. For more information, see the infrastructure resources APIs in the OpenAPI documentation.
Support for Workers metrics in JBoss sensor
JBoss sensor now retrieves Workers
metrics, such as BusyWorkerThreadCount
, WorkerQueueSize
, and ConnectionCounts
for JBoss EAP 7.0.9 or later.
Improvements
IBM Db2 LUW sensor
The Recent Backup Details tile is added on the Infrastructure dashboard for IBM Db2. The tile displays 10 full offline backups of IBM Db2.
New permissions to create heap dumps and thread dumps
The new permissions Create heap dump and Create thread dump are introduced in Instana.
These permissions are now required to trigger the creation of heap dumps and thread dumps, which are available on the Infrastructure dashboard of JVMs. Members of the Owner group automatically have these permissions and can grant these permissions to other groups.
Table widget for Infrastructure and Platforms: Enhanced sorting fields
The Default Sort field in the Table widget for Infrastructure & Platforms data source is renamed to Sort By. The Sort Direction field is also added to the Table widget. You can configure this field to set the default sorting direction for infrastructure metrics in the table. For more information, see Creating a Table widget.
Allow users to unmask the Change Password field
A new feature is added to unmask the Change Password field to make sure that the password is entered correctly.
IBM i sensor
Some metrics from Hardware Disk Drives (HDD), history logs, and overall disk status are updated so that users can view all the metrics in the Instana UI. Previously, users couldn't view all the metrics in the UI for the 3,000 metrics count limit. The default poll rates for the following tables are updated:
- Total Spool Space
- Solid State Disk (SSD) Info
- Network connections (Top Receivers)
- Network connections (Top Sender)
- Netstat Interfaces
- Non Volatile Memory Express(NVMe) Information
- Hardware Disk Drives (HDD) Info
For more information, see Monitoring IBM i instances.
IBM MQ sensor
The support_ha
field is added to the agent configuration file to indicate whether the IBM MQ HA Queue Managers are monitored as a whole or not. For more information, see Configuring IBM MQ monitoring.
Linking calls to services that are running behind Kubernetes NodePort
Instana now supports linking calls to services that are running behind Kubernetes NodePort. By linking calls to services, you can find which infrastructure entities the calls are going to.
Unbounded Analytics
OpenTelemetry static tags, OpenTelemetry Tag and OpenTelemetry Resource Tag, are added as an alternative to the existing OpenTelemetry dynamic tags. While the existing dynamic tags are limited to 500 attributes, the static tags do not have this limit.
For more information, see Analyzing OpenTelemetry calls.
Fixes
AutoTrace WebHook 1.257.3: Fixes for NGINX autotracing
In the context of Instana AutoTrace WebHook, the issue with the extraction of the NGINX version is fixed now with the support of whitespace. The security issue CVE-2022-28948
is fixed now. These fixes are available in AutoTrace
WebHook 1.257.3 and later.
Deployment configs links in the top deployments card point to an incorrect URL
In the Deployment configs tab of the Top Deployments card on the Kubernetes cluster view page, if you select an item, you are redirected to an incorrect URL. This issue is fixed. Now, when you select a deployment config item, you are redirected to the correct URL.
IBM ACE sensor
Previously, the IBM ACE sensor depended on the jaxb-api-2.3.0.jar
package. Now the dependency is removed.
IBM Db2 LUW sensor: Tiles in the Infrastructure dashboard
The Table Sizes, Tables Catalog, and Index Catalog tiles in the Infrastructure dashboards were not visible for local monitoring. This issue is fixed.
Infrastructure and Kubernetes information on IBM ACE service dashboards
Previously, when you clicked Stack on IBM ACE service dashboards, only the IBM ACE Message Flow entity was displayed. Now, the infrastructure and Kubernetes entities that are related to the IBM ACE service are also displayed.
NGINX tracing
The issue with the extraction of the NGINX version is fixed now with the support of whitespace.
The security issue CVE-2022-28948
is fixed now.
Sorting for groups in the Table widget for Infrastructure and Platforms
Previously, only metrics and the entity name were added to the sorting options in the Table widget for Infrastructure and Platforms. Now, groups are added to the sorting options. When you group on tags, you can sort by using these tags.
Chart bucket clipped or not visible
For certain time frames, the first bar in bar charts were clipped or not visible. This issue is now fixed.
DockerLog sensor
The resource management of the DockerLog sensor is improved to prevent abrupt sensor restarts in certain situations.
IBM MQ sensor
Previously, the agent.log
file contained a warning message, such as "Sensor com.instana.plugin.ibmmq:QmgrName-IP took 4450 ms". Now, the message is not included in the agent.log
file.
Limited badges and technology icons
Previously in release 257, the number of items in the Types and the Technologies columns were limited to 3 on the top-level Services list of the Applications page, with the remainder visible in a tooltip. In release 259, the same change is introduced in the Services list of each individual Application on the Application Perspective dashboard. The types list in flow map nodes is also limited to 1, with the remainder visible in a tooltip.
Two-factor authentication tokens
Two-factor authentication (2FA) tokens with a leading zero could not be entered in the Instana UI. This issue is now fixed.