Build 173


On-Premises Release Notes

New Repository

With this release we introduce a new repository for our instana-console binary. The advantage of the new repository is that its versioned:

Every instana-console binary version is tight to a specific container build, instana-console is tagged in the following way -. The major version indicates the instana build that we release within the regular cycles e.g 173. The minor version is iteratively increased as we ship smaller fixes to the instana-console tool or the backend.

You can find details e.g. how to change your existing configuration in the docs.

Safe update path

Build 173 is the first build that does not support the migration from the package-based installation.

With the new versioned repository, it's still safely possible to get the migration done with a few steps.

  1. Install the latest instana-console version 170
  2. Run instana containerize
  3. Check that you have safely migrated (log-in, check for data)
  4. Install the latest instana-console version 173
  5. Run instana update

Regular update cadence

With this release we catched up on our SaaS releases. We plan to release further releases with uneven release numbers on-premises one week after the SaaS release and skip even releases. Resulting in a monthly update cadence.

Depending on the changes we are making with our backend, we might skip-releases or change the cadence slightly. But we will work hard to keep you uptodate.

Cumulative Features from Release #171, #172, #173


Instana Smart Alerts

Instana Smart Alerts is a new intelligent alerting capability that allows you to receive alerts automatically tailored for an arbitrary subset of the web site traffic. The alerts are derived from out-of-the-box alert blueprints such as website slowness, JavaScript errors, and HTTP status codes. For detailed information, see our Instana Smart Alerts docs.

Instana AutoProfile™ for JVM (open Beta)

Instana AutoProfile™ is a new continuous production profiling capability that allows you to capture profiles from your running JVM automatically. The collected profiles can be used to identify hot spot methods, problems with locked threads. For detailed information, see our Instana AutoProfile™ docs.

Cloud Foundry

  • Added Instana service to PCF Application mapping.
  • Added a health event which triggers if the required number of PCF Application instances changes more then three times in the past five minutes.


  • Instana now supports monitoring of Kafka clients (consumers/producers) which are part of Java applications. For detailed information, see our Kafka docs.
  • Added aggregated values for topic metrics on the cluster level.

Nvidia GPU Monitoring

Instana now supports monitoring of various Nvidia Tesla, Quadro, and GeForce graphics cards. For detailed information, see our Host docs.

Humio logging integration

Configure your Humio dashboards and navigate to Instana entities directly from your logs. See more information, see our Humio docs.

Cloud Foundry

  • Support for Pivotal Isolation Segments.
  • The instance identifier is now available for Cloud Foundry application instances. The instance identifier is displayed on the Cloud Foundry application dashboard, the Garden container dashboard sidebar, and the container infrastructure view.

ELK Logging Integration

Configure your ELK Instance and see a direct link to your logs from views in Instana. For configuration details, see our ELK docs.


A list of Red Hat/CentOS packages installed on host can now be extracted once a day. For more information, see our Host docs.

Custom Service Rule

A custom service rule could be used only to override the default service rules. Now with the introduction of the service.default_name tag, a custom service rule can also be used to extend service default rules with additional tags.

For example, to separate your production and test services based on the host zone, create the custom service rule using the service.default_name and tags.

Landing Page

Instana now comes with a new landing page, which helps the user focus on key entities in various areas. The new landing page comes with four five tiles which can be reordered depending on which areas are more important.

  • Applications: Shows the top 5 applications ordered by calls
  • Websites: Shows the top 5 websites ordered by page views.
  • Infrastructure: Based on the selected type, the infrastructure tile will show the top 5 hosts, containers or processes, ordered by CPU usage.
  • Platforms: This list collects entities from various platforms like Kubernetes clusters, Cloud Foundry applications and vSphere data centers.
  • Events: Shows incidents and issues that occurred in the configured time.

Landing page

Context Guide

Instana introduces the Context Guide, a visual representation of Application Perspective services and related underlying infrastructure driven by the powerful Dynamic Graph.

Context Guide Stack

Context Guide Upstream Downstream

Website Monitoring: Custom Events

Our custom event system for website monitoring is now generally available after being in beta for several releases. Custom events enable reporting about non-standard activities, important interactions and custom timings to Instana. This can be especially helpful when analyzing uncaught errors (breadcrumbs), reporting information about WebSocket connections, and tracking additional performance metrics.

Custom event list

Website Monitoring: User-Timing Collection

Complementary to our custom event system, we now automatically collect markers and measures made via the user timing API. Markers and measures are automatically translated into custom events. This means that the user timing API can be used as a vendor-neutral way to report custom events to Instana.

User timing in the page load view

Website Monitoring: User Impact Based on Session Information

Instana has supported statistics on user impact, e.g. users impacted by a JavaScript error, since the release of our reworked website monitoring. To calculate user impact, we have so far relied solely on data provided via the user API. Unfortunately, it is not always possible to provide user identifying information. We are therefore enhancing our user impact calculation in this release.

To determine user impact, we now use the user ID provided via the user API (preferred) or the session ID provided by opting into our session tracking. This opens up user impact insights for a much wider audience, e.g. websites that work without sign-ins and without server-side sessions.

Affected users in the error details


Instana now integrates with DB2, so you can monitor performance of your DB2 instances alongside related applications, and the infrastructure that runs it all. This includes a built-in dashboard that displays key metrics about your instances’ availability, connections, query rates, and more. For more information, see the DB2 docs.


  • Kubernetes 1.16 support.
  • Fixed uncaught errors in the Kubernetes service dashboard on the infrastructure map.
  • Fixed back button interaction in several paginated views.
  • Fixed parsing traces with unexpected parent-child relations and showing a warning in the trace detail view when this appears.
  • Fixed CRI-O container naming by including the namespace and pod name when running in container-orchestration system.

Applications and services dashboards

  • Now referring to erroneous calls as "Erroneous Calls" rather than "Errors".
  • Added "Erroneous Calls" metric to show the number of erroneous calls. Previously, erroneous calls were shown as "Erroneous Call Rate".
  • Added vSphere tags for Datacenter, Host, VM name, and VM state.
  • Added tags for GPU model and the number of GPUs running in the Host.


  • Trace Sensor 1.1.18: fixed JSON detection when also using ext/memcached.
  • Trace Sensor 1.1.19: fixed bug that prevented connections to Apache.
  • Tracer 1.6: more fine-grained error detection on ext/memcached spans.
  • Tracer 1.6: instrument delete and flush operations in ext/memcached.
  • Tracer 1.6: capture connection details from .ini in ext/mysqli.
  • Tracer 1.6: support getting a connection from Predis Cluster.
  • UI: PHP spans now renders script names and arguments.

Website Monitoring

  • Fixed overly aggressive time skew adjustments.
  • Added the ability to filter for time skews.
  • Added health information to the websites overview.
  • Fixed cases in which the page load visualization showed overlapping events.
  • Smart Alerts:

    • Fixed that previous baseline/threshold has been still shown for a short period when setting up an alert.
    • Fixed that the UI offered options to create, delete, or edit an alert even though the user lacked the respective permission.
    • Aligned the behavior of the JS errors count alerting to the related chart. Now it counts every error and not the number of erroneous page-loads.


  • Fixed missing root call in traces started from XHR requests.