Configuring profiling

This section explains how to configure Instana AutoProfile™.

Java

Supported JVMs

AutoProfile is currently supported on HotSpot and OpenJ9 based JVMs.

Supported HotSpot based distributions with JVM versions 1.8.152 and higher:

  • AdoptOpenJDK HotSpot
  • Amazon Corretto
  • Azul Zulu
  • Eclipse Temurin
  • OpenJDK
  • Oracle HotSpot
  • Sun HotSpot

Supported OpenJ9 based JVMs with versions 0.29.0 and higher:

  • IBM Semeru

At the moment AutoProfile is only supported on x86_64-bit Linux (glibc-based and musl-based OS).

Configuration

To enable profiling, edit the agent configuration file <agent_install_dir>/etc/instana/configuration.yaml:

com.instana.plugin.profiling.java:
  enabled: true

Additional configuration options

Parameter Description
cpu-sampler-enabled When set to true, enables CPU profiles.
contention-sampler-enabled When set to true, enables contention profiles.

Troubleshooting

  • Cannot load JVM TI agent library: /tmp/libprofsensor-X.X.X-linux-x64-28c63c.so: libc.musl-x86_64.so.1: cannot open shared object file: No such file or directory. For JVMs running in Apline images, the profiler expects musl libc to be available. For cases, where glibc is also installed for compatibility reasons, make sure the path to the musl versions of the libraries is not overwritten or broken.

Node.js

To enable AutoProfile™, add autoProfile: true option when initializing the collector (or set the environment variable INSTANA_AUTO_PROFILE=true). This feature requires @instana/collector@1.98.1 or later and at least Node.js 6.4.0.

require('@instana/collector')({
  autoProfile: true
});

See Node.js Collector Configuration for more information.

Go

To enable AutoProfile™ add EnableAutoProfile: true option to instana.InitSensor(opt) (or set the environment variable INSTANA_AUTO_PROFILE=true for github.com/instana/go-sensor@1.13.2 and above). This feature requires Instana sensor to be activated inside the app code. Refer to the AutoProfile™ How-To Guide to learn how this can be done.

See Go Configuration for more information.

Python

To enable AutoProfile™ set the environment variable INSTANA_AUTOPROFILE=true. This feature requires the Instana Python sensor to be activated inside the app code. Please refer to Manual Installation to learn how this can be done.

See Python Configuration for more information.

Ruby

To enable AutoProfile™ add the following to your agent's configuration.yml

com.instana.plugin.rubyprofile:
  enabled: true

.NET Core

For .NET users, AutoProfile™ is available only for .NET Core applications that run on Linux. See Monitoring .NET Core on Linux for more information.

To enable AutoProfile™, add the following settings to your agent's configuration.yml file:

com.instana.plugin.netcore:
  profiling:
    enabled: true

PHP

For PHP users, AutoProfile™ is available only for applications that run on Linux. See Profiling PHP for more information. To enable AutoProfile™, add the following settings to your agent configuration.yaml file:

com.instana.plugin.php:
  profiling:
    enabled: true