Build 259

Build 259 is released on 16 October 2023.

Minimum version to update from directly: Build 255.

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.

Keyboard navigation for the custom dashboard

In the search box of the custom dashboard, you can use the keyboard for navigation from the search list.

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.

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.