Build 251

Build 251 is released on 27 June 2023.

Minimum version to update from directly: Build 247.

Cumulative release notes #250, #251


Aarch64 support for PHP 8.0 and PHP 8.1

Beginning from Instana PHP extension 1.19.0 (included in PHP sensor 1.1.78), the Aarch64 support for PHP 8.0 and 8.1 is added.

Application monitoring

With Application Smart Alerts, you can get alerts on the number of erroneous calls now (in addition to error rate).

Containerd log collection

You can configure the Containerd sensor to collect supported container logs now. For more information, see Monitoring Containerd.

You can monitor the collected logs by clicking Analytics > Logs in the Instana UI.

Custom payloads in Synthetic Smart Alerts

You can configure Synthetic Smart Alerts with custom payloads. For more information, see Synthetic custom payload.

Db2LUW sensor: Use Dynamic Focus Query for Db2 database names

Now, you can search and set events for a Db2 instance with a specific database by using Dynamic Focus Query.

To search for a Db2 instance with a specific database name, access the Infrastructure page, and use the query<database name>.

To set events only for selected entites by using Dynamic Focus Query, follow the steps:

  1. Set the Event Details and Condition sections as needed.
  2. In the scope section, set the Apply on option to Selected Entites Only(Dynamic Focus Query).
  3. Set Dynamic Focus Query to<database name>.

Dynamic parameters for automation actions

Dynamic parameters are added for automation actions derived from the monitored infrastructure related to the issue based on a tag. Dynamic parameters are automatically detected, and they continuously update the relations of the monitored system by using Instana's unique Dynamic Graph.

IBM ACE Tracing

The IBM ACE Tracing user exit image is now available in the Instana public artifactory for you to download. For more information, see Downloading IBM ACE Tracing user exit.

IBM DataPower sensor

Instana supports monitoring XML names of DataPower. The table XML Names is added to the Instana UI.

IBM DataPower Tracing

You can change the log level of the Instana DataPower Tracing agent to get more information while troubleshooting. For more information, see Monitoring IBM API Connect application.

IBM MQ Managed File Transfer (MFT) monitoring

Instana now provides metrics for the count of transfers that are retrying, timedout, or waiting for agent capacity. For more information, see IBM MQ Managed File Transfer monitoring.

IBM MQ Tracing

The IBM MQ Tracing user exit image is now available in the Instana public artifactory for you to download. For more information, see Downloading IBM MQ Tracing user exit.


Instana now provides support for instrumenting the GORM library in the Go ecosystem. For more information, see Databases.

Kong API Gateway

The Kong latency graph is now available for the 50th, 90th, 95th, and 99th percentiles. For more information, see Monitoring Kong API Gateway.

Mobile App monitoring

Flutter agent 2.6.0 is released with the following two features:

  • Capturing HTTP calls that are issued inside iOS platforms (in Swift or Objective C) and Android platforms (in Kotlin or Java). For more information about enabling native HTTP capture, see How to enable native HTTP capture.

  • Capturing HTTP calls that are issued within Dart. For more information about enabling HTTP auto capture within Dart, see How to enable HTTP auto capture within Dart.

Oracle RAC

Instana supports monitoring of Oracle Real Application Clusters (RAC) as Open Beta. For more information about Oracle RAC, see Oracle RAC.

OpenTelemetry integration for Node.js tracer

Instana now supports Node.js libraries, such as,, restify, and fs through the OpenTelemetry integration.

Polling configuration for Db2 LUW metrics

A polling configuration for IBM Db2 LUW sensor is enabled. With this feature, you can set a custom configuration for fetching stats at required intervals and also disable irrelevant stats.

SpringBoot v3 metrics collection

Spring Boot sensor can collect metrics from Sprin Boot v3 applications now. For more information, see Monitoring Spring Boot.


Action associations for application Smart Alerts

Support is provided to associate actions to application Smart Alerts. These associations can be established either from the action definition page or from the Smart Alert definition page. For more information, see Action Assocaitions.

Container log filter

By clicking Analytics > Logs in the Instana UI, you can use the "Container Snapshot Id" filter, which applies to both Docker and Containerd log messages, instead of using either a "Docker snapshot Id" filter or a "Containerd snapshot Id" filter.

Custom events

Now, when you use multiple metric conditions in a custom event, you can combine these metric conditions with the OR logical operator, in addition to the AND logical operator. For more information, see Custom events.

IBM i sensor

Instana supports monitoring metrics and configuration data for IBM i platform 7.5.


In the Logs home page, the query time of filtering and grouping logs is faster now. To go to the Logs home page, click Analytics > Logs in the Instana UI.

Trace details

The "Download call details" link is added to the header of call details.

Tuxedo sensor

Previously, Tuxedo sensors without an explicitly defined availability zone were categorized as "Undefined Zone" by default. Now, the default zone is set to Tuxedo Domains if the availabilityZone property is not specified in the configuration file <agent_install_dir>/etc/instana/configuration.yaml.

Website monitoring

The following open APIs for JavaScript source map uploading are updated to be compliant with the OpenAPI specification:


Application Metrics API

Previously, some snapshot IDs that were returned by the API endpoint /api/application-monitoring/metrics/services did not match the filter specified in the request. The issue is fixed now.

IBM ACE sensor

Previously, the flow nodes metrics were lost in flow nodes table for container-based IBM App Connect Enterprise (ACE) environments. The issue is fixed now.

Previously, the queue manager connection status wasn't updated accordingly after queue manager was disconnected or reconnected. The issue is fixed now.

IBM ACE Tracing

The HTTP request header X-INSTANA-T and the IBM MQ message header X_INSTANA_T, which contain the Instana trace ID, are changed to 16 characters in length.

IBM i sensor

The issue that inactive subsystems were reported as active in the IBM i remote monitoring is fixed.

IBM MQ Tracing

A user exit error that is caused by the log utility of IBM MQ Tracing is fixed.

Trace details

Previously, website and mobile beacons weren't displayed in the Details panel of the Trace view on the Analytics dashboard. This issue is fixed now.

Screenshot showing the details side-panel missing web beacons Screenshot showing the details side-panel with web beacons

Minor releases


  • Fixed a mismatch in the expected response status code when API calls are made to Groundskeeper to replace download keys.
  • Fixed an issue in reading service credentials for authentication to Groundskeeper during Unit deletion.


Unbounded Analytics

Fixed an issue of calls analytics when calls are grouped by log messages and filtered by HTTP headers at the same time.


Previously, it was not possible to reactivate a tenant unit after it was deleted. The issue is solved now.